kongshan-zhuyu/dsh-balance-quota--packages-dsh-balance ↗★ 0
dsh-balance-quota
DeepSeek Harness Web plugin for secure provider balance, quota, and model health monitoring
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:kongshan-zhuyu/dsh-balance-quota#d6cd4b3fb1a29ec178b9b06a65289ddb82dba199&path:packages/dsh-balance说明文档
阅读完整 README ↗健康监测使用方法
入口:供应商状态 → 高级设置 → 健康监测。
健康监测只读取第三方监控数据,不请求模型聊天接口,不消耗模型额度。
1. 测试接口
填写公网 HTTPS JSON 接口,点击 测试。成功后左侧显示完整 JSON 树,并缓存预览供下次编辑使用。
2. 绑定模型列表
先点击右侧 模型列表,再点击左侧数组节点,例如:
$.models
$.services
模型列表是其他字段的作用域,必须最先绑定。
3. 绑定监测字段
点击右侧字段槽位,再点击左侧模型项中的字段。
| 字段 | 示例 | 用途 |
|---|---|---|
| 模型名称 | $.model | 健康卡片标题 |
| 分组 | $.group | 模型分组标签 |
| 健康状态 | $.health | 正常/失败/警告/未知 |
| 可用率 | $.success_rate | 百分比和近似历史条 |
| TTFT | $.avg_ttft_ms | 首 Token 延迟 |
| 响应耗时 | $.avg_resp_sec | 请求响应时间 |
| 最近记录 | $.history | 历史状态数组 |
| 历史状态 | $.ok | 每条历史记录状态 |
| 历史时间 | $.ts | 每条历史记录时间 |
| 历史错误 | $.error | 每条历史记录错误 |
绑定后右侧卡片立即刷新,无需重新请求接口。点击 预览全部模型 可检查全部映射结果。
4. 选择数据转换
| 转换 | 适用数据 | 行为 |
|---|---|---|
| 原文 | 文本、错误信息 | 原样显示 |
| 数字 | 延迟、计数 | 转为数值并应用单位和精度 |
| 百分比 | 可用率、成功率 | 自动、强制 ×100 或原值加 % |
| 状态 | ok、warn、布尔值等 | 转为正常/失败/警告/未知 |
状态值映射
当接口使用自定义状态值时,点击 值映射:
healthy → 正常
warning → 警告
offline → 失败
配置映射后,未命中的值显示为“未知”,不会误用内置词表。
百分比倍率
- 自动:
0–1自动乘 100,其他值按百分数处理; - ×100:始终乘 100;
- 原值加 %:接口值已经是百分数。
数字单位和精度
选择 数字 后出现三个设置:
| 设置 | 可选值 |
|---|---|
| 接口单位 | 接口 ms、接口 s |
| 显示单位 | 显示跟随、显示 ms、显示 s |
| 小数位 | 整数、1 位、2 位 |
例如接口返回 1.25 秒,选择 接口 s + 显示 ms + 整数,显示结果为 1250ms。
5. 添加自定义字段并保存
点击指标区域的 +:
- 输入名称,例如“常见报错”;
- 点击字段卡片;
- 在左侧选择字段,例如
$.last_errors[0]; - 选择原文、数字、百分比或状态;
- 点击 保存监测源。
空白自定义字段不会提交;名称和路径会自动清除前后空格。
配置示例
Input
接口: https://status.input.im/api/status
模型列表: $.services
模型名称: $.model
状态: $.last.ok
可用率: $.uptime_pct
历史: $.history
Neco
接口: https://speed.sbbbbbbbbb.xyz/api/pulse?window=604800
模型列表: $.models
模型名称: $.model
状态: $.health
可用率: $.success_rate
TTFT: $.avg_ttft_ms
响应耗时: $.avg_resp_sec(接口单位选择 s)