前言¶
在 DeepSeek Harness 里切换多个模型 Provider 时，余额往往分散在各自控制台或文档接口里。要确认 DeepSeek 登录账户、官方 API Key、OpenRouter、SiliconFlow 等是否还有额度，通常需要离开 Harness 或另开页面查询。下面介绍社区插件 DSH Balance（@pipilu123566/dsh-balance）：在桌面/Web 侧栏底部账户区域上方增加钱包入口，把已在 Harness 中配置的 Provider 余额汇总展示，并支持按需刷新。
这是什么¶
DSH Balance 是由维护者 pipilu123566 开发的 非官方 DeepSeek Harness 客户端插件（MIT）。它在侧栏占用公开的 sidebar.footer.action 插槽，在账户按钮上方单独占一行，不改动 Harness 核心设置流程；Provider 仍按 Harness 原有方式配置。
源码持续开发已迁移至集合仓库 deepseek-harness-plugin/dsh-balance；pipilu123566/dsh-balance 保留已发布的 1.0.0 发行包、校验和与固定版本引用。插件目录页：SkillHub - dsh-balance。
核心功能¶
根据 README 说明，插件当前能力包括：
- 侧栏交互：悬停或聚焦钱包按钮可展开余额；点击可固定面板。
- 多源汇总：在同一处查看 DeepSeek 登录账户、DeepSeek API、OpenRouter、SiliconFlow 的配置与余额（各 Provider 币种与钱包类别分开显示，不做货币换算或 token 估算）。
- 刷新策略：支持手动刷新；面板打开时约每分钟自动刷新一次，关闭后停止轮询。
- 错误呈现：缺少凭证、不支持的 Provider、限流与请求错误会明确展示，不会显示为「零余额」。
各 Provider 数据来源与要求（节选）：
| Provider | 数据来源 | 说明 |
|---|---|---|
| DeepSeek 登录账户 | Harness 账户服务 | 需在 Harness 内登录；充值与赠送钱包分开展示 |
| DeepSeek API | 官方 /user/balance |
需配置官方 API Key |
| OpenRouter | 官方 /api/v1/credits |
需 Management Key；普通 Key 可能被拒绝 |
| SiliconFlow | 官方 /v1/user/info |
需为 api.siliconflow.cn 配置的 Key；余额为 CNY |
| 其他已配置 Provider | 不发起推测性请求 | 标记为不支持；未配置的目录项不显示 |
插件仅将各 Provider 的凭证发往对应的 HTTPS 白名单端点；拒绝自定义代理、非标准端口、URL 内嵌凭证与重定向请求。密钥留在本机，不增加独立后端或分析上报。
兼容性¶
1.0.0 面向 DeepSeek Harness 0.2.1-rc.5；README 未声明更高 Harness 版本的兼容性。发行验证在 macOS 上于隔离的 Harness Web Profile 中进行，详见仓库 validation。自动化测试不包含真实 DeepSeek API Key、OpenRouter 与 SiliconFlow 凭证。
安装与启用¶
安装必须使用 Release 中的可安装包 pipilu123566-dsh-balance-1.0.0.tgz，而非 GitHub 自动生成的源码归档。
- 从 v1.0.0 Release 下载上述 tgz 到本地目录。
- 完全退出 Harness 后再修改 desktop profile。在下载目录执行：
dsh plugin --profile desktop add ./pipilu123566-dsh-balance-1.0.0.tgz --ignore-scripts
- 重新打开 Harness。在侧栏底部账户区域上方应出现钱包按钮；按 Harness 常规设置配置 Provider 即可。
macOS 上若 dsh 不在 PATH，可使用应用内置 CLI：
'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' plugin --profile desktop add ./pipilu123566-dsh-balance-1.0.0.tgz --ignore-scripts
若使用 Web profile，将命令中的 desktop 换为该 profile 名称，并在更换包前后停止/重启对应实例。每个 profile 只应安装一份 balance 包。升级时用新版本 tgz 重复上述步骤；不要自行扩大 README 声明的 Harness 兼容范围。
卸载：退出目标实例后执行：
dsh plugin --profile desktop remove @pipilu123566/dsh-balance
再重新打开 Harness。
典型用法¶
安装并完成 Provider 配置后：
- 将指针移到侧栏底部的钱包按钮，或使其获得焦点，查看各 Provider 余额摘要。
- 需要固定查看时，点击钱包按钮钉住面板。
- 面板内使用刷新操作更新数据；面板保持打开时会约每分钟自动刷新，关闭面板后轮询停止。
README 中的演示截图使用隔离 Harness 实例中的演示数据，不代表真实账户或实时 Provider 查询结果。
适用场景与注意¶
适合：在 Harness 内频繁切换 DeepSeek 登录、DeepSeek API、OpenRouter、SiliconFlow 等 Provider，希望在侧栏快速核对余额与错误状态的用户。
注意：
- 插件以当前 Harness /
dsh进程权限运行，会向已配置的 Provider 官方端点发起 HTTPS 请求。安装前请阅读 源码与 MIT 许可证，并自行评估风险。 - 社区插件与 DeepSeek / 幻方无隶属或背书关系；SkillHub 等目录站点亦为社区生态，并非官方应用商店。
- OpenRouter 需 Management Key；SiliconFlow 余额为人民币；未支持的 Provider 不会假装有余额。
问题反馈可提交至集合仓库 Issues。
结尾¶
DSH Balance 把多 Provider 余额收拢到 Harness 侧栏，减少离开客户端查账的步骤。获取插件与 1.0.0 安装包见 GitHub 仓库 与 SkillHub 目录页。
