Files

23 lines
1.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 使用统计 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` 或自动修复,也不扩大依赖变更。