dsh-token-usage-dashboard — Token 用量统计（Codex 风格）

English | 简体中文

为 DeepSeek Harness（dsh）Web UI 提供 Codex 个人主页风格的 Token 用量统计仪表盘：5 统计卡 + GitHub 风格热力图（每日/每周）+ 洞察 + 模型用量排名。界面跟随 DSH 语言设置：中文环境显示中文仪表盘，其他语言显示英文仪表盘。

✨ 功能

• 5 统计卡：累计 Token 数 / 峰值 Token 数（单日）/ 最长聊天时长 / 当前连续天数 / 最长连续天数；数值字号自适应单行
• 热力图：53 列 × 7 行滚动视图（今天恒在最右下角），悬停显示「2026年8月15日消耗了 xx Token · N 次请求」； 「每日 / 每周」视图切换（每周为自下而上填充的 7 格柱状条，悬停显示周用量）
• 洞察：聊天总数、LLM 请求数、会话总数、活跃天数、缓存命中率、平均每轮 Token/时长
• 最喜欢的模型：供应商-模型（provider/model）Token 用量排名 Top5 + 比例条
• 数据源：全部会话日志（assistant/message 的 data.usage + request/header 的模型归属 + turn/start/turn/end 时长），实时增量更新；快照持久化 + 增量同步，重启后快速恢复
• i18n：跟随 DSH 语言（locale.getLocale().active），zh → 中文 / 其他 → 英文，切换即时生效

🏗️ 架构说明

插件有两种运行形态，共用同一套聚合逻辑：

• Bundle 形态（推荐给最终用户）：通过 dsh plugin add 安装；npm 包内含 lib/index.js（Host 半）和 lib/client.js（Client 半）。Host 通过 webServer 注册 GET /api/token-stats 与 POST /api/token-stats/rescan；Client 注册「设置 → 统计」页面并从 API 拉取数据。
• 动态插件形态（维护者迭代用）：将 host.js / client.js 粘贴到 cordis_define，可在不重启 profile 的情况下会话内部署。

数据流：

1. Host 订阅 session/event / session/created，并先对历史会话日志做一次回补。
2. 将 assistant/message.usage、request/header 模型归属、/ 时长折叠为内存聚合。