@kelearns/dsh-token-usage
Token usage heatmap for the dsh web GUI: GitHub-style daily / weekly / cumulative token statistics with hover details, mounted via the official plugin mechanism (dsh plugin add) — no dsh source changes.
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:KeLearns/dsh-token-usage说明文档
阅读完整 README ↗@kelearns/dsh-token-usage
DeepSeek Harness（dsh）Web GUI 的 Token 用量热力图插件：GitHub 风格贡献图，
统计每日 / 每周 / 累计 token 用量，带汇总气泡、悬停详情与活动洞察。
通过官方插件机制（dsh plugin add）挂载，不修改 dsh 本体任何源码。
安装后在设置页侧边栏出现「Token 活动」入口。
功能
- 汇总气泡：单个圆角容器 + 竖线分割的 5 项统计（累计 / 峰值日 / 最长会话 / 当前连续 / 最长连续天数）；
- 三种视图：每日（按天分级取色）、每周（周总量 ÷ (最大周/7) 得格数，底部堆叠、统一最深色）、累计（截止各周累计 ÷ (总量/7) 得格数，最新列必满 7 格）；
- 窗口切换：近 3 / 6 / 12 个月（默认 6）；固定 12px 方格，12 个月横向滚动并自动滚到最新一周；
- 悬停详情：「M月D日 使用了 X 个 Token」/「当周使用了 X 个 Token」/「截至 X 当周累计使用 X 个 Token」；
- 活动洞察：最常使用的模型 / 推理强度 / 工具、最活跃时段、日均与月均用量、最常用的星期、最活跃的一天；按标签字数排序，两列等宽 + 连续中心分界线；
- i18n：中 / 英文，跟随文档语言实时切换；
- 主题：浅色 / 深色双色阶，跟随 DSH 应用主题；
- 自动刷新：每 60s 与回到前台时增量重扫变化中的会话文件；
- 跨平台：host 半端纯 Node 标准库（
fs/path/os/zlib），Windows / macOS / Linux 通用；浏览器半端与平台无关。
安装（官方机制）
需要 pnpm（确保在 PATH 中）：
npm install -g pnpm
从 npm 安装（推荐）：
dsh plugin --profile web add @kelearns/dsh-token-usage
本地开发安装（在仓库根目录执行，link:. 解析为当前目录）：
dsh plugin --profile web add link:.
卸载：
dsh plugin --profile web remove @kelearns/dsh-token-usage
安装器读取包内
cordis.patch.yml（dsh.bundle.patch清单字段）自动应用插件行， 无需手写 patch。重启 dsh web 后生效。
手动等价方式（无 CLI 时）
- 把包放入 profile 的 node_modules：
$DSH_HOME/profiles/web/node_modules/@kelearns/dsh-token-usage； - 在
$DSH_HOME/cordis.patch.yml追加以下块（幂等）：
- insert:
- id: dsh-token-usage
name: '@kelearns/dsh-token-usage'
- 重启 dsh web。
数据来源
$DSH_HOME/sessions///session.jsonl.zstd
（DSH 官方 JSONL 持久化：多个 zstd 帧首尾相连；首行 session 头，后续为事件流）。