1xiny
122 lines
17 KiB
Markdown
122 lines
17 KiB
Markdown
# Issue Hub AI 人工设计定稿审计清单
|
||
|
||
生成时间：2026-06-18
|
||
|
||
## 1. 当前状态
|
||
|
||
来源：`docs/design/visual-diff/report.md`，最新报告时间 `2026-06-18T04:47:26.995Z`。
|
||
|
||
- 对比页面：12 张。
|
||
- 可进入人工复核 / 建议直接通过：4 张。
|
||
- 通过但备注 / 定稿候选：8 张。
|
||
- 需人工决策 / 带备注复核：0 张。
|
||
- 自动 visual diff 仍标记 5 张需打磨；人工定稿流程已将其中中心调度台、提醒升级、知识复盘、管理看板、处理人详情推进为定稿候选。
|
||
- 当前阶段从“自动视觉 diff 微调”转入“人工设计定稿审计”。自动 diff 只作为定位证据，不再作为继续盲追的唯一目标。
|
||
|
||
明确原则：
|
||
|
||
- 不再无目标盲追 visual diff。
|
||
- 后续改动必须基于人工审美目标、明确设计图差异，或已确认的业务可读性问题。
|
||
- 若继续改动 5 个自动 diff 诊断页，必须先给出明确设计目标、验收标准和不触碰范围。
|
||
- 文案、动态数据、图标细节、头像、业务样例与 AI 生成稿存在天然差异，不能仅凭像素差异判定必须修改。
|
||
|
||
## 2. 12 页面总览
|
||
|
||
| 页面 | 路由或截图名 | 设计图 | 实现截图 | diff 图 | 状态 | avg / max 或关键分数 | 人工结论 |
|
||
| --- | --- | --- | --- | --- | --- | --- | --- |
|
||
| 中心调度台 | `/#/center-dashboard` / `dispatcher-01-center-dashboard.png` | `docs/design/images2/dispatcher-01-center-dashboard.png` | `docs/design/implementation-screenshots/dispatcher-01-center-dashboard.png` | `docs/design/visual-diff/dispatcher-01-center-dashboard-diff.png` | 通过但备注 / 定稿候选 | avg 19.94 / max 255.00 / RMS 47.78 / 变更像素 17.7% | 建议采用当前核心骨架、真实分页、每页条数、行级派发面板和右侧 AI 推荐检查器定稿；动态业务样例与侧栏底部状态策略作为功能化偏差备注。 |
|
||
| 问题池 | `/#/issue-pool` / `dispatcher-02-issue-pool.png` | `docs/design/images2/dispatcher-02-issue-pool.png` | `docs/design/implementation-screenshots/dispatcher-02-issue-pool.png` | `docs/design/visual-diff/dispatcher-02-issue-pool-diff.png` | 通过但备注 / 定稿候选 | avg 17.18 / max 255.00 / RMS 43.47 / 变更像素 14.1% | 建议接受右侧 AI 洞察简化为文本洞察区，保留真实分页、提交人筛选、CSV 导出、批量派发和批量治理闭环。 |
|
||
| 部门队列 | `/#/department-queue` / `dispatcher-03-department-queue.png` | `docs/design/images2/dispatcher-03-department-queue.png` | `docs/design/implementation-screenshots/dispatcher-03-department-queue.png` | `docs/design/visual-diff/dispatcher-03-department-queue-diff.png` | 建议通过 | avg 17.42 / max 255.00 / RMS 41.57 / 变更像素 13.9% | 首屏结构、队列表格、成员负载、热力图和 AI 建议均可进入定稿。 |
|
||
| 提醒升级 | `/#/escalation-center` / `dispatcher-04-escalation-center.png` | `docs/design/images2/dispatcher-04-escalation-center.png` | `docs/design/implementation-screenshots/dispatcher-04-escalation-center.png` | `docs/design/visual-diff/dispatcher-04-escalation-center-diff.png` | 通过但备注 / 定稿候选 | avg 18.62 / max 255.00 / RMS 45.94 / 变更像素 15.7% | 已按返修目标恢复风险分组表格密度，并补齐右侧升级链路、提醒规则、最近动作和备注区；动态风险候选数量和 SLA 文案差异作为功能化偏差备注。 |
|
||
| 知识复盘 | `/#/knowledge-review` / `dispatcher-05-knowledge-review.png` | `docs/design/images2/dispatcher-05-knowledge-review.png` | `docs/design/implementation-screenshots/dispatcher-05-knowledge-review.png` | `docs/design/visual-diff/dispatcher-05-knowledge-review-diff.png` | 通过但备注 / 定稿候选 | avg 18.92 / max 255.00 / RMS 44.57 / 变更像素 14.9% | 建议采用当前可编辑 AI 复盘工作区定稿；保留真实分页、每页条数、摘要编辑保存和三类知识动作，差异作为功能化偏差备注。 |
|
||
| 规则配置 | `/#/rule-config` / `dispatcher-06-rule-config.png` | `docs/design/images2/dispatcher-06-rule-config.png` | `docs/design/implementation-screenshots/dispatcher-06-rule-config.png` | `docs/design/visual-diff/dispatcher-06-rule-config-diff.png` | 建议通过 | avg 17.81 / max 255.00 / RMS 42.33 / 变更像素 15.5% | 三栏规则工作台、AI 策略、规则预览和底部发布栏成立。 |
|
||
| 管理看板 | `/#/analytics-board` / `dispatcher-07-analytics-board.png` | `docs/design/images2/dispatcher-07-analytics-board.png` | `docs/design/implementation-screenshots/dispatcher-07-analytics-board.png` | `docs/design/visual-diff/dispatcher-07-analytics-board-diff.png` | 通过但备注 / 定稿候选 | avg 19.95 / max 255.00 / RMS 44.41 / 变更像素 19.2% | 建议采用当前首屏设计量级展示、真实导出 / 下钻 / 刷新记录、自定义布局入口、中部榜单和右侧 AI 洞察定稿；图表数据与业务文本差异作为功能化偏差备注。 |
|
||
| 我的待办 | `/#/client-workbench` / `client-01-workbench.png` | `docs/design/images2/client-01-workbench.png` | `docs/design/implementation-screenshots/client-01-workbench.png` | `docs/design/visual-diff/client-01-workbench-diff.png` | 通过但备注 / 定稿候选 | avg 17.72 / max 255.00 / RMS 44.08 / 变更像素 14.7% | 建议接受当前详情与操作区优先于右侧相似问题区的首屏取舍，保留任务处理主路径和操作优先级。 |
|
||
| 提交问题 | `/#/submit-issue` / `client-02-submit-issue.png` | `docs/design/images2/client-02-submit-issue.png` | `docs/design/implementation-screenshots/client-02-submit-issue.png` | `docs/design/visual-diff/client-02-submit-issue-diff.png` | 建议通过 | avg 14.16 / max 254.34 / RMS 37.39 / 变更像素 11.3% | 表单节奏、右侧 AI 预检查、相似问题、预计流转和底部动作都接近定稿状态。 |
|
||
| 处理人详情 | `/#/handler-detail` / `client-03-issue-detail-handler.png` | `docs/design/images2/client-03-issue-detail-handler.png` | `docs/design/implementation-screenshots/client-03-issue-detail-handler.png` | `docs/design/visual-diff/client-03-issue-detail-handler-diff.png` | 通过但备注 / 定稿候选 | avg 18.22 / max 255.00 / RMS 43.82 / 变更像素 16.2% | 建议采用当前三栏骨架、顶栏动作、时间线、评论工具和单一右栏分组结构定稿；业务样例、头像和静态文案差异作为功能化偏差备注。 |
|
||
| 提交人追踪 | `/#/submitter-tracking` / `client-04-submitter-tracking.png` | `docs/design/images2/client-04-submitter-tracking.png` | `docs/design/implementation-screenshots/client-04-submitter-tracking.png` | `docs/design/visual-diff/client-04-submitter-tracking-diff.png` | 通过但备注 / 定稿候选 | avg 17.91 / max 255.00 / RMS 43.59 / 变更像素 14.3% | 三栏追踪结构可定稿；默认选中样例、数量、头像和附件数据差异作为真实演示数据偏差备注。 |
|
||
| 移动端提交 / 补充 | `/#/mobile-submit` / `client-05-mobile-submit.png` | `docs/design/images2/client-05-mobile-submit.png` | `docs/design/implementation-screenshots/client-05-mobile-submit.png` | `docs/design/visual-diff/client-05-mobile-submit-diff.png` | 建议通过 | avg 17.87 / max 254.34 / RMS 44.91 / 变更像素 12.9% | 双手机预览、表单、补充流程和移动端状态稳定，可进入定稿。 |
|
||
|
||
## 3. 自动 diff 诊断页定稿备注
|
||
|
||
### 3.1 Center dashboard
|
||
|
||
- 当前指标：avg 19.94，RMS 47.77，变更像素 17.7%，max 255.00。
|
||
- hotspots：bottom-right 60.21 / 44.1%，bottom-right 57.90 / 40.3%，bottom-left 41.63 / 25.2%。
|
||
- 已保留的正向调整：检查器底部双按钮比例微调为 `0.78fr / 1.12fr`；中心调度台路由级隐藏侧栏底部快捷区；中心调度台真实分页和每页条数切换已通过 smoke 覆盖。
|
||
- no-go / 反向方向：KPI 高度压缩、表格 / AI 面板文案映射、工具条补刷新图标、自定义复选框、KPI 图标饱和化、人员负载卡继续低于 6px、人员负载圆环放大、KPI / 表格整体压缩、右侧相似问题卡密度压缩。
|
||
- 建议定稿结论：通过但备注。中心调度台当前左侧导航、顶部搜索、四个 KPI、分段筛选、中心表格、右侧 AI 推荐检查器和底部双动作骨架成立；真实分页、每页条数、行级派发面板、批量操作和右侧动态推荐数据作为产品化闭环定稿。
|
||
- 人审重点：仅复核当前右侧 AI 推荐检查器底部负载卡与动作区、隐藏侧栏底部快捷区和中心表格密度是否满足调度扫描效率；不再以静态样例、头像或固定 footer 作为返修依据。
|
||
- 可接受偏差：动态业务文案、AI 推荐样例、表格行数据、右侧相似问题条目、图标细节可与设计稿不完全一致，只要信息层级和操作路径稳定。
|
||
- 额外可接受偏差：中心表格保留真实分页、每页条数切换、选中计数和动态 footer；行级“更多派发操作”面板保留采纳、改派、AI 依据、退回补充入口；侧栏底部保留当前系统状态、更新时间、同步入口和用户区策略。
|
||
- 如需继续改动：必须先明确是要贴近设计稿的底部检查器结构、侧栏完整性，还是调度可读性；不得再以单次 avg 变化作为唯一改动依据。
|
||
|
||
### 3.2 Analytics board
|
||
|
||
- 当前指标：avg 19.95，RMS 44.41，变更像素 19.2%，max 255.00。
|
||
- hotspots：middle-left 46.00 / 47.9%，top-left 43.41 / 87.6%，bottom-left 43.33 / 27.5%。
|
||
- 已保留的正向调整：首屏 KPI / 趋势 / 状态分布 / Top5 / SLA 风险 / 本周对比接入领域层设计量级展示选择器；中部榜单、效率摘要和右侧 AI 洞察列做温和密度收敛；自定义看板组件显示 / 隐藏与本地持久化、CSV 导出和真实下钻继续保留。
|
||
- no-go / 反向方向：右侧 AI 洞察正文强制两行裁剪、右侧洞察卡过度压缩、RankingPanel full-width 轨道渐变、首张 KPI 图标替换、效率趋势图高度压缩、顶部趋势 / 状态分布两列比例改动、中部榜单过度压缩、右上工具组继续上移、tooltip 标题 / 位置改动、进度条风险色重映射。
|
||
- 建议定稿结论：通过但备注。管理看板当前五个 KPI、趋势图、状态分布、AI 洞察、Top5 榜单、效率趋势、SLA 风险、本周对比、导出、下钻、刷新记录和自定义组件显隐均形成稳定功能闭环。
|
||
- 人审重点：仅复核顶部趋势与状态分布比例、中部排行区密度和右侧 AI 洞察可读性是否满足运营看板阅读；不再以静态图表数据点、榜单排序或洞察文案作为返修依据。
|
||
- 可接受偏差：图表数据、tooltip 展示点、榜单排序、AI 洞察文本、导出相关状态可以与静态设计稿不同。
|
||
- 额外可接受偏差：首屏 KPI / 趋势 / 状态分布 / Top5 / SLA 风险 / 本周对比使用设计量级展示选择器，真实业务数据继续用于导出、下钻和刷新记录；右上“导出报表”“自定义看板”入口保留当前产品化位置；右侧 AI 洞察保留完整正文，不强制两行裁剪。
|
||
- 如需继续改动：必须先明确是优化图表复刻、提升运营密度，还是强化业务功能入口；不要继续试探 padding / 行高 / icon 这类已多次无收益方向。
|
||
|
||
### 3.3 Knowledge review
|
||
|
||
- 当前指标：avg 18.92，RMS 44.57，变更像素 14.9%，max 255.00。
|
||
- hotspots：bottom-center 44.90 / 28.0%，top-right 43.13 / 28.1%，middle-center 42.71 / 26.0%。
|
||
- 已保留的正向调整：右侧 AI 摘要补齐编辑图标和内联保存；真实草稿保存与时间线；知识复盘路由背景覆盖为 `#f8fafb`；复盘设置保存、持久化和重新打开恢复已通过 smoke 覆盖；footer 使用设计总量口径展示，同时保留真实分页状态。
|
||
- no-go / 反向方向：右侧摘要主卡高度压缩、顶部指标 / 趋势卡压缩、副标题精确文案替换、筛选栏补图标、右侧摘要栏继续扩到 650px、摘要底部按钮继续压缩、表格行高回压、复盘设置按钮收紧、摘要 padding / 分栏调整、底部动作按钮比例改动、处理人列头像锚点、摘要动作区 gap 继续收紧。
|
||
- 建议定稿结论：通过但备注。右侧 AI 摘要按“可编辑、可保存、可生成知识草稿”的产品化工作区定稿；底部三按钮保持当前功能优先级；中部表格保留真实分页和设计总量 footer。
|
||
- 人审重点：仅复核当前可编辑工作区是否满足业务可读性，不再以静态设计稿中的摘要高度、按钮 gap、筛选图标或头像锚点作为返修依据。
|
||
- 可接受偏差：复盘对象、AI 摘要文案、处理人数据、草稿状态和时间线可与设计稿样例不同。
|
||
- 如需继续改动：必须提出新的人工审美目标或明确业务可读性问题；不得再继续用 1px gap / padding、摘要栏宽度、行高、按钮间距、筛选图标或头像锚点试探。
|
||
|
||
### 3.4 Client handler detail
|
||
|
||
- 当前指标：avg 18.22，RMS 43.82，变更像素 16.2%，max 255.00。
|
||
- hotspots：top-right 48.63 / 45.9%，top-left 48.63 / 34.7%，top-left 45.36 / 38.6%。
|
||
- 已保留的正向调整：时间线圆点保持 19px 的可读性边界；处理人详情当前右栏仍保持单一大面板内分隔结构；右侧主按钮保持渐变样式；评论工具栏保持当前视觉入口，功能层升级为附件 / 图片 / 链接真实写入，不额外扩张工具栏尺寸。
|
||
- no-go / 反向方向：顶栏头像增加发型层次、路由级文案映射、时间线竖线左移、时间线圆点继续压缩、顶栏处理按钮加宽、顶栏通知 / 帮助 / 用户区 gap 收紧、顶栏动作按钮加宽、左栏 260px / 右栏 390px 三栏比例微调、右侧主按钮改纯色、右栏 AI 建议 / 相似问题 / 下一步动作改独立白色卡片、客户端侧栏业务标签整体映射。
|
||
- 建议定稿结论：通过但备注。三栏骨架、顶栏动作、时间线、评论工具、右侧 AI 建议和下一步动作均按当前实现定稿；评论附件 / 图片 / 链接能力以 smoke 和交互证据证明，不再扩大工具栏或增加说明文字。
|
||
- 人审重点：仅复核当前处理工作区是否满足处理人可读性与操作效率，不再以静态设计稿中的头像细节、业务样例、顶栏间距或右栏卡片拆分作为返修依据。
|
||
- 可接受偏差：问题标题、描述、提交人、时间、SLA、AI 建议、相似历史问题、顶栏用户头像和通知数字可与设计稿样例不同，按真实演示数据定稿。
|
||
- 如需继续改动：必须提出新的人工审美目标或业务可读性问题；不得继续尝试已证伪的独立右栏卡片、三栏比例、时间线圆点、头像细节、按钮色彩和客户端侧栏标签映射方向。
|
||
|
||
## 4. 建议直接通过页面复核清单
|
||
|
||
适用页面：部门队列、规则配置、提交问题、移动端提交 / 补充。
|
||
|
||
- 布局：主导航、顶栏、主内容、右侧检查器 / 操作区与设计稿的空间关系是否基本一致。
|
||
- 信息层级：页面标题、KPI、筛选、列表 / 表格、主操作、次操作是否符合业务优先级。
|
||
- 可读性：表格密度、卡片间距、徽标颜色、风险状态、长文本换行没有明显遮挡或溢出。
|
||
- 交互状态：筛选、分页、详情展开、主操作、反馈 toast、移动端窄屏状态符合已实现功能预期。
|
||
- 设计偏差：只记录影响审美、识读或业务判断的差异；动态数据、AI 文案、图标细节和头像样例不作为单独阻塞项。
|
||
- 定稿判断：当前建议为“通过”；如人工复核发现新的审美或业务可读性问题，再降级为“通过但备注”或“需带目标返修”。
|
||
- 返修要求：若判定返修，必须写明目标区域、期望观感、设计图依据、不能破坏的现有功能和复验命令。
|
||
|
||
## 5. 最终定稿 gate
|
||
|
||
最终定稿前的验证命令：
|
||
|
||
```powershell
|
||
npm run capture:pages
|
||
npm run visual:diff
|
||
npm run build
|
||
npm test
|
||
npm run smoke:browser
|
||
```
|
||
|
||
最近基线说明：
|
||
|
||
- `npx tsc --noEmit`：最近记录已通过。
|
||
- `npm test`：最近记录已通过，29 个测试文件、104 个测试。
|
||
- `npm run build`：最近记录已通过，保留既有 500 kB chunk 体积提示。
|
||
- `npm run capture:pages`：最近记录已通过，并刷新 12 张桌面实现截图及移动截图。
|
||
- `npm run visual:diff`：最近记录已通过，最新报告时间 `2026-06-18T04:47:26.995Z`，自动诊断为 7 / 5；人工流程为 4 页建议通过、8 页定稿候选、0 页需决策。
|
||
- `npm run smoke:browser`：最近记录已通过；后续只要涉及交互、状态流转、路由、持久化、导出或移动端行为变更，必须补跑。
|
||
|
||
本次定稿状态校准后已重新运行 `review-index.html` 状态计数校验、`npx tsc --noEmit`、`npm test`、`npm run build`、`npm run smoke:browser`；本轮未改主应用截图，未刷新 capture / visual diff。
|