前言¶
DSH 中如果配置了多个模型 Provider，余额、密钥状态和模型范围需要分别查看。下面介绍一个 DSH 插件：dsh-balance-panel。它在 Web UI 侧边栏底部提供余额入口，打开后可查看当前 DSH 配置中 Provider 的模型、密钥状态与余额明细。
这是什么¶
dsh-balance-panel 是 wycto 维护的 DeepSeek Harness（DSH）插件，npm 包名为 @wycto/dsh-balance-panel。它用于集中展示当前 DSH 实际配置过的 Provider，以及这些 Provider 下的实际配置模型。许可证为 MIT。旧无前缀名 dsh-balance-panel 已废弃，安装时使用带 @wycto/ 前缀的包名。
核心功能¶
- 只展示实际配置过的 Provider 与实际配置的模型。休眠声明与 schema 默认全量模型列表不会出现在面板里。
- 内置 DeepSeek 官方
/user/balance接口。 - 支持为其他 Provider 自定义余额接口。
- 按 Provider 显示
apiKeyEnv凭证是否已配置，密钥本身不进入前端。 - 在侧边栏底部显示余额摘要胶囊，每 5 分钟自动刷新。
- 点击胶囊打开全屏余额面板，逐 Provider 展示模型 chips、余额明细与状态徽标。
- 无密钥、接口不支持或查询失败时给出明确文案，不影响其他 Provider。
安装与启用¶
profile 用户安装：
dsh plugin --profile web add @wycto/dsh-balance-panel
安装后重启 Web UI，或刷新：
http://127.0.0.1:3080
源码运行：
pnpm dsh web --patch ./dsh-balance-panel/cordis.patch.yml
典型用法¶
- 启动 DSH Web UI。
- 在侧边栏底部查看余额胶囊。
- 点击胶囊打开余额面板。
- 面板右上角可手动刷新。
对于 DeepSeek，插件会查询官方 /user/balance 接口。对于其他 Provider，如果无标准余额接口，面板会显示不支持；也可以在 settings 的 Provider profile 中添加 balance 字段，包含 endpoint 与 auth：
balance
endpoint
auth
这些字段用于描述 Provider 的自定义余额接口。
安全与运行边界¶
密钥只通过 credentials.resolve 在 Host 进程内解析使用。余额请求由 Host 发出，浏览器端只拿到余额结果，密钥不进入前端或日志。
相关路由与接口：
/dsh-balance-panel
/user/balance
/dsh-balance-panel 路由只在回环 webServer 上注册，因此需要通过 localhost 回环访问 DSH Web UI。
适用场景与注意¶
适合在 DSH 中配置多个 Provider，并需要确认余额、密钥状态和模型范围的用户。
注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码与 MIT 许可证。 - 安装时使用 npm 包名
@wycto/dsh-balance-panel。 - 仓库路径在资料中存在不一致：插件线索与 README 来源指向
https://github.com/wycto/dsh-balance-panel，而package.json中的 repository 为https://github.com/wycto/dsh-model-balance.git。以 npm 包名作为安装依据更稳妥。
结尾¶
dsh-balance-panel 将 Provider 余额、密钥状态和模型配置集中到 DSH Web UI 的侧边栏。
社区目录页：
https://www.skillhub.cn/plugins/wycto/dsh-balance-panel
GitHub 链接：
https://github.com/wycto/dsh-balance-panel
