# 使用统计 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