dsh-balance-mini：DeepSeek Harness 极简余额监视器

前言¶

在使用 DeepSeek Harness（DSH）进行智能体开发或任务调度时，API 消耗是一个核心关注点。手动刷新网页查看余额不仅效率低，还容易错过计费变动的关键信息。针对这一场景，下面介绍 dsh-balance-mini 插件，它为 DSH Web 界面提供了一个轻量级的余额监控方案。

定位¶

dsh-balance-mini 是 DeepSeek Harness 的极简余额监视器：常驻余额徽章、红绿灯配色、多供应商支持、高峰/空闲时段提示。该插件由 DaYanQAQ 维护，采用 MIT 许可证。

核心功能¶

常驻余额徽章与红绿灯¶

插件在左下角提供一个常驻的余额徽章，实时显示当前余额与最后更新时间，且会随侧边栏宽度自适应。当侧边栏收起时，徽章会收缩为红/黄/绿三个小圆灯，用于快速识别余额状态：
* 红色：余额低于 10 元
* 黄色：余额在 10 至 20 元之间
* 绿色：余额高于 20 元
金额文字颜色遵循相同规则。

自动刷新与手动控制¶

插件每 60 秒自动查询一次余额。若需立即获取最新数据，可在面板右上角进行手动刷新。

多供应商支持¶

插件支持 DeepSeek、Kimi（月之暗面）和 OpenRouter 三家供应商。它通过读取 DSH 的凭据文件来识别已配置的 API Key，无需额外配置。

高峰/空闲时段提示¶

插件依据 DeepSeek 官方定价显示当前计费时段：
* 高峰时段：北京时间周一至周五 9:00–12:00、14:00–18:00
* 空闲时段：其余时间（包括晚间、凌晨、午休及周末全天）。空闲时段价格为高峰时段的一半。
面板会显示距下一时段切换的倒计时。

安全与语言¶

本机安全边界：接口仅接受回环地址（127.0.0.1）访问，API Key 仅发往官方接口，不落盘、不转发任何第三方。
中英文自动切换：界面语言跟随浏览器设置。

安装与启用¶

前置条件：DeepSeek Harness (@deepseek-ai/dsh >= 0.1.0-rc.6)。

执行安装命令：

dsh plugin --profile web add dsh-balance-mini

重启 dsh web 服务。
在浏览器中硬刷新页面（Ctrl+Shift+R），左下角出现余额徽章即表示安装成功。

配置与使用¶

插件零配置开箱即用，只需在本地凭据文件中配置相应的 API Key。

在 ~/.dsh/.credentials.yaml 中添加以下内容（根据实际需求选择）：

refs:
  DEEPSEEK_API_KEY: sk-xxxxxxxx      # DeepSeek：platform.deepseek.com
  MOONSHOT_API_KEY: sk-xxxxxxxx      # Kimi：platform.moonshot.cn
  OPENROUTER_API_KEY: sk-or-xxxx     # OpenRouter：openrouter.ai

添加或删除 Key 后重新打开面板即可生效，无需重启服务。

注意事项¶

插件以当前 DSH 进程的权限运行，接口访问范围严格限制在本地。
首次打开面板时会弹出使用说明，点击“知道了”后将不再重复显示。