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

使用统计 ECharts 迁移发现

基线

• codebase-memory 项目 home-cc-web 索引 ready：4,817 节点、10,212 条边。
• 图表入口集中在 renderUsageSparklines、renderUsageTrend、renderUsageMcpStatus，总入口仍是 renderUsageDashboard。
• 当前图表分别使用手写 SVG path/rect 与 CSS conic-gradient；统计数据已经完整，迁移不需要修改后端。
• cc-web 没有前端打包流水线，页面直接加载 public 静态资源，因此 ECharts 应以本地 UMD bundle 接入。
• 当前工作树已有同一看板未提交修改，迁移必须在这些改动上增量实施，不还原或格式化无关区域。

设计约束

• 不使用 ECharts 默认主题色板，颜色全部读取使用统计语义 CSS 变量。
• 微趋势不展示坐标轴、图例和 tooltip chrome；主趋势才承担探索交互。
• 环图继续使用现有 DOM 图例，ECharts 只负责可访问图形与 tooltip，避免信息重复。
• reduced-motion 下关闭图表更新动画。

运行时接入

• 固定使用 echarts@5.6.0，通过单次 proxyd registry 安装，没有修改项目或用户 npm registry 配置。
• 浏览器运行时位于 public/vendor/echarts.min.js，Apache 2.0 LICENSE 与 NOTICE 同目录保留。
• npm 安装报告 2 个依赖树漏洞提示；遵照用户此前“不要审计”的要求，本轮不执行 npm audit 或自动修复，也不扩大依赖变更。