cc-web/.planning/usage-statistics-reference-refit/task_plan.md

使用统计看板产品化优化计划

目标

在不改变统计协议、统计口径和现有聊天功能的前提下，以用户原型提供的信息架构为基础，将使用统计看板优化为符合 cc-web 产品语言的运营工作台，并保持全部现有主题和响应式视口可用。

完成标准

• 桌面端信息架构对齐原型：顶部标题与筛选、五张指标卡、左趋势右 MCP 明细、左状态右 Skill 排行、底部最近会话。
• 使用现有真实统计数据，不伪造组织、用户、时长或人工/自动消息等当前协议未提供的数据。
• 保留本周、本月、自定义日期、MCP 明细、会话跳转、加载/空态/错误态。
• 11 个现有主题均通过语义变量适配；浅色主题贴近原型，深色主题保持相同布局层级。
• 参考视口、常规桌面、平板和手机通过真实浏览器检查。
• 不修改聊天消息 DOM、生成状态、草稿、附件和会话 JSON。

阶段

1. [complete] 建立代码基线并归档参考原型
2. [complete] 量化原型并映射现有 DOM 与数据
3. [complete] 重构看板 DOM 与渲染结构
4. [complete] 实现原型版式与主题视觉
5. [complete] 适配交互状态与响应式布局
6. [complete] 补充统计看板回归契约
7. [complete] 执行自动化与真实浏览器验收
8. [complete] 检查运行会话并安全更新预览
9. [complete] 固化产品化优化原则与改动边界
10. [complete] 精简统计看板信息架构与文案
11. [complete] 将 MCP 明细重构为侧边抽屉
12. [complete] 重做桌面端去卡片化视觉层级
13. [complete] 优化手机端指标带与响应式布局
14. [complete] 更新回归契约与静态资源版本
15. [complete] 执行多主题多视口视觉验收
16. [complete] 执行专项全量回归与在线确认

决策

• 这是现有功能页返工，不新增主题 ID。
• 原型图只作为构图证据并归档，不作为产品运行时资产。
• 当前数据协议没有的数据不伪造；对应区域用现有指标重新表达。
• 遵照用户要求，不派额外审计代理。
• 原型约束信息结构，不逐像素复刻；具体密度、层级和交互按 cc-web 真实使用场景优化。
• 顶部五项指标改为连续指标带，主色只承担选中、关键走势和状态表达，避免五种颜色同时争抢注意力。
• MCP 调用明细改为看板内侧边抽屉，保持上下文，不再滚动跳转到页面中部。
• 移动端优先保证首屏判断效率，指标采用紧凑横向浏览，不做五张纵向大卡堆叠。

错误记录

错误	尝试	处理
归档脚本拼接 Markdown 反引号触发 JavaScript SyntaxError	1	改为无嵌套反引号的补丁文本，命令未执行且源文件未变
错误日志补丁使用了未展开的时间变量，未匹配原文	2	读取实际文本后改用稳定上下文补丁
进度补丁使用新时间匹配旧时间，未命中原文	1	后续进度追加只使用稳定标题或固定文本作为上下文
阶段状态补丁连续使用错误旧时间	3	停止猜测，先读取计划尾部再用精确文本同步
环境没有 ImageMagick identify	1	改用 file 与 stat 读取 PNG 尺寸、通道和大小
usage-statistics 回归把初始化事件断言放进渲染函数切片	1	将自定义日期事件断言改为检查完整 frontendSource
视觉脚本在初始查询 loading 时点击 disabled 的应用按钮	1	先等待初始查询离开 loading，再设置自定义日期并应用
等待初始查询后自定义结果仍未满足非零条件	2	增加页面诊断快照，先获取状态/错误/日期/指标再决定修复
自定义查询紧跟默认查询触发 250ms 频率限制	3	根据服务端阈值在视觉脚本中等待 320ms 后提交
在线 JS 检查使用 rg -m1 提前关闭管道导致 curl 报 23	1	改为让 rg 消费完整响应，复检命中且退出码为 0

状态

• 当前：产品化优化已完成
• 更新时间：2026-08-03T21:08:00+08:00