cc-web/.planning/usage-statistics-echarts/task_plan.md

使用统计 ECharts 迁移计划

目标

将使用统计看板的五项微趋势、主趋势和三项环图统一迁移到本地 ECharts 运行时，保留现有真实统计协议、产品化布局、11 个主题与响应式交互。

完成标准

• 页面从本地静态资源加载固定版本 ECharts，不依赖 CDN。
• 五项 KPI 微趋势、主趋势混合图和三个状态环图全部由 ECharts 渲染。
• 主趋势支持 tooltip 和图例显隐；微趋势、环图保持克制，不增加无关控件。
• 主题切换、看板打开、容器 resize 与移动端断点后图表尺寸和颜色正确。
• 不改变统计协议、数据字段、MCP Top 6、明细抽屉、最近会话和聊天状态。
• 统计专项、相关主题专项、全量回归和真实浏览器视觉验收通过。

阶段

1. [complete] 固化 ECharts 迁移边界与视觉原则
2. [complete] 引入本地 ECharts 运行时并接入页面
3. [complete] 迁移五项指标微趋势图
4. [complete] 迁移主使用趋势图
5. [complete] 迁移三项状态环图
6. [complete] 补齐主题同步与响应式生命周期
7. [complete] 移除 Skill 展示并接入项目统计
8. [complete] 更新回归契约与真实浏览器验收
9. [complete] 执行专项全量回归与在线确认
10. [complete] 重新构建并验证 CentOS 7 baseline 发布包
11. [complete] 提交并推送全部修改

决策

• 视觉论点：ECharts 只替换图表几何和交互能力，继续服从 cc-web 当前低装饰、单强调色的运营工作台语言。
• 内容计划：顶部保留五项微趋势，中部保留一张主趋势，状态区保留三项真实构成；不增加协议不存在的字段。
• 交互论点：主图提供 tooltip 与可切换图例；所有图表随主题和容器尺寸更新；动画遵守 reduced-motion。
• 采用本地固定版本 UMD bundle，由 index.html 在 app.js 前加载，单文件发布自动携带 public 静态资源。
• 按用户此前要求不派审计代理。
• 用户确认 Skill 统计缺乏参考性；后端保留原字段兼容既有协议，前端所有 Skill 展示统一替换为真实项目聚合。

错误记录

错误	尝试	处理
预期的 node_modules/echarts/LICENSE.txt 不存在	1	查找包内许可文件后使用实际的 LICENSE 与 NOTICE，同时归档到 public/vendor
index 脚本补丁上下文遗漏了 Mermaid 引用	1	读取实际尾部脚本顺序后使用完整稳定上下文重新接入
rg 检查模式以 --usage-donut 开头被解析为参数	1	使用 -- 终止参数解析后复检，确认旧 donut 实现无残留
首轮 ECharts 浏览器验收停在页面 complete 信号	1	已补导航诊断并延长加载窗口；因项目统计需求到达，主动终止旧版验收，待新版 UI 后重跑

状态

• 当前：全部完成
• 更新时间：2026-08-04T00:50:00+08:00