前言¶

在 DeepSeek Harness（DSH）里同时配置 DeepSeek Account、OpenCode Go、GLM Coding、Kimi Code 等多家供应商时，「还能不能接着用」往往要分别打开各家控制台：按量计费要看账户余额，套餐制要看 5 小时、每周或每月窗口的剩余比例。会话切到不同模型商时，更需要一眼能对上当前对话用的是谁、还剩多少。

下面介绍社区插件 dsh-model-quota（维护者 Leafmy）：在 Web 界面侧栏底部常驻一张额度卡片，点击后在右侧展开面板，把多家供应商的余额或套餐窗口读数聚在一处；卡片会跟随当前会话的模型商切换显示。插件归类为客户端，零额外 npm 依赖，凭据只在宿主进程内解析与请求，不下发浏览器。

这是什么¶

dsh-model-quota 是 DSH 的模型余额与额度面板插件。宿主侧注册 API 路由、按目录拉取各供应商用量；客户端注入侧栏 sidebar.footer.action 与设置页 settings.section 槽位。默认只显示 DeepSeek Account；其余供应商在检测到已配置凭据后自动出现，也可在「设置 → 额度面板」里逐个开关。

• 仓库：github.com/Leafmy/dsh-model-quota
• 社区目录：skillhub.cn/plugins/Leafmy/dsh-model-quota
• 许可证：MIT
• 当前包版本（资料记载）：1.0.0

核心功能¶

侧栏卡片与面板¶

侧栏底部有一张额度卡片；点开后右侧面板逐行列出各供应商状态。卡片展示的 provider 与当前会话 modelSelection.lastUsed.provider 一致（README 在 DSH 0.2.1-rc.1 上实测）。

余额型显示（DeepSeek Account / API 等）¶

带赠金或赠送余额的供应商：

1. 开启「赠金优先显示」且仍有未用完赠金时，大号数字显示赠金，右侧绿底白字「赠金」标；赠金下方灰色小字显示正常余额。
2. 无赠金或关闭赠金优先时，直接显示正常余额。

数字与「赠金」标颜色（默认阈值，可在设置页修改）：

「赠金参与告警颜色计算」默认开启：有赠金按赠金判色，赠金用尽后按余额；关闭则只看余额。

套餐型显示（进度条）¶

OpenCode Go、GLM Coding、Kimi Code、MiniMax 等套餐供应商：面板与卡片按所选窗口（默认 5 小时，可选每周 / 每月）显示剩余百分比与重置时间。颜色默认：剩余 ≥ 20% 绿、≥ 5% 黄、< 5% 红；0% 为空条不填充。百分比阈值可在设置页调整。

支持的供应商目录（摘要）¶

插件内置目录覆盖 DeepSeek Account、DEEPSEEK_API_KEY、Moonshot、Kimi Code 订阅、GLM / Z.AI Coding、OpenCode Go、OpenRouter、SiliconFlow、MiniMax、StepFun、xAI 等；各 id 对应的环境变量与官方接口见仓库 README 表格。可通过 cordis.patch.yml 的 providers 覆盖显示名或按已有 format 解析器接入自建网关。

降级行为¶

插件只使用 DSH 公开面（如 ctx.credentials.resolve、ctx.deepseekAccount、webServer.register、客户端槽位与会话投影）。若将来某条「缝」不可用，设计为降级而非崩溃：卡片退回配置的 primary 供应商，单行显示明确错误原因。

安装与启用¶

目标 DSH 版本为 0.2.1-rc.1；README 记载 0.2.1-rc.1、0.2.0-rc.2（1.0.0 验证基线）已实测，其它版本未做兼容承诺。

方式一：GitHub Release（推荐）¶

直接从 tag 源码包安装（README 标注本机已实测可用）：

dsh plugin --profile <你的 profile 名> add https://codeload.github.com/Leafmy/dsh-model-quota/tar.gz/refs/tags/v1.0.0

或从 Releases 下载 dsh-model-quota-1.0.0.tgz 后：

dsh plugin --profile <你的 profile 名> add ./dsh-model-quota-1.0.0.tgz

装完后完全退出并重开 DSH Desktop（客户端在启动时组装，仅刷新页面不够）。

升级时将 URL 中的 tag 换成新版本；更干净的做法是先移除再安装：

dsh plugin --profile <profile> remove dsh-model-quota

方式二：本地路径¶

dsh plugin --profile desktop add file:/绝对路径/dsh-model-quota

包内 cordis.patch.yml 已 insert id: dsh-model-quota，不要在用户层再 insert 同一 id；改配置请在 profile 的 cordis.patch.yml 用同 id 覆盖。

典型用法与配置¶

日常使用¶

1. 在 DSH 中照常配置各供应商 API Key 或 DeepSeek 账号登录。
2. 重启 Desktop 后看侧栏底部卡片；切换会话模型商时观察卡片是否跟随。
3. 打开「设置 → 额度面板」调整显示开关、赠金优先、窗口优先级与颜色阈值。

profile 配置项¶

在 ~/.dsh/profiles/<profile>/cordis.patch.yml 中，对 - id: dsh-model-quota 的 config 可设置：

示例：把卡片主显示改为 OpenCode Go，并隐藏部分供应商；自建网关复用 openrouter-credits 解析器：

- id: dsh-model-quota
  config:
    primary: opencode-go
    hide: [xai, stepfun]
    providers:
      deepseek:
        label: DeepSeek 官方
      my-gateway:
        label: 自建网关
        refs: [MY_GATEWAY_KEY]
        endpoint: https://gw.example.com/v1/credits
        format: openrouter-credits
        currency: $

新增自定义供应商时 endpoint、format、refs 必填，format 须为 README 所列已注册解析器之一。

适用场景与注意¶

适合谁：长期在 DSH Desktop 多供应商切换、希望侧栏一眼看到余额或套餐窗口的开发者；已配置 DeepSeek Account 或多家 API Key 的环境即可受益。

运行与信任：插件以当前 DSH 进程权限访问凭据并请求各家官方 API；安装前建议阅读源码与 MIT 许可证，确认接受其网络行为。密钥不进入浏览器，但宿主侧仍会发起出站请求。

生态说明：DSH 社区插件目录（如 SkillHub）由社区维护，与 DeepSeek / 幻方无官方从属关系；本文安装命令与配置均来自插件 README，勿凭插件名自行拼接未文档化的 dsh plugin add 形式。

卸载：从 profile package.json 的 dsh.profile.bundles 去掉 "dsh-model-quota"，删除 cordis.patch.yml 中对该 id 的覆盖行，执行 dsh plugin --profile desktop remove dsh-model-quota（或删除对应 node_modules 链接），再重启 DSH。

结尾¶

dsh-model-quota 把「各家控制台查余额、查套餐」收成侧栏一张卡片加一个面板，并跟随当前会话模型商；对多供应商 DSH 工作流是实用的客户端补充。详情与兼容性表、完整供应商目录见 GitHub README。

• 目录页：https://www.skillhub.cn/plugins/Leafmy/dsh-model-quota
• GitHub：https://github.com/Leafmy/dsh-model-quota