前言¶
在使用 DeepSeek Harness 进行对话实验或调试时，控制 API 成本是常见需求。虽然 Harness 自身统计了 Token 用量和耗时，但缺乏直观的费用展示，难以实时估算单轮对话或整个 Session 的支出。dsh-cost 插件通过读取 Harness 的 Token 投影数据，为 Web 会话提供了可视化的费用估算。
功能¶
该插件提供以下核心能力：
- 本轮费用与 Session 累计费用：每轮回答结束后显示本轮的花费，并累计整个 Session 的总花费。
- 明细面板：点击费用标签可展开详细计算过程，包含使用的模型、计价时段（峰/谷）以及各 Token 桶的用量与单价明细。
- 缓存命中率：显示 Prompt 中被缓存命中的比例。
- DeepSeek 分时段计价：支持 DeepSeek 的峰/谷时段计价逻辑，自动识别周末和节假日。
- 只读模式：插件仅读取 Harness 的 token 投影，不发送请求，不修改会话，不触碰模型 API。
- 可扩展价目表：基于数据驱动的价目表注册机制，可轻松扩展支持其他厂商的计费。
安装¶
安装前请确保环境满足要求：DeepSeek Harness 版本需大于等于 0.1.7-rc.1，且 Node.js 版本需大于等于 18。
执行以下命令进行安装：
dsh plugin --profile web add @jackguo0310/dsh-cost
安装后，如果 dsh web 正在运行，需要重启一次该进程，刷新页面即可生效。
用法¶
安装完成后，启动 Web 会话：
dsh web
在对话回复的下方，费用胶囊会显示在 DSH 自带的 Token 和时间胶囊下方。格式通常为：本轮 ¥x · 累计 ¥y · 缓存 z%。
点击费用胶囊，可以查看具体的计价明细。
注意事项¶
- 估算性质：插件显示的是估算值，并非官方账单。DeepSeek 的官方计费为准。缓存命中率、计价窗口边界及法定节假日在计算上可能存在细微差异。
- 计价窗口逻辑：计价窗口由回合的完成时间决定。如果一轮对话跨越了峰/谷时段的边界，该轮对话的计价会完全归属到一侧（基于完成时间判定）。
- 跨模型切换：如果一轮对话中切换了模型（例如重试），该轮无法按模型拆分计价，将统一按首个模型的价格计算，并标记为估算值。
- Session 总计范围：Session 的累计费用仅覆盖已加载的回合，未加载的历史回合不计入总计。
- 环境依赖：插件依赖 DeepSeek Harness 的特定客户端接口，若 Harness 版本更新导致接口变化，插件可能无法正常工作。
结语¶
dsh-cost 通过轻量级的方式解决了 DeepSeek Harness 用户的成本追踪痛点。它不仅展示了当前的消费情况，还提供了详细的计算逻辑，方便开发者根据缓存命中率和分时段计价优化提示词。如需修改价格表或添加其他厂商支持，可参考源码中的配置。
