dsh (tally)
wfengq/dsh/packages/tally
Per-request cost ledger covering retries and subagents, holiday-aware peak/off-peak pricing, shared pricing/usage/balance/budget services, and DeepSeek bill reconciliation.
インストール
dsh plugin --profile web add github:wfengq/dshこのプラグインはリポジトリの packages/tally サブディレクトリにあります。
README
dsh-tally
DeepSeek Harness（dsh）的用量、计价、余额与预算共享数据层。dsh 自己能统计 token 数，但没有价格数据、费用账本、余额查询和预算功能。dsh-tally 补上这几块，并以服务的形式提供出来：其他插件可以直接依赖，不必各自维护一份价格表、各自解析会话日志。
状态：预览版（
0.1.0-beta.1，npm 标签beta）。dsh 0.2 还没有正式版，插件接口在那之前可能变化；dsh 0.2 正式发布、计价经过更多天的对账验证后，再发布0.1.0正式版。
包
| 包 | 作用 |
|---|---|
dsh-pricing-data | 价格数据和计价函数：DeepSeek 官方价格（峰谷时段、中国法定节假日），价格历史按版本保存，金额用定点运算；查不到价格时返回 null，绝不返回 0 |
dsh-tally-api | 只有类型的公开接口：ctx.tallyUsage、ctx.tallyPricing、ctx.tallyBalance、ctx.tallyBudget 和三个事件。第三方插件只需依赖这个包 |
dsh-tally | 插件本体：按每次计费请求记账、余额缓存、预算提醒、浏览器可调用的 Remote API，以及对账命令 dsh-tally reconcile |
dsh-tally-ui | 参考界面：输入框下方的费用条、每轮费用、会话累计、预算提醒、右侧栏用量看板、设置页 |
dsh-tally-balance-deepseek | DeepSeek 余额查询（API key 和官方账号两种方式） |
安装
dsh plugin --profile web add dsh-tally@beta dsh-tally-ui@beta dsh-tally-balance-deepseek@beta
只想在终端或 headless 模式下记账时，装 dsh-tally 一个包即可。
桌面客户端把 --profile web 换成 --profile desktop，并在客户端完全退出时运行。想从源码安装或参与开发，见 本地安装步骤。
对账
dsh-tally reconcile --bill ./bill.csv --format csv
把账本算出的金额和厂商账单按“天 × 模型”逐行对比，超出 1% 的差异会列出可能原因。详见 packages/tally 的“对账”一节。
版本承诺
严格遵守 semver，接口只做加法。破坏性修改必须升主版本，旧主版本继续维护 6 个月。
安全扫描
下表由 dsh-trust-check 扫描各包的构建产物生成（pnpm trust:report），测试会检查它是否过期。
| 包 | 能力 | 红线 | 联网目标 |
|---|---|---|---|
dsh-pricing-data | fs-read | — | — |
dsh-tally-api | — | — | — |
dsh-tally | fs-read、fs-write | — | — |
dsh-tally-ui | — | — | — |
dsh-tally-balance-deepseek | credentials、network | creds-network | api.deepseek.com |
为什么 dsh-tally-balance-deepseek 有一条红线。 “读凭据加联网”是 dsh-trust-check 的红线组合。查询 DeepSeek 余额必须做这两件事，所以把它们单独放进这个小包里，其余四个包都不读凭据、不联网。这个包的源码一共约 300 行：
- 凭据只在
src/index.ts中通过官方的ctx.credentials.resolve()读取，引用名默认是DEEPSEEK_API_KEY，和官方 DeepSeek 适配器使用同一个，不另外保存 key； - 联网只在
src/fetchers.ts中请求https://api.deepseek.com/user/balance； - 账号登录方式走官方的
deepseekAccount服务，不接触 token； - 所有错误信息都是固定文本，key 不会出现在错误、日志或缓存的余额结果里（有专门的测试）。
说明
所有金额都是估算值，以厂商账单为准。价格数据都附有官方来源链接和核对日期。2026-10-10 之前的请求显示为“未定价”，因为还没有核实过的历史价格。