前言¶
在 DSH 的插件体系里，额度监控是一个比较具体的问题：同一个工作流可能同时调用多个供应商，有的看余额，有的看 5h / 7d / 1m 窗口，还有今日用量、缓存命中、429 限流等信息散落在不同接口里。
deepseek-harness-quota-monitor 是 marisa-4219 维护的一个 DSH 插件，许可证为 MIT。它把多供应商额度信息集中到侧边栏实时卡片和设置页配置里，支持余额型与限额型两类额度模型。
下面介绍它的功能、安装方式和典型配置。
这是什么¶
一句话定位：DeepSeek Harness 多供应商额度监控插件，提供侧边栏实时卡片和设置页可视化配置。
它解决的主要问题是：
- 同时监控多个 LLM 供应商的余额或窗口用量。
- 对已注册的官方供应商提供预设，减少重复配置。
- 对自建网关或自定义供应商，通过手动添加接入。
- 把今日已用、输入 / 输出 / 缓存分项、缓存命中率、429 限流事件放在同一监控界面。
核心功能¶
两类额度模型¶
这个插件支持两种额度模型。
余额型：主动查询供应商余额/用量 API，支持 API 地址、API Key 引用和 JS 解析器。
限额型：使用本地滑动窗口用量统计，支持 5h / 7d / 1m 等窗口，并持久化到：
$DSH_HOME/storages/quota-monitor-usage.jsonl
本地计量的边界要注意：它只统计经过 DSH 的请求。其他工具使用同一 API Key 的用量不会计入这里的本地窗口统计。
今日已用与折线图¶
插件提供“今日已用”统计：
- 按自然日桶统计。
- 跨重启保留。
- 附输入 / 输出 / 缓存分项。
- 附缓存命中率。
侧边栏的今日已用区域支持翻转卡片，查看输入 / 输出 / 缓存三线小时折线图。
供应商发现与启用¶
自动发现只覆盖有确定预设的官方供应商。无预设的自建网关或自定义供应商不会被自动发现，需要手动添加。
已支持的预设一键添加项包括：
deepseek-official
opencode-go
new-api
sub2api
在设置页“添加供应商”下拉中，会优先列出系统内已注册的 LLM 供应商，配置键名会自动使用其路由 id。
每个供应商都可以逐个启用或禁用监控。
金额与限流¶
金额显示按供应商 usage 返回价格。供应商没有返回价格表时，不推断金额。
限流方面，插件会记录 429 限流事件的 retry-after。
目前响应头级配额 x-ratelimit-* 拿不到，限流信息主要来自 429 错误。
安装与启用¶
安装前建议检查源码和许可证。插件以当前 dsh 进程权限运行，安装前应确认你信任其代码行为。
官方安装命令：
dsh plugin --profile web add deepseek-harness-quota-monitor
安装完成后，重启 dsh web 服务。
如果使用本地仓库开发，可以用开发模式安装：
dsh plugin --profile web add <本仓库路径>
典型用法¶
零配置¶
如果当前默认供应商是 deepseek-official，插件会自动使用内置余额解析器查询。API Key 会取 DEEPSEEK_API_KEY 凭据引用。
配置入口¶
配置可以放在设置页“额度监控”，也可以放在 profile 的 cordis.patch.yml 中。
可配置项包括：
refreshMs
cacheTtlMs
lowBalanceThreshold
showTodayUsed
windows
providers
其中：
refreshMs用于设置轮询间隔。cacheTtlMs用于设置余额查询缓存。lowBalanceThreshold用于设置低额阈值。showTodayUsed用于控制是否显示今日已用。windows用于设置限额窗口。providers用于配置各个供应商。
API Key 与解析器¶
API Key 以环境变量名作为凭据引用，值保存在 credentials 域，不直接写入配置。
JS 解析器可以配置为：
builtin
source
file
这样可以适配不同供应商返回的 JSON 结构。
查询接口¶
可以通过以下接口获取当前供应商和全部已配置供应商的快照数组：
GET /api/quota-monitor
测试¶
仓库提供测试脚本：
cd test
node verify-quota-e2e.mjs
node verify-patch-rewrite.mjs
e2e 测试需要真实凭据，会读取：
~/.dsh/.credentials.yaml
其中会用到：
OPENCODE_API_KEY
DEEPSEEK_API_KEY
适用场景与注意¶
适合使用 DSH web profile、需要集中查看多个供应商额度状态的开发者。
需要注意：
- 本地计量只统计经过 DSH 的请求。
- 响应头级配额
x-ratelimit-*目前拿不到，限流信息来自 429 错误。 - 侧边栏折叠态只显示第一个默认供应商的紧迫信息。
- 余额查询结果有 60s 缓存，修改配置后最多 60s 内生效。
- 无预设的自建/自定义网关不会被自动发现，需要手动添加。
链接¶
GitHub：
https://github.com/marisa-4219/deepseek-harness-quota-monitor
目录页线索：
https://www.skillhub.cn/plugins/marisa-4219/deepseek-harness-quota-monitor
该目录页 URL 来自插件线索，访问前以实际站点为准。
