前言¶
DeepSeek Harness (DSH) 提供了一个本地化的客户端环境，适合进行 AI 模型的交互与开发。在使用 API 调用过程中，监控账户余额和用量是控制成本的关键环节。dsh-balance 插件直接将余额显示功能集成到 DSH 的侧边栏底部，让开发者无需频繁切换标签页即可查看当前的 DeepSeek API 账户余额。
插件定位¶
该插件由开发者 shawnyhu 维护，开源协议为 MIT。它是一个客户端插件，核心价值在于将 DeepSeek 平台的用量信息可视化，集成在本地开发环境的一侧，减少操作干扰。
核心功能¶
- 侧边栏展示：在侧边栏底部显示余额行。宽栏模式下显示具体金额（如
¥110.00），收起时仅显示图标。 - 交互操作：单击余额区域可立即刷新数据；双击可跳转至 DeepSeek 平台用量页
https://platform.deepseek.com/usage。 - 自动刷新：在每次会话回合结束后自动刷新一次，并支持每 30 分钟定时自动刷新。
- 安全机制：API Key 完全保留在本地宿主进程，通过本机路由返回数据，浏览器端无法获取 Key。
- 配置继承：自动沿用 DSH 设置中「模型 → DeepSeek」的配置项。默认读取环境变量
DEEPSEEK_API_KEY，API 地址默认为https://api.deepseek.com。支持通过环境变量DEEPSEEK_BASE_URL覆盖地址。
安装与启用¶
推荐使用官方的 DSH CLI 进行安装。
dsh plugin --profile web add <path-to-dsh-balance>
安装完成后，需要重启 DeepSeek Harness 才能生效（客户端模块仅在启动时扫描包清单）。
典型用法¶
插件默认安装即可使用，无需额外配置。如果需要自定义 API Key 或地址，请前往「设置 → 模型 → DeepSeek」页面进行配置。
配置项包括：
* apiKeyEnv：默认值为 DEEPSEEK_API_KEY，指定读取的环境变量或凭证引用。
* baseURL：默认值为 https://api.deepseek.com，指定 API 根地址。
修改设置后，无需重启应用，下次刷新时即可生效。若未配置 Key，侧边栏将显示「未配置 Key」。
注意事项¶
- 重启要求：插件集的增删操作必须重启 DeepSeek Harness 才能生效。
- 配置生效：修改「设置」中的配置项不需要重启，下次刷新界面即可看到变化。
- 许可证：MIT License。
总结¶
dsh-balance 通过将余额监控嵌入侧边栏，降低了查看 API 用量的门槛，适合需要频繁调试或关注成本的开发者。插件完全开源且本地运行，保证了 Key 的安全性。更多细节可参考插件目录或 GitHub 仓库。
