astrbot_plugin_imagestudio/docs/ui-redesign-final-check-2026-07-21.md

2.6 KiB

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.