zh667/TokenLedger
123最近提交 2026年8月15日
TokenLedger DSH 插件
TokenLedger 精确统计 DeepSeek Harness Web GUI 的 Token 用量，并将每次请求归属到实际服务的中转站。它自动从宿主的 provider 配置中发现中转站，无需手动设置。插件提供面板和命令行两种方式，支持用量查询、余额查看、成本估算和诊断功能。
如何安装 TokenLedger DSH 插件
dsh plugin --profile web add "github:zh667/TokenLedger复制不会执行命令。安装 TokenLedger DSH 插件前请核对仓库和版本。
TokenLedger DSH 插件数据来源
TokenLedger DSH 插件快照日期：2026年8月16日
discovered
TokenLedger DSH 插件能做什么
- 按中转站 origin 归属 Token 用量（同一站的多把 key 合并为一行）
- 零配置自动发现中转站（从宿主 provider 的 baseURL 读取）
- 余额查询：支持 DeepSeek 官方、New API 系、Sub2API、Moonshot、Kimi、智谱 GLM、Z.ai、OpenRouter
- 用量分析：今日/本月/累计三窗口、按站点/模型下钻、缓存命中率、一年活跃度热力图
- 费用估算：支持生效日期分段的费率表、分桶计价、峰谷时段
- CSV/JSON 导出、索引健康度诊断、归因不明行数单独列出
TokenLedger DSH 插件适合哪些场景
- 在同一个 Harness 实例中追踪多个中转站的 Token 用量和费用
- 识别哪个中转站消耗了最多 Token 以及相关成本
- 诊断由于失败请求或孤儿 chunk 导致的归因问题
- 导出用量数据用于对账或审计
- 在不离开 Harness 面板的情况下监控多个账户的余额
TokenLedger DSH 插件适合谁
- 使用 DeepSeek Harness Web GUI 并管理多个中转站的用户
- 需要按中转站或模型分摊成本的系统管理员
- 希望通过库 API 将 Token 核算集成到自定义工作流的开发者
TokenLedger DSH 插件的限制
- 仅支持 DeepSeek Harness 的 `web` profile（需要 `dsh >= 0.1.0-rc.6`）
- OpenRouter 的余额查询需要使用 Management Key，而非普通推理 key
- New API 的额度按 key 独立，同一站的不同 key 显示为不同账户
- 费用估算的费率表需要手动配置；未配置的模型显示为破折号而非 0
TokenLedger DSH 插件的仓库 README 摘录
以下文字摘自 TokenLedger DSH 插件的上游仓库 zh667/TokenLedger 的 README，版权归原作者，仅作引用。
把 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 Token 用量算清楚，并归属到**实际服务这次请求的中转站**——不用配置，不用凭据。 Token-usage accounting for the DeepSeek Harness Web GUI (`dsh web`), attributed to the relay site that served each request. Zero configuration.  > 展示图使用演示数据与本机模拟中转站；面板上的每个数字都由真实代码路径算出，只是数据是造的。插件不会把 API Key 或上游原始响应发送到浏览器。 ## 一眼看懂 / At a glance | | 能力 | 说明 | | --- | --- | --- | | 🎯 | **中转站归属** | 按 provider 的 `baseURL` 归一化 origin 分组——同一站的多把 key 合成一行，站名就是域名，不是你自己起的路由别名 | | 🔍 | **零配置发现** | 从宿主的 provider 配置里读出中转站，不用你再填一遍。只读 `baseURL`，绝不碰旁边的凭据 | | 💳 | **余额** | DeepSeek 官方、New API、Sub2API，每个账户一把普通 key 即可；不限额度的 key 报"已用"而不是假余额 | | 📊 | **用量分析** | 今日/本月/累计三窗口、按站点/模型下钻、缓存命中率、一年活跃度热力图（悬停看当天模型构成） | | 🧮 | **费用估算** | 生效日期分段的费率表、分桶计价、峰谷时段；未定价的模型显示破折号而不是 0 | | 🗂 | **导出与诊断** | CSV / JSON 导出，索引健康度，归因不上的行数单独列出 | | 🔒 | **只读回环** | 两个端点仅接受回环 GET，且在 peer socket 地址上设防；从不读取提示词、工具参数或响应内容 | ## 快速安装 / Quick start 需要 DeepSeek Harness `web` profile（`@deepseek-ai/dsh >= 0.1.0-rc.6`）。 ```bash dsh plugin --profile web add "github:zh667/TokenLedger" ``` 重启已经在跑的 `dsh web`，浏览器硬刷新。侧边栏底部会出现「用量账本」入口。 升级或卸载： ```bash dsh plugin --profile web update dsh
阅读完整 README仓库许可: MIT
TokenLedger DSH 插件常见问题
如何安装 TokenLedger？
在终端中执行 `dsh plugin --profile web add "github:zh667/TokenLedger"`。确保已安装 DeepSeek Harness 的 `web` profile（需要 `@deepseek-ai/dsh >= 0.1.0-rc.6`）。然后重启正在运行的 `dsh web` 进程，并在浏览器中硬刷新。侧边栏底部会出现「用量账本」入口。
安装后需要配置什么吗？
不需要，TokenLedger 开箱即用，零配置。它会自动从宿主 provider 设置中发现中转站。唯一的例外是 OpenRouter 的余额查询需要 Management Key（而非普通推理 key）。如果你需要覆盖自动发现或添加自定义费率表，可以编辑 `settings.yaml` 文件。
支持哪些中转站和提供商的余额查询？
TokenLedger 支持 DeepSeek 官方、New API（及其分支如 One API、VoAPI）、Sub2API、Moonshot/Kimi、智谱 GLM/Z.ai 以及 OpenRouter 的余额查询。大多数提供商仅需普通 API key；OpenRouter 需要 Management Key。提供商类型根据 baseURL 指纹自动检测。
TokenLedger 如何处理失败请求但仍消耗 Token 的情况？
TokenLedger 能够正确计入即使请求失败也已消耗的 Token。它通过跟踪 `assistant/chunk` 事件（包含用量数据）确保如果请求在报告用量后失败，Token 仍然被归属。这避免了系统性地少算用量。
如何导出 TokenLedger 的用量数据？
可以使用命令 `/tokenledger export csv <天数>` 或 `/tokenledger export json <天数>` 导出 CSV 或 JSON 格式的用量数据。导出包含指定时间段内的所有用量数据。此外，还可以通过 `/tokenledger diagnostics` 运行诊断，以及通过 `/tokenledger reindex` 重建索引。