前言¶
在使用 DeepSeek Harness (DSH) Web 进行多模型管理时，手动检查不同 Provider 的余额和健康状态会消耗大量时间。dsh-balance-quota 插件将余额查询、配额监控以及外部模型健康监测集成到 DSH Web 的界面中，直接在聊天界面的下方展示状态信息。
是什么¶
这是一个由 kongshan-zhuyu 维护的模型推理插件，旨在为 DSH Web 提供可视化的 Provider 余额和健康监控能力。
- 核心功能：支持官方预设、自定义 HTTP 接口、JSON 数据提取与转换、以及模型健康状态监测。
- 开源协议：MIT
- 适用场景：需要统一管理多个 API Provider、需要监控模型可用性及响应时间（TTFT/延迟）的开发者。
核心功能¶
插件通过界面下方的状态栏和独立配置页，实现以下能力：
余额与配额管理¶
- 官方预设：内置 DeepSeek 余额和 OpenCode Go 的滚动/每周/每月配额查询。
- 自定义接口：支持 Public HTTPS、无 Body 的 POST 请求，可配置自定义 Headers、超时时间和刷新间隔。
- JSON 提取：支持属性路径、数组索引、可选链，并提供最多 5 个
??后备值。 - 金额处理：支持静态/动态货币、金额除数配置，并提供“未保存草稿测试”功能。
界面与交互¶
- 状态栏：在聊天编辑器下方显示余额、更新时间、强制刷新按钮及健康监测图标。
- Provider 选择：支持默认 Provider 设置、行内切换 Provider，并记忆每个对话的上下文选择。
- 模型设置：管理模型 ID/显示名、上下文窗口、文本/图片输入能力及推理等级。
- 可视化绑定：选择预览槽位后，直接从 JSON 树中选择字段，预览实时更新。
- 全模型预览：无需额外请求即可预览多达 50 个模型的当前映射关系。
健康监测¶
- 外部监控：通过外部 JSON API 监控状态、可用性、TTFT（首字生成时间）、响应时间及历史记录。
- 转换与格式化：支持文本、数字、百分比、状态值的转换。支持自定义状态值映射、数值精度（0-2位小数）及单位显示。
- 自定义指标：可监控错误率、空响应、常见错误或任意模型指标。
安全与性能¶
- 缓存机制：共享 Host 余额缓存、健康预览缓存，在插件隐藏时自动暂停刷新。
- 凭证安全：复用 DSH 凭证引用，API 密钥不会直接进入浏览器配置。
- 网络防护：支持 Public HTTPS、DNS 绑定、重绑定保护，以及阻止私有 IP 和重定向访问。
安装与启用¶
环境要求¶
- Node.js 22+
- DSH CLI
安装步骤¶
- 使用 DSH CLI 安装插件：
dsh plugin --profile web add dsh-balance-quota
- 安装或升级后，需重启
dsh web进程：
dsh web
- 验证安装是否成功：
dsh plugin --profile web list
配置与使用¶
- 打开 Settings → Plugins → Plugin configuration → 供应商状态。
- 在此处配置余额查询、Provider 编辑、高级设置、默认 Provider 以及聊天状态栏。
- 点击 编辑 配置自定义余额 API，或使用官方预设。
- 高级设置 包含 模型设置 和 健康监测。
- 在健康监测中，启用监控后测试外部 JSON 接口，并使用 预览全部模型 验证所有映射关系。
注意事项与适用场景¶
- 版本兼容性：
- 插件开发版本为 0.3.5，NPM 发布版本为 0.3.3。
- 若使用 DSH 0.3.4，需搭配 DSH 0.1.5-rc.1 或更新版本（
@deepseek-ai/dsh-settings≥0.1.5-rc.2）。 - 若使用 DSH 0.1.4 及更早版本，请使用插件版本 0.3.3。
- 源码审查：插件以 DSH 进程权限运行，请在使用前检查源码与许可证（MIT）。
- 生态说明：本插件属于社区目录中的独立项目，与 DeepSeek / 幻方无官方从属关系。
总结¶
dsh-balance-quota 解决了在 DSH Web 中分散管理余额和模型健康状态的问题。通过可视化的绑定、转换和缓存机制，它为开发者提供了一个安全、高效的后台监控解决方案。
- 插件目录: https://www.skillhub.cn/plugins/kongshan-zhuyu/dsh-balance-quota
- 源码仓库: https://github.com/kongshan-zhuyu/dsh-balance-quota
