在 DeepSeek Harness (DSH) 的 Web 界面中，开发者需要一种方式快速确认 API 配额。ds-balance 插件提供了一个轻量级的解决方案，将余额信息直接集成到会话头部。
它是什么¶
ds-balance 是由 JovanHE 维护的一个最小化 DeepSeek 账户余额小部件，专为 DeepSeek Harness (dsh) 的 Web GUI 设计。它通过一个紧凑的胶囊组件展示当前账户余额，并支持自动刷新和详情查看。
核心功能¶
- 实时显示：在会话头部右侧显示余额胶囊（如
DS CNY 3.65）。 - 自动刷新：默认每 60 秒自动刷新一次余额。
- 手动刷新：点击胶囊可立即刷新数据。
- 悬停详情：鼠标悬停可查看总额、已获额度及充值明细的完整拆分。
- 安全性：读取
DEEPSEEK_API_KEY时仅使用 DSH 的凭据 seam，密钥仅在子进程环境中传递，不会出现在命令行、源代码或浏览器中。 - 只读与幂等：通过单个 HTTPS GET 请求获取数据，不产生会话事件或日志污染。
安装与启用¶
确保已安装 DeepSeek Harness (dsh) 并配置了 Web profile。执行以下命令安装插件：
dsh plugin --profile web add github:JovanHE/ds-balance
安装后必须重启 dsh web 进程，因为客户端插件发现机制仅在进程启动时运行。
典型用法¶
该插件零配置。只要 DEEPSEEK_API_KEY 已在 DSH 凭据存储（~/.dsh/.credentials.yaml）或环境变量中设置，小部件就会出现在每个会话头部。
- 点击胶囊可立即刷新。
- 悬停胶囊可查看余额构成详情。
- 若密钥缺失或请求失败，胶囊会变红，并在悬停提示中显示原因。
安全与实现细节¶
- 密钥获取：插件从 DSH 的凭据 seam 读取
DEEPSEEK_API_KEY。 - 传递方式：密钥仅通过子进程环境变量传递，绝不包含在命令行参数或源代码中。
- 端点调用：使用
ctx.shell调用 PowerShell 的Invoke-RestMethod访问 DeepSeek 的余额端点。这是为了处理 Windows 沙盒限制，因为 fetch seam 无法携带必要的Authorization头部。 - Bundle 客户端适配：在打包客户端中，
host和styles全局变量不可用，因此插件通过document注入样式表。
总结¶
ds-balance 插件通过集成到 DSH 界面头部，解决了开发者查看 DeepSeek 余额的需求。它保证了 API 密钥的安全，并在无需额外配置的情况下提供了直观的交互体验。
- 项目地址：JovanHE/ds-balance
- 目录页：ds-balance
