花费胶囊 lalilulelo3/dsh-spend-pill

dsh-spend-pill

在 DeepSeek Harness 的输入框统计行里，显示上一句话实际花了多少钱。

一个很小的 DSH 插件：胶囊上写着「上句结算 ¥0.062」，点开能看到这一轮是怎么组成的——多少次模型调用、多少缓存读、当前上下文多重、下一句的"起步价"是多少。

为什么做这个

DSH 自带的统计行会告诉你"25 轮 226 步""11.1M tok 缓存命中 99%"，但不会告诉你要付多少钱。

而成本这件事有两个反直觉的地方：

1. 付费单位是「模型调用」，不是「一轮对话」。一轮里模型可能被调用 10 次（读文件、跑命令、改代码各算一次），每次都按当时完整的上下文重新计费。
2. 大头常常是"重读历史"。上下文 39 万字时，每调用一次就要重读 39 万字，这笔钱比模型真正"想"和"写"的部分还多。

这个插件把这两件事摊开给你看。

显示什么

胶囊（平时）

上句结算 ¥0.062

展开

本会话已花 ¥2.12 输出 18.3 万 token 缓存读 5888.3 万 token 未命中 20.7 万 token ──────────────────── 上句结算（第 28 轮） ¥0.062 其中模型调用 6 次本句进行中 ¥0.041 ──────────────────── 当前上下文 39.3 万（38%）起步价（重读历史） ¥0.0079 按当前空闲·半价时段估算

- 本会话已花：累计 token × 当前时段单价
- 上句结算：上一轮的真实总花费，服务端从完整日志算出来的定值，重启不会变
- 其中模型调用 N 次：这一轮模型被调用了几次——这是解释成本的关键
- 当前上下文 / 起步价：上下文占窗口多少，以及下一句话开场就要付的固定成本
- 上下文 50% 变琥珀、60% 变红并提示压缩（DSH 自动压缩点在约 69%，留出提前量）

安装

从 GitHub 安装（推荐）

dsh plugin --profile desktop add "github:lalilulelo3/dsh-spend-pill"

桌面版 profile 是 desktop（命令行网页版是 web）。装完重启对应进程。

本地开发（clone 后 link）

git clone https://github.com/lalilulelo3/dsh-spend-pill.git
dsh plugin --profile desktop add "link:C:/path/to/dsh-spend-pill"

⚠️ 暂时不要用 npm 包名安装。npm 上 dsh-spend-pill 目前只有发布流程留下的 0.0.0-stage 空壳占位（没有 lib/），dsh plugin add dsh-spend-pill 会装到一个加载不起来的空包。等正式版本上线后再更新这里。

实现要点

- 服务端（lib/index.js）注册一个 spendStats 投影，消费 assistant/message 事件里提供方上报的 usage，按 turn/end 划边界，折叠出「当前轮」和「上一轮」的 token 总量。
- 投影从完整持久日志重放，所以重启、分页、压缩都不会改变结果。
- 一开始试过在客户端记差值，发现页面一刷新就归零，而且一轮中途会因为事件顺序问题被清零——所以挪到了服务端。
- 客户端（lib/client.js）往 conversation.composer.dock 插槽注册一个条目（order: -1，排在内置的轮次统计前面），读 tokenUsage / contextPressure / spendStats 三个投影。
- 价格按 DeepSeek 官方价硬编码在客户端：缓存命中 0.02、未命中 1、输出 4（元/百万 token，空闲时段；高峰翻倍），并按北京时间自动判断当前时段。
- 不是精确账单：投影里没有每次调用的时间戳，所以统一按"当前时段"折算。跨时段混用时会有偏差。

已知限制

- 只对 DeepSeek 定价有意义，其他 provider 需要改 PRICE_PEAK / PRICE_OFF。
- 「上句结算」在第一轮没有值（没有"上一轮"），显示 ¥—。
- 一轮里如果被打断、没产生任何模型调用，不覆盖上一次的结算值。

License

MIT