前言¶
DeepSeek Harness（DSH）的 durable session log 里记着每次调用的 provider 计费用量，但没有任何页面把它摊开：用了多少、花在哪、什么时候用的，都看不见。更麻烦的是，会话投影每个会话只保留最近 600 行，会话一长或被删，早期用量就从界面上消失了——数字变小，但数据从来没丢，只是没人再去读它。
menglian001/dsh-token-usage 把这份权威数据折成一张请求日志，并额外落一份盘上账本，不受投影窗口限制，启动时还会从全部会话日志回扫补齐。
功能概览¶
插件为 DSH Web GUI 提供一个 Token 用量面板，包含以下视图：
- 概览：四张主指标卡（请求数、合计 tokens、缓存命中率、输出速度）。「更多指标」展开四桶明细、平均耗时、平均首字。趋势图按桶堆叠，与同一 x 轴上的缓存命中率折线读同一数据源与窗口，方便对比。全年热力图 53 周 × 7 天，月/周标签齐全。渠道排行显示占比、四色构成条、请求数、命中率、合计。标题下方显示今日读数（不随筛选变化）与实时并发。
- 请求日志：12 列逐请求明细（时间/会话/渠道/模型/提示/缓存读/补全/合计/耗时/首字/速度/流式），按天分组，粘性日期条与表头随滚动钉住。点任意一行展开四桶明细（含缓存写、推理子集、轮次与步骤）。点会话名直接跳到对应对话。支持按时间范围、渠道、模型、全文搜索筛选，支持暂停冻结表格（顶部数字照常更新），列头可排序、CSV 导出、页码直达。
- 分组视图：模型、渠道、日期三张表共用一套列（占比带条、请求、提示、缓存读、补全、合计带四色构成条、命中率、平均耗时、速度）。
- 实时并发：标题下的活体指示
● 运行中 N，数据来自会话列表自带的running标志，由 Host 推送而非轮询。一个会话里同时有多个调用在飞时，追加· M 步在飞：Host 按step/start→ 结算事件计数，turn/end清空。会话的running是布尔值，无法表达一段对话里有几个调用在跑，这个计数可以补充。
安装与启用¶
插件是一个普通的 DSH bundle，纯 JS，无构建步骤。
git clone https://github.com/menglian001/dsh-token-usage.git ~/dsh-token-usage
# 1) 装插件自己的依赖（必做，见下）
cd ~/dsh-token-usage && npm install
# 2) 在 profile 里登记，然后安装
cd ~/.dsh/profiles/web
pnpm install
profile 的 package.json 需要这两处：
{
"dependencies": {
"dsh-token-usage": "link:~/dsh-token-usage"
},
"dsh": {
"profile": {
"bundles": ["...", "dsh-token-usage"]
}
}
}
然后重启 dsh。
为什么第 1 步必做
link:包按真实目录解析依赖，不经过 profile 的node_modules。插件目录里没有node_modules/zod时，Host 半会以Cannot find package 'zod'加载失败——而 Host 半失败会连带 Client 半不注入，表现是侧边栏根本没有这个图标。npm install只装一个zod，几秒钟。Host 半改动需要重启才生效；Client 半热更新，刷新页面即可。
数据来源与落盘账本¶
| 数字 | 来源 |
|---|---|
| 四桶（未命中输入 / 缓存读 / 缓存写 / 补全）与推理 | provider 回包上报 |
| 提示 / 补全 / 合计 / 缓存命中率 | 四桶的算术 |
| 耗时 / 首字 / 生成时间 | 本地时钟，含网络往返 |
| 输出速度 | 补全 ÷ 生成时间，池化；仅计入补全 ≥ 100 且生成 ≥ 100 ms 的请求 |
链路：provider 响应 → stream.ts 的 usage 事件 → assembler → assistant/message.data.usage → 本插件的 requestLog 投影。
走中转时，「准确」的含义是忠实反映中转上报的数字；中转少报，面板就跟着少报。
每次请求结算时追加一行 JSONL 到 $DSH_HOME/token-usage/requests.jsonl：
- 键：
session|turn|step|attempt，读时后写覆盖。崩溃重放、重复回扫都不会重复计数。 - 回扫：启动后读遍磁盘上的全部会话日志，把投影窗口早已丢掉的行补回来。
- 保留 730 天。
- 压实：启动时若文件 ≤ 32 MB 且（总行数 ≥ 2000 且 总行数 > 唯一键数 × 1.25，即重复行占比 > 20%；或存在超 730 天的记录）则压实（写临时文件再 rename）。超过 32 MB 的文件只读、不再压实。
数据有两条来源，页脚会说明当前用的是哪条：
- 账本：保留窗口内只增不减，但只有聚合（天/模型/渠道）与最近若干行明细（服务端留 2000 行，面板按需取 400 行）。
- 保留记录：浏览器手里的投影行，能按任意条件切片，但受每会话 600 行窗口约束。
切换规则只看完整性：账本尝试数 ≥ 保留行数，且无筛选时读账本。天数跨度不参与判断——图表的天数下限是画图用的，不能拿来仲裁数据源。
已知边界¶
- 缓存写 / 推理恒为 0：上游若为 OpenAI 口径（prompt 里已含缓存命中），不会单独上报
cache_creation/reasoning。显示 0 是没报，不是漏读。 - 速度显示
—：中转把首字和落盘报在同一瞬间时，生成时间≈0，除出来的速度是假的，因此按门槛显示—。—表示「没测到」，不是 0。 - 请求日志明细受投影窗口约束：明细仍读投影（每会话 600 行）；分组视图与趋势在无筛选时读账本聚合，不会缩水。
- 热力图空格 = 那天没有记录，不是「那天没用」。
- 账本从启用那天开始记：更早且日志已被清理的会话，总数可能补回，明细补不回来。
适用场景与注意¶
适合需要长期追踪 Token 用量、关注缓存命中率与渠道成本分摊的 DSH 用户。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
结尾¶
本插件为 DSH Web GUI 提供了持久化、可筛选、可导出的 Token 用量面板，帮助在会话投影窗口之外看清用量全貌。
- 目录页：https://www.skillhub.cn/plugins/menglian001/dsh-token-usage
- GitHub：https://github.com/menglian001/dsh-token-usage
