前言¶
在 DeepSeek Harness（DSH）里同时接入多家模型服务商时，账户余额、订阅套餐窗口、重置时间这些信息通常散落在各家控制台和页面里，要来回切换才能确认还剩多少可用额度。dsh-model-quota 是一个客户端分类的 DSH 插件，把这些信息集中到一个设置页面里查看，由 zhangmin510 维护。下面介绍它的功能范围、安装方式、授权流程和使用时需要注意的边界。
这是什么¶
dsh-model-quota 在 Harness 的 设置 → 模型余量 页面集中显示当前已配置服务商的余额、套餐窗口剩余百分比和重置时间，支持中文／英文与宿主浅色／深色主题。界面展示的额度是直接向服务商接口查询的结果；插件按需刷新，不轮询、不发送推理请求、不修改模型配置。
运行时要求 Node.js 22 或以上，无 npm 运行依赖、无安装脚本、无构建步骤，原生 ESM 直接运行。实际验证环境为 Desktop 0.2.1-rc.5。项目许可为 MIT，星标数为 0，属于社区维护的插件，不是 DeepSeek / 幻方的官方组件。
支持的服务范围¶
插件目前覆盖以下服务商的额度查询：
| 服务商 | 显示内容 | 认证来源 |
|---|---|---|
| DeepSeek API | 账户余额 | Harness 当前配置的 API Key |
| DeepSeek 已登录账户 | 充值／赠送余额 | Harness 账户服务 |
| 千问／阿里云 Token Plan（个人／Solo） | 服务端返回的小时／日／周／月窗口 | 百炼 CLI 的独立控制台登录 |
| 智谱／Z.AI Coding Plan | 5 小时、周、工具月额度及重置时间 | Harness 当前配置的 API Key |
| OpenRouter | Key 消费上限剩余金额、已用金额 | Harness 当前配置的 API Key |
| SiliconFlow | 账户余额 | Harness 当前配置的 API Key |
| OpenAI Codex 旧版订阅路由 | 套餐窗口剩余百分比 | 尚未过期的 Codex OAuth 登录 |
识别口径上有几个要点：
- 只识别相应官方 HTTPS 域名；自定义代理和没有接入余量接口的服务商明确显示「暂不支持」。
- OpenAI 普通 API／新版直连 OAuth 不会被当作旧版 Codex 查询。
- 服务商接口变化时显示失败，插件不使用本地 Token 用量推算余额。
- 额度由账户、Key 或套餐共享，不是每个模型独立拥有；不同币种不累加，同一账户经不同认证路由返回的余额也不累加。
- OpenRouter 未设置 Key 消费上限不代表账户有无限余额。
安装与启用¶
安装命令来自 README，可让 Harness Agent 执行：
安装插件：github:zhangmin510/dsh-model-quota#v1.2.1
对应的 plugin_manager 操作是 install_bundle，target 为上述 GitHub 安装标识。安装影响当前 profile 的全部会话并持久保留；升级后若提示需要重启，应重启 Harness。也可以克隆仓库后以目录绝对路径安装；本地目录安装链接源码目录，需要保留该目录。
典型用法¶
启用后打开 设置 → 模型余量 即可查看已配置服务商的额度，页面上按需点击刷新。其中千问 Token Plan 的授权与推理 Key 是两套机制，模型调用的 API Key 不能代替控制台授权。插件复用百炼 CLI，不读取浏览器 Cookie、不自动打开登录页、也不直接读取 CLI 凭据文件。按下面三步配置：
1、安装百炼 CLI：
npm install -g bailian-cli
本插件验证版本为 2.8.2，该版本的 usage token-plan --output json 会返回个人套餐的滚动窗口。
2、使用与模型 Key 相同的阿里云账户，在浏览器完成独立配置的登录：
bl auth login --console --config model-quota-console --console-site domestic
这里使用独立配置 model-quota-console，因为控制台登录可能创建普通百炼 API Key，需要避免覆盖已有的 Token Plan 模型配置。国际站使用对应国际控制台登录；查询区域取自已配置的 Token Plan 端点。
3、在插件页面点击「刷新余量」。只返回月度窗口的套餐仅显示月度额度；缺失窗口不补零、不推定无限；无消费数据或无窗口时显示「未返回额度」。企业／Team 汇总积分池不在此适配器支持范围内。
页面会显示来源提醒：套餐额度来自该 CLI 配置所登录的控制台账户，无法仅凭推理 Key 自动核验是否同一个账户。若提示找不到 CLI，给 tokenPlan.cliPath 设置可执行文件绝对路径；登录过期时按页面显示的命令重新授权即可，插件不会自动刷新登录或切换 CLI 活动配置。
插件通过 Bundle patch（cordis.patch.yml）提供默认值，全部字段在插件加载时验证，修改配置应通过 Loader 的正常配置流程，不直接手工写 profile 文件。主要配置项如下：
| 字段 | 默认值 | 限制／用途 |
|---|---|---|
requestTimeoutMs |
12000 |
额度 HTTP 请求超时，100–120000 毫秒 |
concurrency |
4 |
同时查询的服务商数，1–8 |
tokenPlan.cliPath |
bl |
百炼 CLI 可执行文件路径 |
tokenPlan.profile |
model-quota-console |
已授权的 CLI 配置名称 |
tokenPlan.timeoutMs |
20000 |
CLI 查询超时，100–120000 毫秒 |
tokenPlan.maxOutputBytes |
262144 |
每个 CLI 输出流的内存上限，1024–1048576 字节；不写磁盘 |
tokenPlan.graceMs |
1000 |
托管进程树终止宽限期，0–10000 毫秒 |
安全与生命周期¶
插件里有一个与页面共用查询实现的只读 Agent 工具 model_quota；工具结果由 Harness 记录到会话，页面查询不自动写入会话。返回值包含服务商、模型、金额／百分比、时间、CLI 来源配置名称和有限错误代码，不含密钥、令牌及上游原始错误正文。
HTTP 入口遵循 Harness Connection 的 Host／Origin 和浏览器认证检查；服务商 HTTP 请求禁止重定向。密钥只在 Host 侧通过当前 credential service 解析，Codex 凭据只读且不刷新。CLI 通过无 shell 的固定只读参数调用，环境不继承模型 Key、云凭据、Cookie 或 SSH agent；查询超时或取消会终止并等待插件拥有的 CLI 子进程退出。卸载会中止 HTTP 查询并等待已开始的操作结束。
适用场景与注意¶
适合在 DSH 中同时使用多个模型服务商、需要定期确认余额和套餐窗口的开发者。几点注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证文件。
- 只做额度查询，不负责充值、切换模型或自动降级；额度不足时仍需到对应服务商侧处理。
- 服务商接口变化或鉴权失败时显示失败，不会用本地统计值替代真实额度。
- 目录页与 GitHub 仓库见下方链接，安装前可对照 README 确认最新支持范围。
插件目录页：https://www.skillhub.cn/plugins/zhangmin510/dsh-model-quota
GitHub 仓库：https://github.com/zhangmin510/dsh-model-quota
