前言¶
DSH 的插件化方式允许在会话、工具调用和上下文管理周围扩展能力。做 token 成本核算时，常见的问题是把不同来源的信息混成一个总数：有些调用没有持久化 usage，有些路由不在价格本里，当前上下文压力也和累计花费不是一回事。
dsh-cost 针对这类问题。它基于 durable assistant/message.usage 事件计算成本，把路由拆分、证据完整度、可选预算状态和当前 ctx.tokenMeter 压力快照分开呈现，并提供明确的 fail-open/fail-closed 预算检查。
这是什么¶
dongsheng123132/dsh-cost 是 DeepSeek Harness（DSH）的插件，定位为：
Evidence-first token cost ledger and budget checks for DeepSeek Harness
它由 dongsheng123132 维护，采用 MIT 许可证，要求 Node.js >=22；@deepseek-ai/dsh-tools 是可选 peer dependency。
核心功能¶
会话成本报告¶
dsh-cost 提供 durable session cost report，包括：
- 基于 durable
assistant/message.usage事件计算成本 - route breakdown
- evidence completeness
- optional budget status
- 当前
ctx.tokenMeterpressure snapshot
这里的成本不是凭空汇总，而是从已有的持久化 usage 事件出发。缺少 usage 或价格本未覆盖的调用会保持显式状态，而不是被合并成一个看起来完整的总额。
预算检查¶
插件提供 explicit fail-open/fail-closed budget check。
需要注意：它不声称会自动拦截未来调用。预算检查是决策输出，而不是对后续请求的自动拦截机制。
MCP server¶
插件自带 stdio MCP server，暴露：
cost_reportcost_check
MCP 只接受 bounded、sanitized usage rows，并拒绝 prompts、message bodies、credentials 以及其他额外字段。
价格本¶
成本计算使用 user-owned price book。价格按 per million tokens 计算，并将 token buckets 分为：
- input
- output
- cache-read
- cache-write
这些桶是 disjoint 的。价格本不内置供应商价格；价格应由使用者根据当前供应商合同维护，并保持为当前有效价格。
离线 CLI ledger¶
dsh-cost 提供离线 CLI ledger，用于从 durable assistant/message.usage events 计算成本。
安装与启用¶
在目标 profile 下安装插件：
dsh plugin --profile <name> add github:dongsheng123132/dsh-cost
安装后，需要配置价格本路径和默认预算。已核实的配置项包括：
priceBookFile
defaultBudget
示例配置如下：
- id: dsh-cost
name: dsh-cost
config:
priceBookFile: C:/absolute/path/prices.json
defaultBudget: 5
priceBookFile 指向用户自己维护的价格文件，defaultBudget 用于默认预算值。价格文件里的价格应按每百万 token 填写，并区分 input、output、cache-read、cache-write 四个桶。
典型用法¶
离线计算会话成本¶
当已有 session events 和价格本时，可以直接使用离线 CLI：
dsh-cost --events session-events.json --prices prices.json --budget 5 --fail-closed
该命令用于从已有事件文件计算成本，并结合预算参数做 fail-closed 检查。
如果存在 missing usage 或 unpriced calls，低于预算的结果应理解为 unknown，而不是 within。也就是说，当证据不完整时，插件不会给出一个看似可靠的“预算内”结论。
通过 MCP 使用¶
同一套证据核算能力也可以通过 bundled stdio MCP server 使用，接口名为：
cost_report
cost_check
MCP 侧只接受 bounded、sanitized usage rows，并会拒绝 prompts、message bodies、credentials 以及其他额外字段。
适用场景与注意¶
适合在以下场景中使用：
- 需要对 DSH 会话中的 token 成本做账本式记录
- 需要区分路由拆分、证据完整度和预算状态
- 需要显式检查 budget，而不是只看一个汇总数字
- 需要把 missing usage、unpriced calls 作为独立状态保留下来
- 需要通过 MCP 将成本报告和预算检查暴露给外部工具
使用前注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与 MIT 许可证
dsh-cost不做未来调用的自动拦截，预算检查是明确决策，而不是请求网关- 价格本由使用者维护，不内置供应商价格
- 若 usage 缺失或调用未定价，低于预算的结果是 unknown，不是 within
- MCP 只接受 bounded、sanitized usage rows，并拒绝额外字段
- DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不要把它理解为官方应用商店
结尾¶
dsh-cost 的价值在于把 token 成本从模糊总数变成可审计的证据链：成本来自 durable usage 事件，路由和证据状态分开呈现，预算检查明确区分 fail-open 与 fail-closed，缺失信息不会被包装成“预算内”。
相关链接：
- 社区目录：按
dsh-cost查看条目 - GitHub：https://github.com/dongsheng123132/dsh-cost
