前言¶
在 DeepSeek Harness (DSH) 的开发与调试过程中，实时掌握 API 账户余额有助于控制成本或规划使用。dsh-balance 插件解决了这一需求，通过在 Web 界面中常驻显示余额、提供工具接口以及自动刷新机制，让余额查询变得直观且高效。
插件介绍¶
dsh-balance 是一个 DeepSeek API 余额显示插件，由 Yogioo 维护。它将账户剩余金额常驻显示在 dsh web 对话输入框下方，并为模型提供了 check_balance 工具，同时通过宿主进程处理 API Key，确保安全性。
核心功能¶
- Web 界面常驻显示
在 dsh web 对话输入框下方显示DeepSeek 余额:¥xx.xx。
悬停该信息可查看赠送与充值明细。 - 模型工具集成
插件注册了check_balance工具，开发者可直接对 agent 说“查下余额”来调用该功能。 - 安全与自动刷新
API Key 仅存在于宿主进程，浏览器端不接触密钥。宿主进程每 60 秒自动刷新余额数据。 - 自动化部署
声明了dsh.bundle，通过一条命令即可完成安装与挂载，无需手动修改配置文件。
安装¶
使用官方提供的命令安装即可。安装器会自动将插件加入 profile 层并挂载 patch。
dsh plugin --profile web add git+https://github.com/Yogioo/dsh-balance.git
安装后重启 dsh web，刷新页面即可看到余额读数。
典型用法¶
- 查看余额：在对话界面输入框下方查看实时余额。悬停可查看赠送和充值的具体构成。
- 指令查询：直接与 agent 交互，发送“查下余额”或类似指令，触发
check_balance工具。 - 错误处理：若查询失败，界面会显示错误原因，并在 60 秒后自动重试。
技术细节与注意事项¶
- 环境要求：需要 dsh web 部署环境，且宿主 Node.js 版本需 ≥ 18。
- 密钥配置：需配置
DEEPSEEK_API_KEY环境变量，且credentials服务能正确解析该变量。 - 刷新机制：宿主每 60 秒通过官方接口查询余额，客户端同步拉取宿主缓存。
- 代码修改：修改宿主逻辑（如
lib/index.js）通常直接生效；修改客户端逻辑（如lib/client.js）需要重启dsh web。 - 冲突处理：关于行 id 冲突，bundle 的 patch 与用户 patch 按“同一行 id 后者覆盖”的规则合并，允许用户覆盖默认配置。
总结¶
dsh-balance 插件通过在 UI 和工具层面的双重支持，解决了 DSH 开发者频繁查看余额的痛点。它不仅提供了可视化的余额读数，还通过常驻刷新和错误重试机制，确保了信息的及时性与稳定性。
