在 DeepSeek Harness (DSH) 的开发流程中，实时掌握账户余额有助于控制成本和资源规划。若通过手动查询或切换窗口的方式查看，效率较低。下面介绍由 MatsMQ 维护的 dsh-deepseek-balance 插件，它将余额查询功能集成到 DSH Web 界面中，提供直观的监控体验。
功能定位¶
这是一个为 DSH Web GUI 设计的余额小部件。它通过 host 侧的安全通道获取 API Key 并向官方接口请求余额数据，浏览器端仅接收结果，确保 Key 永远不离开主机进程。核心功能包括：
- 双处显示：在会话标题栏右侧显示余额徽章，在 设置 → 插件 → 账户余额 显示详细数据。
- 自动刷新：每 30 秒自动轮询一次，数据在各视图间同步。
- 安全处理：Host 端处理认证，浏览器侧通过同源围栏校验保护数据。
安装与启用¶
安装前请确认 host 侧已启用 webServer 和 credentials 服务（web profile 自带），且浏览器侧已加载 React。使用以下命令从 GitHub 安装：
dsh plugin --profile web add https://github.com/MatsMQ/dsh-deepseek-balance
使用步骤¶
安装完成后，需确保凭据配置正确并重启服务：
- 在 host 端配置环境变量
DEEPSEEK_API_KEY（或写入$DSH_HOME/.credentials.yaml），确保与模型设置中使用的 Key 一致。 - 重启 DSH Web 服务，插件会在启动时自动装载。
- 进入任意会话，在标题栏右侧即可看到余额徽章。
- 在 设置 → 插件 → 账户余额 中可查看总余额、赠送余额、充值余额及可用状态。
配置项¶
插件通过 cordis.patch.yml 进行配置，默认值如下：
| 字段 | 默认值 | 说明 |
|---|---|---|
credentialRef |
DEEPSEEK_API_KEY |
使用的凭据引用名 |
upstreamUrl |
https://api.deepseek.com/user/balance |
余额查询端点 |
timeoutMs |
10000 |
上游请求超时（毫秒） |
安全边界与注意事项¶
- 密钥隔离：API Key 仅在 host 进程内使用，通过 DSH 的凭据通道传递，浏览器端无法接触。
- 网络监听：默认 Web 部署仅监听
127.0.0.1。若绑定0.0.0.0，余额信息会暴露到局域网（但 Key 依然安全）。 - 文件保护：插件不会修改任何配置文件或凭据文件。
- 路由安全：API 请求路由为
GET /dsh-balance，浏览器请求受同源围栏（Sec-Fetch-Site）保护。
该插件适合需要在 DSH Web 界面中持续监控 DeepSeek 余额的开发者。使用前请确认源码与许可证，并确保 host 服务依赖已满足。
