TokenLedger：DeepSeek Harness 的 Token 用量记账 DSH plugin

TokenLedger 是 DeepSeek Harness（DSH）的 Token 用量记账插件（DSH plugin），由 zh667 维护，采用 MIT 协议，专为 dsh web 图形界面设计。它解决的核心问题是：把每次请求的 Token 消耗准确归属到实际服务该请求的中转站，并且零配置、零凭据即可使用。插件从宿主的 provider 配置中自动发现中转站，按 baseURL 归一化分组，同一站的多把 key 合并显示，站名即域名。核心能力包括中转站归属、余额查询（支持 DeepSeek 官方、New API、Sub2API、Moonshot、智谱、OpenRouter 等）、三窗口用量分析（今日/本月/累计）、按站点/模型下钻、缓存命中率、一年活跃度热力图、费用估算（费率表、分桶计价、峰谷时段）、CSV/JSON 导出与诊断。插件只读回环端点，从不读取提示词、工具参数或响应内容，隐私安全有保障。

TokenLedger 这个 DSH plugin 支持哪些核心特性？

TokenLedger 提供中转站归属、余额、用量分析、费用估算、导出与诊断等能力。中转站归属按 provider 的 baseURL 归一化 origin 分组，同一站的多把 key 合成一行。余额查询支持 DeepSeek 官方、New API 系（含 One API、VoAPI）、Sub2API、Moonshot/Kimi、智谱 GLM/Z.ai、OpenRouter（需 Management Key），除 OpenRouter 外都只需普通 API key。用量分析提供今日/本月/累计三窗口、按站点/模型下钻、缓存命中率、一年活跃度热力图。费用估算支持生效日期分段的费率表、分桶计价、峰谷时段，未定价的模型显示破折号。导出支持 CSV/JSON，诊断功能包括索引健康度和归因不上的行数。

TokenLedger 怎么安装？

需要 DeepSeek Harness web profile（@deepseek-ai/dsh >= 0.1.0-rc.6）。安装命令如下：

dsh plugin --profile web add github:zh667/tokenledger

重启正在运行的 dsh web，浏览器硬刷新，侧边栏底部会出现「用量账本」入口。升级或卸载：

dsh plugin --profile web update dsh-tokenledger
dsh plugin --profile web remove dsh-tokenledger

装完即可用，无需任何配置或凭据。

TokenLedger 的命令行用法有哪些？

面板能回答的问题，命令行都能回答，两边读同一批查询。常用命令：

/tokenledger                      # 全部时间
/tokenledger 7                    # 最近 7 天
/tokenledger 30 api.example.com   # 某个中转站，最近 30 天
/tokenledger site                 # 列出发现到的中转站
/tokenledger site add <路由名> <地址>
/tokenledger site rm <路由名>
/tokenledger export csv 30        # 导出
/tokenledger diagnostics          # 索引健康度
/tokenledger reindex              # 丢弃索引，从头重建

TokenLedger 支持哪些账户类型和上游接口？

支持 DeepSeek 官方（/user/balance）、New API 系（/api/usage/token/ + /api/status）、Sub2API（/v1/usage）、Moonshot/Kimi（/v1/users/me/balance）、智谱 GLM/Z.ai（/api/paas/v4/balance）、OpenRouter（/api/v1/credits，需 Management Key）。中转站跑的程序由路由指纹自动判定，厂商域名无需探测。New API 的额度按 key 计算，同一站两把 key 是两份额度。

TokenLedger 需要配置吗？

通常不需要任何配置，中转站从宿主的 provider 设置中读取。需要覆盖时，可在 settings.yaml 中配置 relays、rates、fingerprint 等选项，改完热更新，无需重启。

TokenLedger 如何保证正确性与数据口径？

插件处理了三个容易出错的折叠场景：请求失败后仍扣费（从 assistant/chunk 的 usage 流出）、同一 (turn, step) 被报告两次（替换而非累加）、孤儿 usage chunk 不带身份（回退到最近一次 request/header）。口径上 inputTokens、cacheReadTokens、cacheWriteTokens 三桶互斥，reasoningTokens 是 outputTokens 的子集。天按宿主进程本地时间切分，归属在折叠时写死，历史永不重写。

TokenLedger 的隐私与安全如何？

插件从不读取内容，只有计数和标识符。两个端点仅接受回环 GET，且在 peer socket 地址上设防。从不读取提示词、工具参数或响应内容，不会把 API Key 或上游原始响应发送到浏览器。

查看更多 DSH 插件，访问 dsh-plugin.org