在 DeepSeek Harness（DSH）生态中，管理智能体或对话的成本与资源消耗是一个常见需求。虽然 DeepSeek 开放平台提供账单，但往往存在延迟或不够直观。dsh-show-me-how-much 插件旨在填补这一空白，提供实时的本地估算与详细统计。
核心功能¶
这个插件主要解决 Web 端的用量与费用追踪问题，具备以下能力：
- 实时展示：在会话底栏最右侧实时显示估算费用和总 Token。
- 统计面板：进入「设置 → 费用统计」，可查看按日期、时间的统计，包含缓存命中率、按日趋势及模型明细。
- 模型识别与自定义：自动区分 DeepSeek V4 Flash 与 V4 Pro，并支持自定义回退价格。
- 持久化与回放：利用 Harness 的 Projection 机制，重新打开历史会话仍可重放统计。
- 计数逻辑：流式 usage 与最终 message 采用替换语义，不会重复累计。
安装与启用¶
使用官方提供的命令进行安装：
dsh plugin --profile web add github:kam74515-boop/dsh-show-me-how-much#v0.1.0
安装完成后，重启 Harness Web 服务：
dsh web
价格与计费逻辑¶
插件默认使用 DeepSeek V4 人民币官方价格表（2026-08-15）进行计算。费用计算公式如下：
(缓存命中输入 × 命中价 + (未命中输入 + 缓存写入) × 未命中价 + 输出 × 输出价) / 1,000,000
默认价格配置如下：
| 模型 | 缓存命中输入 | 未命中输入 | 输出 |
|---|---|---|---|
| DeepSeek V4 Flash | ¥0.02/M | ¥1/M | ¥2/M |
| DeepSeek V4 Pro | ¥0.025/M | ¥3/M | ¥6/M |
插件会识别 Harness 返回的 uncachedInputTokens、cacheReadTokens、cacheWriteTokens 和 outputTokens。如果 provider 报告了缓存写入 Token，该部分将按未命中输入计价。
本地开发¶
如果你需要查看源码或进行本地调试，可按以下步骤操作：
git clone https://github.com/kam74515-boop/dsh-show-me-how-much.git
cd dsh-show-me-how-much
npm install
npm run check
dsh plugin --profile web add .
注意事项¶
- 估算值性质：金额是基于 provider 返回用量与当前价格表的估算值，不等同于 DeepSeek 开放平台账单。
- 第三方 Provider：赠送余额、折扣、价格调整和第三方 provider 可能造成差异。
- 版本依赖：项目针对 DeepSeek Harness
0.1.0-rc.6开发。Harness 目前仍处于 Developer Preview，后续版本可能需要同步插件 API。
总结¶
dsh-show-me-how-much 是一个专注于实用性的统计插件，能够帮助开发者快速掌握对话成本与 Token 消耗。插件基于 MIT 许可证开源，维护者为 kam74515-boop。
