54 行
2.6 KiB
Markdown
54 行
2.6 KiB
Markdown
# ImageStudio 全页面 UI 统一性检查
|
||
|
||
日期:2026-07-21
|
||
分支:`codex/ui-redesign-gallery`
|
||
|
||
## 覆盖范围
|
||
|
||
- 工作台壳层、导航 rail、topbar、主题和全局状态。
|
||
- Overview、Generate、Queue、Performance、Gallery、Profiles、Materials、Settings、Logs。
|
||
- Workflow 子组件、Profiles 子面板、Settings 子面板、Dialogs/Drawers。
|
||
- 独立 Web 与 AstrBot plugin-page 两个 Vite 入口。
|
||
|
||
## 统一规则
|
||
|
||
- 视觉 token:`frontend/standalone-web/src/styles/tokens.css`。
|
||
- 统一 surface:`var(--panel)` / `var(--panel-muted)`,默认取消装饰性宽阴影。
|
||
- 统一形状:小控件 6–8px,页面 surface 10px,状态 pill 使用 999px。
|
||
- 统一间距:4/8/12/16/20/24px。
|
||
- 统一 focus:主色 3px focus ring,表单和按钮保留键盘可见焦点。
|
||
- 统一状态:good/warn/bad/idle 使用语义边框和背景,不再依赖顶部/侧边粗色条。
|
||
- 统一动效:保留必要状态反馈;移除布局属性过渡,支持 `prefers-reduced-motion`。
|
||
- 统一响应式:修复 1265px 桌面窗口下 Overview/Gallery 横向溢出,9 个主要 view 均通过 smoke test。
|
||
|
||
## 结果
|
||
|
||
- Impeccable detector:0 条命中。
|
||
- 浏览器 smoke test:`overview`、`generate`、`queue`、`performance`、`images`、`profiles`、`materials`、`settings`、`logs` 均成功加载。
|
||
- 桌面窗口检查:`scrollWidth === clientWidth`,未发现横向溢出。
|
||
- plugin-page bridge 入口与独立 Web 入口均可构建。
|
||
|
||
## 验证命令
|
||
|
||
- `npm.cmd run typecheck`
|
||
- `npm.cmd run test:contracts`:19/19 通过
|
||
- `npm.cmd run build:web`
|
||
- `npm.cmd run build:plugin`
|
||
- `node C:\Users\Administrator\.agents\skills\impeccable\scripts\detect.mjs --json frontend/standalone-web/src/App.vue frontend/standalone-web/src/components frontend/standalone-web/src/features`
|
||
|
||
## 已知遗留
|
||
|
||
- Web JS gzip 仍约 211.6 kB,构建保留 Vite 的大 chunk 警告;这是后续代码拆分/动态导入工作,不在本轮视觉重构中处理。
|
||
- 未连接真实 AstrBot 后端,因此 smoke test 验证的是前端预览态、路由切换和布局,不替代真实 API/插件页数据联调。
|
||
|
||
|
||
## Final execution evidence
|
||
|
||
- Browser smoke: 36 checks across 9 views and 4 desktop sizes; all passed with scrollWidth equal to clientWidth.
|
||
- Frontend UI tests: 7/7 passed.
|
||
- Contract tests: 25/25 passed.
|
||
- Typecheck: passed.
|
||
- Plugin build: passed.
|
||
- Standalone build: passed.
|
||
- Generated web/pages artifacts were removed from the working tree after validation.
|
||
- Live AstrBot plugin-page acceptance is explicitly pending and documented in docs/ui-redesign-integration-validation-2026-07-21.md.
|