feat: add project usage analytics with ECharts

This commit is contained in:
shiyue
2026-08-04 00:49:52 +08:00
parent 58d5f816c2
commit c61b7434d2
39 changed files with 5040 additions and 283 deletions

View File

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