dsh-token-stats
Global per-model token usage statistics for deepseek-harness (dsh web): background incremental scan over all session logs, Settings UI with multi-granularity trend charts and per-session anomaly groups.
安装
此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗
说明文档
阅读完整 README ↗dsh-token-stats
English | 中文
为 deepseek-harness (dsh) 补上缺失的全局 Token 用量看板 —— 一行安装,打开设置页即看:按模型、按时间、按会话的用量趋势与异常记录。
为什么需要它
dsh 自带的统计只覆盖当前会话:跨会话总消耗、每个模型各用了多少、哪天用得最凶、哪些会话出过错——这些全局视角在原版 UI 里是空白。本插件把这些全部补齐,并做对两件容易做错的事:
- 口径正确:子代理(subagent)的 token 与异常沿
parentSession链归并到其根主会话——会话数量只数主会话,子代理的消耗一个不漏地记在主人头上 - 零等待:后台常驻聚合(启动预热 → 每 60s 增量 → 每 10min 全量兜底),打开设置页永远是热数据,不用对着加载圈等扫描
安装
npx github:caiyfa/dsh-token-stats
重启 dsh,打开 设置 → Token 用量。完毕。
- 要求:dsh(Web profile)、Node ≥ 22
- 多 profile:
--profile=tui,web;全部:--profile=all - 卸载:
npx github:caiyfa/dsh-token-stats --uninstall - dsh 升级后如果设置页报插件加载失败,重跑一次安装命令即可修复链接
你会看到什么
| 区块 | 内容 |
|---|---|
| 汇总卡 | 输入(未缓存)/ 缓存读 / 缓存写 / 输出 / 其中推理 / 合计 / 模型调用数 |
| 按模型表 | 每个 provider / model 的主会话数、调用数、四桶 token 明细与合计 |
| Token 用量趋势 | 时间粒度(分钟·近24h / 小时·近7天 / 天·全程,超90天自动按周聚合)× 图表形态(柱状 / 四色堆叠构成——看缓存命中结构的变化 / 累计曲线——预算消耗视角)自由组合;纵轴等高刻度线 + 峰值标注,悬停看逐桶明细 |
| 异常时点 | 每个时段上方 绿点=正常 / 红点=该时段有失败轮次;点击红点直接定位涉及的主会话 |
| 各会话异常分组 | 按主会话折叠的异常列表(时间 + 错误消息),默认收起,不会被海量记录淹没 |
工作原理(30 秒版)
Host 侧是一个常驻后台服务:扫描全部会话日志,折叠每条 的提供方用量(按 分桶)与 错误记录,聚合成分钟/小时/天三档时间轴;Client 侧在设置页注册上述看板,经 dsh 的 网关读取快照。纯内存聚合,不落盘、不写会话日志、不向模型注入任何提示词。