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

17 KiB
Raw Permalink Blame History

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 buildnpm testnpm run smoke:browser

固定验证命令

npm run capture:pages
npm run visual:diff
npm run build
npm test
npm run smoke:browser