费用账单 Jannchie/dsh-bill

dsh-bill

DSH(DeepSeek Harness)的费用统计插件。每轮对话下面看这轮花了多少,会话的「费用」标签页看这个会话的钱花在了什么上,侧边栏「插件」旁的全局「费用统计」面板看整个账户。

回复下方是这轮的成本,输入框下方是本会话的费用

费用统计面板:总费用、Token、缓存命中、账户余额与月度预测

按模型堆叠的费用趋势,悬停看每根柱子的拆分;下方是周 × 小时热力图

成本归因:钱按内容类型花在了哪里

安装

dsh plugin --profile web add dsh-bill

重启 dsh web 生效。

功能

- 成本归因 —— 按内容类型拆分账单:工具输出、模型输出、系统提示词、终端命令(按 git / pnpm / rg 分组)、工具输入、附件、系统提醒、用户输入。旭日图可下钻。
- 每轮成本 —— 每个结束的轮次下面一行:这轮花了多少、几步、缓存命中率。数据来自会话日志本身,所以安装前的历史也有。插件在会话之外自行发起的调用(例如工具调用前的自动审查)不属于任何一轮:它计入账户总额,并在按会话拆分里单独显示为「无会话」一行,所以各轮费用加起来可能小于账户总额。
- 常驻显示 —— 输入框下方统计栏里以胶囊显示本会话费用;侧边栏显示今日花费与预算进度;鼠标停在侧边栏会话上,卡片里显示该会话的费用(DSH 0.1.7+)。胶囊的数字在轮次进行中就会随已流出的输出走动,provider 一报出用量即换成真实计费值。这五处界面,连同侧边栏面板行里的报告入口图标,都可在设置里逐项关闭。
- 报告 —— 每个会话的「费用」标签页(与 Chat / Trajectory 并列)只统计本会话;侧边栏「插件」旁的图标打开全账户的「费用统计」面板(DSH 0.1.7+)。都有总费用、Token、缓存命中、高峰占比;全局面板另有月度预测、账户余额、预算与按会话拆分;按模型 / 用途(含上下文压缩等循环开销)拆分;按模型堆叠的费用趋势,悬停看每根柱子的拆分;周 × 小时热力图。时间范围分滚动窗口(最近 24 小时、7 / 30 / 90 / 365 天)与按宿主时钟的自然日(今天、昨天),另有全部时间;一天以内按小时画柱,范围越长依次按天、周、月。
- 预算 —— 日 / 月 / 累计额度,超 80% 变黄,超支变红。
- 多币种 —— 实时汇率,约 166 种货币;各模型基础单价按其官方定价货币显示。
- agent 工具 —— bill_stats,模型可直接回答花费相关的问题,可按往前若干天或某个自然日(today、yesterday、YYYY-MM-DD)查询。插件配置里 agentTool: false 则不注册它 —— 适合从不在会话里问花费、也不想每次请求都为它的 schema 付费的人。
- 中英文跟随 DSH 语言设置;安装前的历史可从会话日志回填。

与同类插件的差异

三处实质差异:

不用手编价格。 其余插件都内置 2–4 个 DeepSeek 型号的价格表,换个 provider 就没有价格,因此它们都需要一个「手工编辑价格表」的入口。dsh-bill 通过 llm-pricing 拉取 models.dev 与 OpenRouter,覆盖 8000+ 条目,新模型上线即可计价。

价格是时间轴。 其余插件把价格算成一个数存下来(或按当前价重算),厂商调价、跨越峰谷边界时历史就不准了。dsh-bill 按每次调用自己的时刻定价,历史永不重算。

回答「花在什么上」。 其余插件只回答「花了多少」——它们只消费 provider 汇总的 token 计数,不看请求内容。dsh-bill 在捕获时把请求切成分类片段,按缓存前缀位置分摊费用。

也有它们做得更好的地方:usage-stats 支持 11 种 provider 的余额与订阅额度(dsh-bill 只有 DeepSeek),cost-meter 能读取 OpenCode Go 的订阅配额,两者的常驻入口也比 dsh-bill 多。

逐项对比(按源码实测,取样于 2026-08-16)

取样为 GitHub dsh-plugin topic 下 star ≥ 40 的费用类插件,以及 npm 上已发布的四个。deepseek-harness-wallet 等 star 较低的插件未逐一核对。

| | dsh-bill | cost-meter | usage-stats | dsh-cost | cost-log | dsh-usage | usage-billing |
| star / 版本 | — | ★42 / 1.3.1 | ★40 / 0.2.0 | ★3 / 0.2.1 | ★2 / 1.0.0 | ★2 / 0.1.1 | 0.2.2 |
| 价格来源 | 在线目录 | 内置表 + 手动爬文档页 | 不计价 | 内置表 | 内置表 | 用户自填 | 内置表 |
| 覆盖模型 | 8000+ 条目 | 4 个 DeepSeek | — | 4 个 DeepSeek | 2 个 DeepSeek | 逐个手填 | DeepSeek |
| 未收录模型 | 标记不计入 | 按 flash 价计 | 标记未知 | 按 v4-pro 计 | 标记 ≈ | 标记 -- | 计 0 |
| 历史不被重算 | ✓ | ✗ | — | ✗ | ✓ | ✓ | 需手动回填 |
| 内容归因 | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
| 成本预测 | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
| 预算 | ✓ | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| 账户余额 | ✓ | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ |
| 安装前历史 | ✓ | ✗ | ✓ | ✗ | ✓ | ✓ | ✓ |
| agent 工具 | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ | ✓ |
| 多币种 | 166 种,实时汇率 | 3 种,固定汇率 | — | 随界面语言 | ¥/$ | 单一货币 | 仅 ¥ |

计价

- models.dev + OpenRouter 双目录,24h 缓存并落盘,失败回退内置历史快照;
- DeepSeek 官方直连价覆盖目录报价,按调用时刻自动选择峰谷价;
- 提示词缓存写入按 provider 报告的实际时长计价:用量报告带 cacheWrite1hTokens(cacheWriteTokens 中写入 1 小时缓存的部分,Anthropic 在路由请求长缓存时返回)时,这部分按 1 小时写入计价,其余按 5 分钟写入计价;没有该字段时全部按 5 分钟写入计价;
- 模型名归一化,匹配不到的标记为「?」,不参与合计 —— 不估算;
- priceOverrides 可覆盖或新增任意价格(通常用不到)。

归因方法

每次请求都要为完整上下文重新付费,因此一次读入的工具输出会在后续每次请求中继续计费,直到滑出上下文。归因逐请求计算后累加。

两个关键点:

- 按位置定价。 前缀缓存下,prompt 的前 N 个 token 走缓存价,其余走全价 —— DeepSeek 上两者相差最多 156×。内容片段严格按 provider 接收顺序排列,缓存前缀按缓存价计,仅尾部付全价。按平均单价分摊会把费用记到错误的类别上。
- 只保留计数。 归因在捕获时对实时请求完成,落盘仅保存各类别金额,不保存任何 prompt 文本。

各片段的 token 数按字符占比估算(provider 只返回总数),总额取真实计费值,因此各项精确加总到实付金额。

会话日志里只有 token 计数与模型路由,没有请求正文 —— 所以安装前的历史能回填出费用,但归因无法追溯。报告会标注已覆盖比例。

配置

预算、预算货币、所有数字共用的显示货币,以及各处界面是否显示,都在设置里的「费用统计」页设定,存于 $DSH_HOME/dsh-bill/prefs.json。两种货币是两个独立设置:预算货币是那句承诺(「每月 100 元」),不随显示货币变动。(不走 DSH 自己的设置文档:它的 API 代理只向浏览器暴露一份固定的命名空间白名单,插件的命名空间在那里既读不到也写不了。)

maxRecords(内存环形缓冲条数,默认 20000)、agentTool(是否注册 bill_stats,默认 true)、backfillTimeoutMs(启动时历史导入的总预算,默认 60000 毫秒)、rateCurrency(一个 ISO 货币代码,如 USD,让所有模型的基础单价都用它显示,而不是各厂商自己的标价货币 —— 在 DeepSeek 国际站按美元结算时有用)、dshHome(存储所在的 harness home,优先于 $DSH_HOME —— 与 harness 自带存储插件的同名配置一致,用于一个进程承载多个 harness 实例、各自记账的场景)与 priceOverrides 走插件配置,会在启动时校验 —— 写错的字段会指名报错,而不是让报告静静地空掉。~/.dsh/profiles/web/cordis.patch.yml 只在需要覆盖价格时才用得上:

- insert:
- id: bill
name: 'dsh-bill'
config:
priceOverrides:
'anthropic/claude-sonnet-4-6':
inputPerM: 3.0 # 每百万 token 输入(未命中),USD outputPerM: 15.0 cacheReadPerM: 0.3 cacheWritePerM: 3.75

数据与隐私

- 记录每次调用的 provider / model / token 用量及归因金额,落盘至 $DSH_HOME/dsh-bill/records.jsonl(2 万条环形缓冲,更早的折叠为汇总);
- 账户余额的 API key 在 host 侧解析与使用,不进入浏览器;
- 除价格目录、汇率接口与余额查询外不发送任何数据;不保存任何对话内容。

实现

| 层 | 实现 |
| 捕获 | 监听 llm/stream waterfall,包装流观察 usage chunk,原样透传 |
| 计价 | 按调用时刻交由 llm-pricing 解析目录 / 峰谷 / 覆盖价 |
| 归因 | 捕获时切分请求为分类片段,按缓存前缀位置分摊 |
| 回填 | 会话日志只列一次,以可取消的预算导入未记录的会话,按 turn:step 去重 |
| 每轮 | billTurns session projection:host 侧折叠会话日志,推送到客户端,无轮询;billLive 另发一条只含在途输出的估算 |
| 账户级 | 今日 / 本月 / 累计不属于任何会话,改用长轮询:每个窗口一条请求,带上已有的 rev,host 在花费变动、跨日或 25 秒后才应答 |
| 存储 | 内存环形缓冲 + 追加式 JSONL,淘汰前折叠为汇总;偏好为单独的小 JSON 文档;原子替换与文件锁复用 dsh-atomic-write |
| 传输 | POST /dsh-bill/api(harness 目前无法为插件挂载 ctx.connection.rpc 通道) |
| UI | conversation.view / main + sidebar.panellist / conversation.chat.turnTail / conversation.composer.dock / sidebar.footer.action / sidebar.session.row.hover / settings.section,全部构建在 host 的 --dsw-* 设计令牌之上 |

License

MIT