dsh-usage-ledger ( Token费用统计 )

中文 | English

DeepSeek Harness 的 Token / 用量统计与成本控制插件：按对话聚合消耗、动态跟随官方定价、支持预算拦截，并内置 Web 仪表盘。

功能特性

• 按会话统计：监听 session/event，把每次 assistant/message 的 usage（输入 / 输出 / 缓存读写 Token）折算为费用，按会话、按北京日、按生命周期三个维度聚合，并持久化到账本文件。
• 动态官方定价：定期抓取官方定价页，自动解析并热更新价格，官方调价 / 上新模型时无需改代码即可生效。
• DeepSeek 峰谷分时：识别官方「高峰 / 空闲」时段表与生效日期，按调用发生的北京时间实时取价。
• 多厂商价格目录：覆盖 DeepSeek、智谱 GLM、月之暗面 Kimi、阿里通义、字节豆包、MiniMax、百度文心等主流国产模型，新模型上线官方定价页后自动导入。
• 预算控制：支持日 / 总 / 单会话三级预算，达到阈值进入告警，超限可通过 llm/stream 钩子直接拦截模型调用。
• Web 仪表盘：通过 dsh-host-webserver 注册 /usage-ledger 路由，提供用量可视化与 JSON API。
• 用户覆盖价：customPrices 设置可为任意模型（含自定义模型）覆盖或补充价格，优先级最高。

安装

将本仓库放入 DeepSeek Harness 的插件目录（或通过包管理器安装），Harness 会依据 dsh.plugin.json 与 cordis.patch.yml 自动加载。

git clone https://github.com/beijingwahw/dsh-usage-ledger.git
cd dsh-usage-ledger
pnpm install
pnpm run build

配置

在 Harness 的 cordis.yml 中挂载并配置：

- name: dsh-usage-ledger
  config:
    ledgerPath: ''            # 留空则使用 $DSH_HOME/usage-ledger.json
    saveIntervalMs: 5000      # 账本落盘防抖
    pricingTimeoutMs: 10000   # 单次定价抓取超时

usage-ledger 命名空间的用户设置（可在运行时热更新）：

设置	默认	说明
dailyBudget	0	日预算（元），0 关闭
totalBudget	0	总预算（元），0 关闭
sessionBudget	0	单会话预算（元），0 关闭
warnRatio	0.8	进入告警的预算占比