52 lines
2.9 KiB
Markdown
52 lines
2.9 KiB
Markdown
# 使用统计 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
|