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 侧是一个常驻后台服务：扫描全部会话日志，折叠每条 assistant/message 的提供方用量（按 provider/model 分桶）与 turn/end 错误记录，聚合成分钟/小时/天三档时间轴；Client 侧在设置页注册上述看板，经 dsh 的 /api 网关读取快照。纯内存聚合，不落盘、不写会话日志、不向模型注入任何提示词。

安装器做三件事：把包部署到 ~/.dsh；把 dsh 自身运行时的 @deepseek-ai/cordis、@deepseek-ai/dsh-typert-protocol 链接（junction/symlink，绝不复制——Remote 标记靠模块内 WeakMap 生效，必须与 dsh 共享同一物理模块实例）进插件解析路径；以带标记的幂等块写入 profile 的 cordis.patch.yml。

排障

现象	处理
Failed to load plugins ... dsh-token-stats	重跑安装器；仍失败则 DSH_MODULES_DIR=<dsh的node_modules> npx github:caiyfa/dsh-token-stats
区块在但数据空白	看 dsh 进程日志中 token-stats: 报错
invocation-unavailable: tokenStats/snapshot	peer 被复制成了真实目录：删掉后重跑安装器

License

MIT