前言¶
DeepSeek Harness 的插件生态支持通过配置扩展 Web UI 的功能。对于需要精细化控制成本、时刻关注账户余额以及利用离峰折扣的开发者来说，手动查看页面或依赖临时的动态插件效率较低。dsh-deepseek-cost-watch 插件将离峰时刻表、实时账户余额和会话成本估算直接集成到 Harness Web UI 中，提供一种无需离开应用即可掌握成本状况的方案。
插件信息¶
- 名称：
webificio/dsh-deepseek-cost-watch - 作者：Webificio
- 类别：联网工具
- 许可证：MIT
核心功能¶
该插件通过一个安装包替换了原本需要动态生成的两个功能，提供了以下能力：
- 离峰状态徽章：在界面右下角显示一个浮动卡片。卡片实时显示当前是离峰还是高峰，绿色表示享受 50% 折扣，琥珀色表示高峰。卡片包含倒计时，显示距离下一次峰谷切换的时间。同时展示 UTC 和本地时区（含跨天标记）的固定折扣窗口。
- 账户余额显示：显示 DeepSeek 账户的剩余余额。余额数据由 Host 端获取，不会在浏览器端暴露 API Key，保障安全。支持手动点击刷新，系统也会每 5 分钟自动轮询一次（Host 端有 60 秒缓存）。余额不足时金额会显示为琥珀色。
- 会话成本估算：位于对话编辑器上方。估算值基于会话历史记录，记录发生时的费率进行计算，而非仅基于当前费率。显示内容包含估算总花费、当前余额、输入/输出 Token 消耗、缓存命中情况以及模型信息。
安装与启用¶
插件需要通过 dsh plugin 命令安装到 web profile。
- 在终端执行安装命令：
dsh plugin --profile web add github:Webificio/dsh-deepseek-cost-watch
- 安装完成后，必须重启
dsh web进程以使配置生效：
dsh web
- 重启后，在浏览器页面刷新即可看到右下角的离峰卡片和编辑器上方的成本行。
使用说明¶
- 查看离峰状态：卡片默认展开，显示详细的时间表。按下键盘
–键可折叠为胶囊状（如PEAK · 18m 04s），点击胶囊可再次展开。 - 刷新余额：直接点击卡片中的余额行，可立即从 Host 端重新获取最新余额。
- 查看成本明细：点击编辑器上方的成本行（默认显示为带颜色的圆点和金额），可展开查看详细的 Token 消耗和费率计算。
技术细节¶
- 运行环境：插件分为 Host 端和 Browser 端两部分。Host 端负责获取余额和折叠会话日志进行成本计算；Browser 端负责渲染 UI。余额请求只发送到
api.deepseek.com，且 API Key 仅保存在 Host 进程中。 - 要求：需要 DeepSeek Harness 版本 0.1.5-rc 或更高，且系统 PATH 中需配置
pnpm和git。
注意事项¶
- 不是账单金额：插件提供的成本估算基于官方费率表，但不等同于最终账单金额。
- 依赖版本：确保 Harness 版本满足要求，否则可能无法识别插件配置。
总结¶
dsh-deepseek-cost-watch 适用于需要在开发过程中实时监控 DeepSeek API 消费情况并利用离峰折扣的开发者。它通过将计算逻辑下沉到 Host 端，在保障安全的同时提供了直观的 UI 反馈。
