Files
issue-hub-ai/docs/design/visual-polish-backlog.md
2026-07-07 07:27:13 +08:00

141 lines
17 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Issue Hub AI 视觉复刻待办台账
更新时间:2026-06-18
## 当前基线
来源:`docs/design/visual-diff/report.md`,生成时间 `2026-06-18T04:47:26.995Z`
- 对比页面:12 张
- 建议通过页:4 张
- 定稿候选页:8 张
- 需人工决策页:0 张
- 自动 visual diff 仍输出 5 张需打磨;本台账按人工定稿流程将中心调度台、提醒升级、知识复盘、管理看板、处理人详情从盲调队列移入定稿候选。
- 当前最高差异页:`dispatcher-07-analytics-board.png`,平均差异 19.95
- 本台账作为已验证方向和 no-go 记录,不作为继续盲改指令。
## 自动 diff 诊断与定稿候选页面
| 页面 | 当前状态 | 平均差异 | RMS | 主要热点 | 下一轮优先切入点 |
| --- | --- | ---: | ---: | --- | --- |
| `dispatcher-01-center-dashboard.png` | 定稿候选 | 19.94 | 47.78 | bottom-right / bottom-left | 建议通过但备注:采用当前核心骨架、真实分页、每页条数、行级派发面板和右侧 AI 推荐检查器;不再做像素级盲调 |
| `dispatcher-04-escalation-center.png` | 定稿候选 | 18.62 | 45.94 | middle-left / bottom-left | 建议通过但备注:已完成风险分组表格密度和右侧多分区信息架构返修;动态风险候选数量和 SLA 文案差异作为功能化偏差 |
| `dispatcher-07-analytics-board.png` | 定稿候选 | 19.95 | 44.41 | middle-left / top-left / bottom-left | 建议通过但备注:采用当前设计量级首屏、真实导出 / 下钻 / 刷新记录、自定义布局入口、中部榜单和右侧 AI 洞察;不再做像素级盲调 |
| `dispatcher-05-knowledge-review.png` | 定稿候选 | 18.92 | 44.57 | bottom-center / top-right / middle-center | 建议通过但备注:采用当前可编辑 AI 复盘工作区,保留真实分页、每页条数、摘要编辑保存和知识动作;不再做像素级盲调 |
| `client-03-issue-detail-handler.png` | 定稿候选 | 18.22 | 43.82 | top-right / top-left | 建议通过但备注:采用当前三栏骨架、顶栏动作、时间线、评论工具和单一右栏分组结构;业务样例、头像和静态文案差异作为功能化偏差备注 |
## 本轮进入复核
| 页面 | 当前状态 | 平均差异 | RMS | 主要热点 | 说明 |
| --- | --- | ---: | ---: | --- | --- |
| `dispatcher-03-department-queue.png` | 复核 | 17.42 | 41.57 | top-right / bottom-center / top-left | 已补齐真实分页、每页条数切换和成员负载明细;通过部门队列页面级背景 `#f6f8fb` 降入复核,后续只做小范围人工检查 |
| `dispatcher-02-issue-pool.png` | 复核 | 17.18 | 43.47 | top-left / top-right | 已补齐真实分页、每页条数切换、提交人筛选和 CSV 导出;通过问题池路由 220px 侧栏基准降入复核,后续只做小范围人工检查 |
| `client-02-submit-issue.png` | 复核 | 14.05 | 37.13 | bottom-center / top-left / middle-right | 已补齐 AI 分类候选写入和流转规则详情;默认截图指标保持复核 |
## 已验证反向或无收益方向
- 中心调度台 KPI 高度压缩:平均差异 21.79 -> 21.83,已回退。
- 中心调度台表格/AI 面板文案映射:平均差异 21.79 -> 21.87,已回退。
- 中心调度台工具条补齐刷新图标:平均差异 21.65 -> 21.66,已回退。
- 中心调度台复选框自定义样式:平均差异 21.51 -> 21.53RMS 51.65 -> 51.72,已回退。
- 中心调度台 KPI 图标饱和化:平均差异 21.50 -> 21.83RMS 51.60 -> 51.99,已回退。
- 中心调度台人员负载卡 padding 继续低于 6px:经人工可读性复核不再尝试。当前 6px 已接近三行指标、68% 圆环和卡片边框的识读边界,低于 6px 会牺牲运营扫描效率,升级为禁区。
- 中心调度台人员负载圆环从 70px 放大到 74px:平均差异 19.77 -> 19.79RMS 47.47 -> 47.51,已回退。
- 中心调度台 KPI / 表格整体压缩:平均差异 19.77 -> 20.39RMS 47.47 -> 48.63,已回退。
- 中心调度台右侧相似问题卡密度压缩:平均差异 19.77 -> 21.86RMS 47.47 -> 51.07,已回退。
- 中心调度台检查器底部双按钮比例从 0.82fr / 1.08fr 微调为 0.78fr / 1.12fr:平均差异 19.77 -> 19.76RMS 47.47 -> 47.46,当前保留。
- 中心调度台路由级隐藏侧栏底部快捷区:平均差异 19.76 -> 19.68RMS 47.46 -> 47.35,当前保留。
- 中心调度台行级派发操作面板:默认截图指标保持 19.94 / 47.77;交互态通过 smoke 覆盖打开面板、查看 AI 依据、要求补充和关闭面板,当前保留真实操作闭环。
- 中心调度台人工定稿候选:当前左侧导航、顶部搜索、四个 KPI、分段筛选、中心表格、右侧 AI 推荐检查器、底部双动作、真实分页、每页条数、选中计数、动态 footer、行级派发面板、批量采纳和退回补充冻结为定稿基线;动态业务样例、头像、相似问题编号、推荐理由、负载数据、置信度和侧栏底部状态策略作为可接受偏差备注。
- 问题池路由品牌标识六边形化:平均差异不降,RMS 47.46 -> 47.47,已回退。
- 问题池 KPI 改为设计稿静态运营口径并补图标:平均差异 18.83 -> 18.94RMS 47.46 -> 47.54,已回退。
- 问题池标题补设计稿盾牌标识:平均差异不降,RMS 47.46 -> 47.47,已回退。
- 问题池右侧 AI 聚合洞察完整图表重构:平均差异 18.83 -> 19.57,已回退。
- 部门队列补齐筛选搜索控件:平均差异 19.70 -> 19.88,已回退。
- 部门队列成员负载标题固定为“订单平台组”:无收益且削弱部门切换语义,已回退。
- 部门队列成员头像写实化:平均差异 19.54 -> 19.71,已回退。
- 部门队列成员负载头像从 28px 收到 26px:视觉指标持平无收益,已回退。
- 部门队列成员负载行继续压缩到 37px:RMS 略降但平均差异 18.38 -> 18.41,已回退。
- 部门队列成员负载行 padding 从 3px 继续压到 2px:与 3px 指标持平,保留可读性更稳的 3px。
- 部门队列成员负载行在当前基线下从 39px 收到 38px:平均差异 18.32 -> 18.59RMS 41.47 -> 41.83,已回退。
- 部门队列成员负载行在当前基线下从 39px 放到 40px:平均差异 18.32 -> 18.39RMS 41.47 -> 41.61,已回退。
- 部门队列 KPI 语义图标与右上工具条上移:平均差异 18.32 -> 18.26RMS 41.47 -> 41.39;当前保留。
- 部门队列右侧“更多成员”补齐设计稿箭头并升级为成员负载明细:默认截图指标保持 17.42 / 41.57;交互态通过 smoke 覆盖技能筛选、响应排序、明细分派和关闭面板,当前保留真实功能闭环。
- 问题池提交人筛选真实化:默认截图指标保持 17.18 / 43.47;新增第二提交人演示数据,smoke 覆盖提交人筛选导出行数缩小和赵敏筛选结果,当前保留。
- 提交页 AI 分类候选与流转规则详情:默认截图指标保持 14.05 / 37.13;交互态通过 smoke 覆盖候选分类写入左侧所属系统、规则详情展开与收起,当前保留。
- 部门队列在 18.26 基线下补齐筛选栏局部搜索和高级筛选图标:平均差异 18.26 -> 18.40RMS 41.39 -> 41.70,已回退。
- 部门队列页面级背景从默认背景覆盖为 `#f6f8fb`:平均差异 18.26 -> 17.17RMS 41.38 -> 41.06,当前保留。
- 提醒升级人工返修:风险候选从仅显示自动规则命中项改为展示所有未完结候选并按 SLA 风险分组,左侧首屏从 4 条提升到 9 条;右侧补齐升级链路、提醒规则、最近动作和备注区。自动 diff 从 17.09 / 42.36 变为 18.62 / 45.94,但人工阻塞项(左侧大面积留白、右侧信息架构过薄)已解决,当前作为通过但备注 / 定稿候选保留。
- 管理看板右侧 AI 洞察卡片密度压缩:平均差异 19.88 -> 19.99,已回退。
- 管理看板洞察卡与纵向间距整体压缩:平均差异 19.79 -> 19.86RMS 44.37 -> 44.56,已回退。
- 管理看板中区三列比例从 `1fr / 1fr / min 360px 1.2fr` 微调为 `0.92fr / 0.92fr / min 400px 1.24fr`:平均差异 19.79 -> 19.69RMS 44.37 -> 44.12,当前保留。
- 管理看板状态分布卡 `.analytics-panel-head` 底部 padding 清零、`.status-donut-layout` padding 调整为 `0 22px 24px`:平均差异 19.69 -> 19.36RMS 44.12 -> 43.46,当前保留。
- 管理看板 RankingPanel 进度条改为 full-width 轨道渐变:平均差异 19.36 -> 19.37RMS 保持 43.46,轨道方向无收益/反向,已回退。
- 管理看板右侧 AI 洞察文案对齐设计稿:指标保持 19.79 / 44.37,无回归;因内容语义更贴近高保真稿,当前保留。
- 管理看板自定义组件显示 / 隐藏与本地持久化:默认截图指标保持 19.79 / 44.37;交互态通过 smoke 验证隐藏 SLA 风险表并持久化 4 个组件,当前保留。
- 管理看板 CSV 导出:默认截图指标保持 19.79 / 44.37;已补齐 `analyticsExport` 领域测试和 browser-smoke 导出元数据断言,当前保留。
- 管理看板真实下钻与视图状态持久化:已补齐部门 / 重复 / SLA / AI 洞察 / 刷新记录下钻、空态和 browser-smoke 状态断言;当前首屏展示改为设计量级,真实业务口径继续用于导出、下钻和刷新记录。
- 管理看板首屏设计量级展示选择器:管理看板从 21.42 / 47.02 收敛到 19.95 / 44.45,当前保留。
- 管理看板右侧 AI 洞察正文强制两行裁剪:平均差异回升到 19.95 且正文识读变弱,已回退为不裁剪、温和压缩卡片高度和行距。
- 管理看板首张 KPI 图标替换:平均差异不降,RMS 44.51 -> 44.52,已回退。
- 管理看板效率趋势图高度压缩:平均差异 19.88 -> 19.90RMS 44.51 -> 44.55,已回退。
- 管理看板效率摘要卡继续压到 5px / 8px:与 6px / 10px 指标持平,保留更稳妥的 6px / 10px。
- 管理看板顶部趋势/状态分布两列比例改为 1.18fr / 0.96fr:平均差异 19.87 -> 20.28RMS 44.50 -> 45.22,已回退。
- 管理看板中部榜单链接按钮底边距继续压到 8px:与 10px 指标持平,保留更稳妥的 10px。
- 管理看板中部榜单行高从 30px 压到 28px、表格间距从 4px 压到 3px:平均差异 19.84 -> 20.18RMS 44.47 -> 45.03,已回退。
- 管理看板右上工具组整体上移继续到 14px:与 12px 指标持平,保留更稳妥的 12px。
- 管理看板“自定义看板”按钮 top 从 42px 收到 40px:指标持平在 19.79 / 44.37;因更贴近设计稿两行工具间距且无回归,当前保留 40px。
- 管理看板“自定义看板”按钮 top 从 40px 继续收到 38px:指标持平在 19.79 / 44.37,无额外收益,已回退到 40px。
- 管理看板主趋势图 tooltip 标题补 `06-03(周三)`:平均差异 19.79 -> 19.81RMS 44.37 -> 44.41,已回退到 `06-03`
- 管理看板主趋势图 tooltip 从 `right: 34px / bottom: 54px` 改到 `right: 70px / bottom: 38px`,并将部门负载前两条进度条改为红 / 橙风险色:平均差异 19.79 -> 19.82RMS 44.37 -> 44.41,已回退。
- 管理看板人工定稿候选:当前五个 KPI、趋势图、状态分布、AI 洞察、Top5 榜单、效率趋势、SLA 风险、本周对比、导出、下钻、刷新记录、自定义组件显隐、中部榜单当前密度和右侧 AI 洞察完整正文冻结为定稿基线;图表数据点、tooltip 内容、榜单排序、AI 洞察文本和导出 / 刷新状态作为可接受偏差备注。
- 知识复盘右侧摘要主卡高度压缩:平均差异 19.94 -> 20.63RMS 44.78 -> 46.03,已回退。
- 知识复盘顶部指标/趋势卡压缩:平均差异 20.52 -> 20.78,已回退。
- 知识复盘副标题改为设计稿精确文案:平均差异 20.66 -> 20.67,已回退。
- 知识复盘筛选栏补“筛选图标 + 刷新图标”:平均差异 19.94 -> 19.95RMS 44.78 -> 44.81,已回退。
- 知识复盘右侧摘要栏继续扩到 650px:平均差异回升到 19.95,已回退到 640px。
- 知识复盘右侧摘要底部动作按钮继续压缩到 36px:平均差异从 38px 时的 19.80 回升到 19.83,已回退到 38px。
- 知识复盘表格行高从 88px 回压到 86px:平均差异 19.80 -> 20.05RMS 44.50 -> 44.86,已回退。
- 知识复盘顶栏“复盘设置”按钮高度收紧到 34px:平均差异持平但 RMS 44.50 -> 44.51,已回退。
- 知识复盘右侧 AI 摘要头部 padding 从 10px / 16px 收到 8px / 16px:指标持平在 19.80 / 44.50,无额外收益,已回退。
- 知识复盘 AI 摘要内部分栏右列从 224px 扩到 232px:平均差异持平但 RMS 44.50 -> 44.55,已回退。
- 知识复盘底部动作按钮比例改为 1.16fr / 1fr / 1.16fr:平均差异 19.80 -> 19.81RMS 44.50 -> 44.53,已回退。
- 知识复盘右侧 AI 摘要补齐编辑图标和内联保存:同时补齐真实草稿保存与时间线,当前保留;中间指标已被最新基线覆盖。
- 知识复盘路由背景从全局 `var(--bg)` 覆盖为 `#f8fafb`:最新基线为 18.69 / 44.14,当前保留。
- 知识复盘设置持久化:默认截图指标保持 18.93 / 44.59;交互态通过 smoke 覆盖保存、localStorage 校验和重新打开恢复,当前保留真实配置闭环。
- 知识复盘 footer 从范围文案切为设计总量口径:平均差异 18.93 / 44.59 -> 18.92 / 44.57;真实分页、页码、每页条数和搜索仍由实际数据驱动,当前保留。
- 知识复盘人工定稿候选:右侧摘要作为可编辑工作区定稿,底部三按钮保持当前功能优先级,中部表格保留真实分页;摘要栏宽度、行高、按钮 gap、padding、筛选图标、处理人头像锚点冻结为 no-go,除非有新的人工审美目标或业务可读性问题。
- 知识复盘表格处理人列增加 24px 首字头像锚点:平均差异 18.69 -> 18.76RMS 44.14 -> 44.23,头像锚点方向无收益/反向,已回退。
- 处理人详情顶栏头像增加发型层次:平均差异 18.41 -> 18.44,已回退。
- 处理详情页路由级文案映射:平均差异 18.41 -> 18.54,已回退。
- 处理人详情时间线竖线左移对齐圆点中心:平均差异 18.37 -> 18.38,已回退。
- 处理人详情时间线圆点继续压缩到 18px:与 19px 结果持平,平均差异 18.34、RMS 44.17;当前保留更稳妥的 19px。
- 处理人详情顶栏处理按钮水平 padding 从 12px 放到 16px:平均差异 18.34 -> 18.37RMS 44.17 -> 44.24,已回退。
- 处理人详情三栏比例改为 260px / 1fr / 390px:平均差异 18.22 -> 18.30RMS 43.82 -> 44.02,已回退到 250px / 1fr / 400px。
- 处理人详情顶栏通知/帮助/用户区 gap 从 14px 收到 12px:平均差异持平但 RMS 44.17 -> 44.18,已回退。
- 处理人详情顶栏动作按钮加宽:平均差异 18.22 -> 18.24RMS 43.82 -> 43.88,已回退。
- 处理人详情右侧主按钮背景从渐变改为纯色 `#078f7f`:平均差异 18.22 -> 18.30RMS 43.82 -> 43.85,主按钮背景方向无收益/反向,已回退。
- 处理人详情右栏 AI 建议 / 相似问题 / 下一步动作改为独立白色卡片:平均差异 18.22 -> 22.89RMS 43.82 -> 53.06,右栏独立卡片结构方向无收益/反向,已回退。
- 处理人评论工具不建议通过扩大工具栏、增加文字说明或重排评论区来展示能力,当前以 smoke 和交互截图证明附件 / 图片 / 链接功能闭环。
- 处理人详情人工定稿候选:当前三栏骨架、顶栏动作、时间线、评论工具、单一右栏分组结构、19px 时间线圆点、250px / 1fr / 400px 三栏比例和右侧主按钮渐变样式冻结为定稿基线;业务样例、头像、通知数字和静态文案差异作为可接受偏差备注。
- 知识复盘右侧摘要动作区 gap 从 9px 收到 8px:平均差异 18.69 -> 18.70RMS 44.14 -> 44.15gap 方向无收益/反向,已回退。
- 客户端侧栏业务标签整体映射:会拉高多个客户端页面差异,已回退。
- 调度端侧栏宽度全量改为 220px:中心调度台和问题池明显收益,但部门队列 19.44 -> 20.22、知识复盘 19.94 -> 21.49、提醒升级与规则配置也小幅反向;已缩小为中心调度台与问题池路由专用。
## 下一轮实施建议
1. 优先推进人工定稿记录:使用 `docs/design/review-index.html` 保存“通过 / 通过但备注 / 带目标返修”和备注,并导出定稿 JSON。
2. 对 5 张自动 diff 诊断页,只接受有明确审美目标、设计图依据和不触碰范围的改动;避免单独替换图标、头像或业务样例文案。
3. 每次只保留经过 `capture:pages` + `visual:diff` 证明正向,或经人工定稿记录明确接受的改动。
4. 保留功能验证闭环:视觉或交互改动后至少运行 `npm run build``npm test``npm run smoke:browser`
## 固定验证命令
```powershell
npm run capture:pages
npm run visual:diff
npm run build
npm test
npm run smoke:browser
```