在 DeepSeek Harness (DSH) 中进行智能体开发或调试时，实时掌握 API 调用的成本和官方账户余额有助于控制预算。dsh-usage-meter 是一个插件，旨在提供简单直接的用量和余额监控功能。
该插件是一个简单的用量计费工具，用于显示 API 消耗的金额。它支持峰谷定价。作者为 HunterCHCL，类别为 admin-security，许可证为 MIT。
核心功能¶
- 显示余额与花费：显示 DeepSeek 官方 API 余额和当前会话花费。
- 界面交互：在界面右上角显示金额，悬停查看详情。
- 配置选项：支持在设置页面配置价格表和峰谷定价。
- 语言跟随：UI 语言跟随 DSH 语言设置。
- 官方接口：通过 Session header indicator 调用官方 DeepSeek API 获取余额。
安装与启用¶
使用官方安装命令安装：
dsh plugin --profile web add @hunterchcl/dsh-usage-meter
典型用法¶
- 切换语言：在 DSH 设置 -> 通用 -> 语言中切换界面语言，插件 UI 会随之更新。
- 查看详情：悬停在界面右上角的金额上，查看当前会话的详细花费。
- 配置定价：在设置中启用峰谷定价，根据请求发生的时间窗口计算费用。
适用场景与注意¶
- 估算参考：用量数据是本地估算值，基于 DSH 持久化的会话事件日志（
assistant/chunk和assistant/message），仅供参考，并非平台账单，请以 DeepSeek 官方为准。 - 历史计算：打开会话时会计算完整历史使用量，包括插件安装前的记录。
- 兼容性：仅支持官方 DeepSeek API，非官方 API、缺少密钥或查询失败时余额显示为隐藏。
- 许可证：MIT 许可证。
- 维护提示：手动运行
pnpm install可能会清理本地插件目录，建议使用提供的安装脚本。
该插件为 DSH 用户提供了轻量级的成本控制手段。相关文档与源码可在下方目录页与 GitHub 仓库查看。
