在 DeepSeek Harness (DSH) 的开发流程中，管理多个模型提供商的路由和配额是常见需求。查看账户余额通常需要跳转到外部平台或调用接口，缺乏直观的监控入口。dsh-provider-billing 插件直接在模型设置页面的每个提供商行内展示账户余额，并提供刷新控制，通过 loopback-pinned RPC 通道实现查询，确保 API 密钥始终保留在主机端。
核心功能¶
该插件主要实现以下能力：
- 行内展示：在模型设置页面的每个提供商行内显示一行余额信息。
- 手动刷新：为每条路由提供刷新控制，允许手动更新余额数据。
- 安全性：API 密钥从不离开主机，浏览器仅发送路由 ID，由主机负责从配置平面解析端点和凭据。
- 标准接口：调用提供商的 OpenAI 兼容
/user/balance端点进行查询。
安装与配置¶
插件可以通过 npm、GitHub 或本地路径安装。安装后需要在配置平面中指定要监控的 providers。
安装¶
使用以下命令之一进行安装：
dsh plugin --profile web add dsh-provider-billing
或通过 GitHub 安装：
dsh plugin --profile web add github:ZeroingIn/dsh-provider-billing
配置¶
在 DSH 的配置平面中添加插件实例，并指定要检查的 providers 列表：
- id: provider-billing
name: dsh-provider-billing
config:
providers: [deepseek-official]
工作原理¶
插件分为主机端和浏览器端两部分：
- 主机端：注册了一个 loopback-pinned 的 RPC 通道（
/provider-billing），提供list和query两个端点。它从配置平面解析路由的端点和凭据，然后向提供商的/user/balance端点发起请求。 - 浏览器端：注入到模型设置页面的
settings.models.row插槽中，渲染余额卡片（支持中英文显示）。如果当前 Harness 构建不支持该插槽，插件会明确报告加载失败。
注意事项¶
- 版本要求：插件依赖 Harness 的
settings.models.row插槽，因此需要较新的 Harness 构建。不支持旧版本，旧版本会直接报错。 - 构建产物：npm 发布的 tarball 默认不包含
lib/types目录（除非在发布机器上执行了pnpm build），但这不影响运行时功能。 - API 兼容性：插件调用的是
/user/balance接口，仅适配 DeepSeek 官方接口规范，其他自定义接口会返回错误信息。
总结¶
dsh-provider-billing 通过在模型设置页面提供直观的余额展示和刷新控制，简化了多提供商路由的配额监控流程。所有敏感操作均在主机端完成，安全性较高。插件由社区维护者 ZeroingIn 开发，遵循 MIT 许可证。
