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

54 行
2.6 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 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.