@deepseek-ai/dsh-token-cost
DSH Web GUI 插件：按对话及汇总统计令牌使用量（输入/输出）、缓存命中/未命中和成本，并自动切换 DeepSeek 定价方案
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:le-soleil-se-couche/dsh-token-cost#a944b73c5e8b8c96ada84ecc9be9b533a740c9b7
Token Cost 以 @deepseek-ai/dsh-token-cost 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English · 中文
DeepSeek Harness（DSH）Web GUI 的 Token 用量 / 缓存命中 / 费用统计插件：单对话与整体汇总，内置 DeepSeek 双计价方案（东八区峰谷），也可为自己调用的其他模型填写单价。
2026-08-17更新：支持为自己调用的其他模型填写单价；点「添加模型」即写入本地价格文件，刷新后仍在，历史费用立刻按新单价重算。
2026-08-25 更新：计量内核升级为 attempt-aware fold，补齐失败调用后 retry、compaction/summary.usage 与 fork seedLength 边界；账本 schema 升至 v2，旧缓存会从权威 session logs 自动重折叠。
插件读取 DSH 的持久会话日志（$DSH_HOME/sessions/<cwd>/<session-id>/session.jsonl.zstd），把 provider 上报的 usage 事件折叠为按调用尝试的计费记录：同一次 attempt 内最终 message 替换 chunk 样本；失败 finish 会结算当前 attempt，让同一 turn/step 的 retry 另行累加；compaction/summary.usage 作为独立调用计入；聚合 fork 子会话时跳过 seq < seedLength 的继承前缀。紧凑账本（$DSH_HOME/storages/dsh-token-cost/ledger.json）缓存解析结果，只重解析变化的日志；计量语义升级会自动使旧账本失效并从 session logs 重折叠。自定义单价存在同目录的 custom-prices.json。zstd 解压使用 fzstd（纯 JS 零依赖）。
Token 字段遵循 Harness 约定：inputTokens = 缓存未命中部分，cacheReadTokens = 缓存命中部分（两者不相交，相加即计费输入）。
统计边界仍由上游日志决定：标题生成、Web Search、被中断调用或其他客户端若没有写出 usage，插件不会虚构 token 或费用。可公开复核的 synthetic fixture 与手算结果位于 tests/fixtures/usage-accounting/。
截至 2026-08-25，DSH 官方 master b150a551b8 的 tokenUsage projection 仍为 stateVersion: 1：它能去重同一次 attempt 的 chunk/message 样本，但尚未折叠 compaction/summary.usage，失败 attempt 后同一 (turn, step) 的 retry 仍会覆盖前一次 usage；跨 session 汇总也需要消费方自行排除 seq < seedLength 的继承前缀。
本插件已经覆盖这些边界，并用 ledger v2 自动使旧口径缓存失效。在“已写入 DSH session logs 的 usage 如何结算”这一明确范围内，本插件当前领先于官方 master；这不代表插件能替代官方账单，也不扩大上游没有记录 usage 的遥测边界。独立 synthetic conformance checker 的四个 bucket 已逐项通过，记录见 deepseek-harness Discussion #1886。
dsh plugin --profile web add github:le-soleil-se-couche/dsh-token-cost
重启 dsh web 后，在设置页展开「Web UI 插件」即可看到。历史会话日志在首次查询时自动回填。
| 键 | 类型 | 默认 | 说明 |
|---|---|---|---|
enabled | boolean | true | 总开关（状态行费用显示 + 汇总卡片） |
currency | 'cny' | 'usd' | 'cny' |
priceMode | 'auto' | 'scheme-a' | 'scheme-b' |
customPrices | string (JSON) | '' | 兼容旧设置项；现用配置页表单，落盘到 storages/dsh-token-cost/custom-prices.json |
以上均可在卡片的「配置」页编辑；「重新扫描会话日志」按钮强制全量重解析。
pnpm install && pnpm -r build
pnpm --filter @deepseek-ai/dsh-token-cost test
pnpm --filter @deepseek-ai/dsh-token-cost typecheck
架构说明见 DESIGN.md。