4.6 KiB
4.6 KiB
管理后台 PC 视觉回归基线
1. 适用范围
本基线只覆盖管理后台 PC 端,不扩展移动端设计。验证必须使用已登录管理员会话,不保存配置、不执行停用、删除、调账、生成、恢复任务或外部连接验证等写操作。
固定覆盖两组 CSS 视口:
- 亮色:
1600 × 1000,用于检查宽屏主内容是否铺满、卡片和表格是否出现异常右侧空白。 - 暗色:
1278 × 900,用于检查较窄 PC 下侧栏、操作栏、表格滚动和亮暗层级。 - 断点补充:涉及设置页操作栏时,在
1098px宽度确认纵向回退没有挤压或横向溢出。
浏览器缩放不等于 CSS 视口。验收记录必须以页面的 window.innerWidth / window.innerHeight 为准,不能只记录浏览器窗口外框尺寸。
2. 固定入口
| 分组 | 路由 | 页面标题 |
|---|---|---|
| 概览 | /admin |
数据概览 |
| 平台资源 | /admin/users |
用户管理 |
| 平台资源 | /admin/channels |
系统渠道 |
| 平台资源 | /admin/plugins |
插件管理 |
| 平台资源 | /admin/prompt-templates |
提示词模板 |
| 运营 | /admin/announcements |
系统公告 |
| 运营 | /admin/credit-operations |
积分运营 |
| 运营 | /admin/redemption-codes |
兑换码 |
| 运营 | /admin/logs |
请求明细 |
| 系统配置 | /admin/settings/features |
功能开放 |
| 系统配置 | /admin/settings/drawing-engine |
绘图工具 |
| 系统配置 | /admin/settings/runtime-policy |
资源与策略 |
| 系统配置 | /admin/settings/access |
登录与注册 |
| 系统配置 | /admin/settings/email |
邮件服务 |
| 系统配置 | /admin/settings/storage |
存储服务 |
| 系统配置 | /admin/settings/ark-private-assets |
方舟素材库 |
| 系统配置 | /admin/settings/response-interception |
模型响应拦截 |
| 系统配置 | /admin/settings/third-party |
第三方参数配置 |
3. 每页通过条件
每个入口必须同时满足:
- 页面
h1与表中标题一致,没有落入 404、登录页或持续加载态。 document.documentElement.scrollWidth - clientWidth的绝对值不大于1px;宽表只能在自身滚动容器内滚动。.admin-page-frame右边界与 CSS 视口右边界差值不大于1px,主内容背景不能在右侧提前结束或形成大块空白。- 页头、同步操作栏、概览区、业务卡片、表格、分页和页面底部安全间距层级清楚;亮暗主题下文字、边框、选中态和禁用态可辨认。
- 展开侧栏分组归属明确;收起态只显示图标,当前项仍可辨认,悬浮提示按文案自适应且保持强对比。
- 控制台没有来自应用页面的 warning 或 error。浏览器扩展日志、Vite 连接信息和 React 开发提示不计为应用错误。
- 不通过修改浏览器缩放、隐藏侧栏或关闭数据列来掩盖布局问题;表格自身的横向滚动属于保留行为。
4. 交互抽查
全入口结构巡检后,至少抽查以下交互:
- 右上角主题切换:动画中段不闪白、不出现旧主题表面,结束后按钮语义与主题一致。
- 侧栏展开/收起:主内容立即重排且无空白,边界按钮不被分隔线穿透;暗色提示文字清楚。
- 列表页:搜索、筛选、重置、列设置、行操作和底部分页对齐;只有一个操作时不收进“更多”。
- 设置页:待保存状态、撤销、刷新、核对和最终保存层级一致;有草稿时刷新和后台导航保护有效。
- 抽屉与弹窗:宽度符合业务内容,标题、滚动正文和固定底栏分层;Tab 焦点不逃出浮层,关闭后回到触发入口。
5. 当前基线
2026-08-28 完成首次固定基线:18 个入口在亮色 1600 × 1000 与暗色 1278 × 900 下标题全部匹配,文档级横向溢出全部为 0;亮色主内容宽度为 1376px、暗色较窄 PC 主内容宽度约 1054.4px,页面框架均延伸到视口右边界。写操作均未触发。
真实账号、业务数据和密钥不得作为截图基线提交到项目。需要截图比对时使用脱敏测试数据并保存在受控测试产物目录,不写入本变更记录。