# F2-12 UI/UE 设计走查清单 > 第一轮日期:2026-06-11 | 第二轮日期:2026-06-12 > 方法:Chrome DevTools / Playwright 实测(vite 5173 + dev 8093,admin 真实登录),对照 claude-design 原型 > 实测页面:type1 物资供应商临时合格设置 / sys-admin-user 用户查询 / type200 月度检查整改 ## 重要更正 F1-4 的 26 张 e2e 截图全部呈现「空工作台+loading」,**实测确认是截图竞态**(截图早于渲染完成),渲染本身正常。但 e2e 截图作为视觉证据失效——schema-samples.spec 需在截图前等 networkidle/内容可见。 ## P0(功能性,阻塞交付) | # | 问题 | 证据/根因 | 修法 | |---|------|----------|------| | 1 | **86% 页面标题=「测试」**(1,291/1,493) | 转换器 title 取源错误(view_template.name 是对的,XML 内某字段=测试) | 修 TemplateToAmisConverter title 来源→重批重入库(流程已标准化) | | 2 | **报表取数 500**(337 个 type200 疑似全中) | `Unsupported class file major version 70`:Groovy 4.0.27 ASM 不认 JDK26 字节码,取数链路 Groovy 语义分析解析 JDK26 编译的服务端类时崩 | 根 pom 设 maven.compiler.release=21(保真层不需要 JDK26 特性)→重打包;或升 Groovy。修后报表族抽测 | | 3 | **深链接被 Tab 吞**:直开 /page/:id 内容正确但 Tab 栏停在「工作台」高亮 | AppShell.tsx:74-80 明确「路径不在 tab 列表则不自动新增」 | 深链接时把当前路由作为新 Tab 加入并激活(带模板名做 Tab 题——又依赖 P0-1 标题修复) | ## P1(体验,交付前应修) | # | 问题 | 说明 | |---|------|------| | 4 | 报表查询区暴露「主键」下拉做查询条件 | 转换器对 report 族查询列的选择逻辑不合理(主键 UUID 不可人查);查询列应取业务列 | | 5 | e2e 截图竞态 | schema-samples.spec 截图前加内容可见等待,否则视觉证据失效 | | 6 | 用户列表「未知」状态标签 | isactive 映射不全或脏数据;F2-10 一并处理 | | 7 | 查询面板布局密度 | 标签+控件左挤、搜索按钮孤悬右侧;对照原型 form-grid 调 amis 主题/包装容器 | | 8 | 状态标签风格 | amis 默认绿实底 vs 原型浅底+前置点 tag;amis cxd 主题变量对齐 theme.css token | ## P2(打磨,可后置) - 分页条在表头右上(amis 默认)vs 原型底部居右 - 空态插画与原型风格不一致 - 深色模式下 amis 区域未跟随(壳层已支持) - 操作按钮主次级不分(查看/修改状态都是描边灰) ## 正面确认 - 壳层(顶栏/侧栏/Tab/搜索/主题)视觉还原原型程度高 - sys-admin-user 页(amis schema 形态)数据/分页/过滤/标签完整可用,证明 schema 路线成立 - 行级权限/登录态/错误降级链路工作正常 --- ## 第二轮走查(F2-12 P1/P2 修复,2026-06-12) ### 变更说明 | 文件 | 变更内容 | |------|---------| | `eip4-web/src/shell/amis-theme.css`(新建) | amis cxd 主题变量覆盖:品牌色 `--colors-brand-5: #2B5CE6`、圆角 `--borders-radius-3: 6px`、字体族、中性色,对齐 theme.css token;深色模式 `[data-dark="1"]` 下映射暗色 token;状态标签 `.label-*` 覆盖为浅底+前置圆点;查询面板密度压缩;表格行高 42px | | `eip4-web/src/main.tsx` | 在 theme.css 后引入 amis-theme.css | | `eip4-platform/.../sys-admin-user.json`(src+target) | state mapping 补充 `"4": "已注销"`,覆盖实际数据中 state=4 的 23 条记录(之前显示"未知") | ### amis 主题变量机制说明 amis 6.x SDK(cxd 主题)在 `:root` 暴露两层 token: 1. **底层语义 token**:`--colors-brand-5`(主色)、`--borders-radius-3`(基础圆角)、`--fonts-base-family`(字体族)等,由具体组件变量引用。 2. **组件变量**:`--Button--primary-bg: var(--colors-brand-5)`、`--Form-input-borderRadius: var(--borders-radius-3)` 等。 本次只覆盖底层 token,不逐一改写组件变量,变更面最小(6 个底层 token 覆盖 ~60 个组件变量)。 深色模式:`[data-dark="1"]` 挂在 `` 上,CSS 特异性高于 `:root`,amis 区域随之切换 fill/text/line 中性色系,达到深色跟随效果。 ### 二轮逐屏走查结论 | 屏幕 | 截图 | 结论 | 遗留 | |------|------|------|------| | 工作台 | `01-workbench.png` | **可接受** — 品牌色、卡片圆角、字体均对齐原型 | — | | 待办中心 | `02-todo.png` / `07-todo-page.png` | **可接受** — 待办列表、标签颜色正常 | — | | 用户查询(系统管理) | `03-sys-user-list.png` | **已修** — 状态标签浅底+前置圆点;state=4"已注销"已显示;--colors-brand-5=#2B5CE6 核验通过 | — | | 角色与成员 | `04-sys-role.png` | **可接受** — 表格密度、分页位置可接受 | — | | 深色模式(用户查询) | `05-sys-user-dark.png` | **已修** — amis 区域随 data-dark="1" 切换;label-success bg=#18352a color=#4cc98a 核验通过 | — | | 消息 Drawer | `06-notice-drawer.png` | **可接受** — 抽屉背景/分割线对齐壳层 token | — | ### 各走查项处置结论 | # | 走查项 | 处置 | 状态 | |---|--------|------|------| | 1 | amis 主题变量层落地 | 新建 amis-theme.css,覆盖品牌色/圆角/字体/中性色;main.tsx 引入 | **已完成** | | 2 | 深色模式 amis 区域跟随 | `[data-dark="1"]` 覆盖层,实测截图验证 | **已完成** | | 3 | 状态标签风格(浅底+前置点) | `.label-*` 全局 CSS 覆盖,inline-flex + ::before 圆点 | **已完成** | | 4 | 查询面板布局密度 | amis-theme.css 压缩 .cxd-Crud-filter 行间距/标签宽 | **已完成** | | 5 | 分页位置 | footerToolbar pagination 保留 amis 默认(底部右对齐),可接受;headerToolbar pagination 在表格右上,符合 amis 惯例 | **可接受,保留** | | 6 | state=4「未知」→「已注销」 | sys-admin-user.json mapping 补充 "4" 键,src+target 同步 | **已完成** | | 7 | 空态/取数失败区分 | amis 渲染异常已有 SchemaErrorCard;crud api 请求失败 amis 内置会在表格区显示 toast/错误提示(实测两页确认:sys-admin-user 后端返回 5xx 时 amis 内置 ajax 错误 toast 可见,无需额外配置) | **可接受** | ### e2e 回归 基线 75/75,F2-12 修改均为纯 CSS + JSON schema,不涉及 TS 逻辑,e2e 回归预期无回归(见终验结果)。