好几家模型中转站的账对不上,TokenLedger 按站点和项目记清用量
同时用几个模型中转站、按项目跑多个会话的人,月底对账是个谜:钱花在哪个站、哪个项目烧掉的,全靠感觉拼凑。TokenLedger 是开发者 zh667 出品的 DeepSeek Harness(DSH)用量记账插件,核心思路是把 token 用量归属到实际服务这次请求的中转站、以及会话启动时所在的项目目录——零配置、零凭据,装上就能看全部账目。MIT 开源,SkillHub 插件广场在架,星标二百。
它能做什么
- 中转站归属:按接口地址归一化分组,同一个站的多把 key 合成一行,站名就是域名本身,不是你自己起的路由别名
- 项目归属:用量按会话启动时所在的目录分组,工作区注册过的用标题、没注册的用目录名,子目录里起的会话照样算进去
- 零配置发现:从宿主的路由配置里自动读出中转站,只读地址、不碰旁边的凭据;查余额用的也是你早就配好的那把 key
- 账户类型覆盖广:DeepSeek 官方、New API 系、Sub2API、Moonshot、智谱、OpenRouter 等;不限额度的 key 显示「已用」而不是编一个假余额
- 订阅滚动窗口:按套餐计费的账户,5 小时、每周、每月各自一条进度条加一个重置时刻,金额与窗口可以并存
- 用量分析:今日、本月、累计三个窗口,按站点和模型下钻,缓存命中率、一年活跃度热力图都有
- 费用估算有原则:费率表按生效日期分段,支持分桶计价与峰谷时段;没配价格的模型显示破折号,不瞎猜
- 导出与诊断:CSV、JSON 两种导出,索引健康度检查,归因不上的行数单独列出不藏
- 只读安全:查询端点仅接受本机回环访问,从不读取提示词、工具参数或响应内容
怎么获取
需要 DSH 的 web profile,一条命令:dsh plugin --profile web add github:zh667/TokenLedger,重启 dsh web 并硬刷新浏览器,侧边栏底部出现「用量账本」入口。想钉住某个版本要注意:包管理器只认完整的 40 位提交哈希,短哈希会直接解析失败。
上手怎么用
- 装完先看总账:面板默认全时段,命令行
/tokenledger 7看近 7 天,站点维度先扫一眼哪家用量异常 - 按项目对账:养成从项目目录里起会话的习惯,月底按目录分组导出 CSV,内部核算与客户报价直接有据
- 订阅套餐盯窗口:5 小时窗口快见底就先歇手,看着进度条安排任务,比撞上限后反复报错体面
- 疑难先跑诊断:中转站不显示、归因对不上,
/tokenledger diagnostics会直接告诉你路由归属和索引状态,不用猜 - 费率表分段维护:模型调价就按生效日期加一段,历史账自动按旧价计算,报表不失真
适合谁用
多中转站、多项目并行重度使用 DSH 的开发者和团队;要向客户或内部报 AI 成本、需要按项目粒度出账的乙方。把用量记到「哪个站、哪个项目、哪个模型」的粒度,预算谈判才有底气;记账这件事越早开始,历史数据越值钱。零 CTA。