前言¶

在 DeepSeek Harness（DSH）里用 MiniMax 编程套餐（Coding Plan）做对话或编码时，额度往往分「5 小时滚动窗口」和「周窗口」两档。控制台要切出去查，Harness 界面本身也不显示剩余比例，打到限流或周额度见底才发现，排障成本高。

dsh-minimax-quota 是维护者 woaiCarlos 提供的客户端插件：在当前会话选中 MiniMax 系列模型时，在对话输入框下方用一小块「药丸」展示两档剩余百分比，点开可看进度条、重置倒计时与更新时间。下面介绍它做什么、怎么装、怎么配 Key，以及使用时要注意的限制。

这是什么¶

插件不改动模型路由、不写会话事件，只在 UI 层拉取额度并展示。数据由 Host 半侧凭你已在 Harness 里配置的 MiniMax API Key 请求 MiniMax，再通过同源路由 /plugin/minimax-quota 把百分比和时间戳交给浏览器；密钥不会进前端。

核心功能¶

1. 出现条件：仅当当前会话的 provider 或模型名包含 minimax 时显示药丸；纯按量计费、无套餐额度的账号会自动隐藏。
2. 药丸摘要：例如 5小时 95% · 周 37%，每个数字旁有状态圆点——绿（>40%）、橙（≤40%）、红（≤15%）。
3. 详情面板：点击后展示各窗口剩余百分比、进度条、距离重置还有多久、数据更新时间。
4. 刷新：默认每 60 秒拉一次；鼠标悬停或点击时也会重新请求。
5. 主题与文案：支持明暗主题；文案走 Harness 的 locale 服务（内置中英文）。

浏览器侧拿到的 JSON 仅含额度与状态字段，例如：

{
  "ok": true,
  "intervalRemainingPercent": 95,
  "weeklyRemainingPercent": 37,
  "intervalResetAt": 1794316261854,
  "weeklyResetAt": 1794407213154,
  "intervalStatus": 1,
  "weeklyStatus": 1,
  "fetchedAt": 1794300583689
}

安装与启用¶

插件通过 GitHub 仓库分发，不依赖 npm。在终端执行（将 <你的 profile> 换成实际 profile 名）：

dsh plugin --profile <你的 profile> add github:woaiCarlos/dsh-minimax-quota

装完后打开 Harness 的 插件 → 已安装插件，找到「MiniMax 额度」并打开开关；重启 Harness 后同样生效。

前置条件：当前 profile 里需要已有 MiniMax 路由，且在 设置 → 模型 中为 MiniMax 供应商填好 API Key，插件才有额度可读。也可通过标准凭据方式提供 Key（见下一节）。

插件也可从本地插件市场的「发现」标签安装（索引条目指向带 commit 锁定的 GitHub 源）。目录页：skillhub.cn 上的插件条目。

凭据与配置¶

Harness 在模型设置页为 minimax-cn 路由写入的引用名是 MINIMAX_CN_API_KEY，与本插件默认查找名一致。因此在 设置 → 模型 里配好 MiniMax Key 后，无需额外配置 即可使用。

凭据解析顺序（第一个有值者生效）：

1. ~/.dsh/.credentials.yaml（模型设置页写入）
2. 启动时环境变量 MINIMAX_CN_API_KEY
3. 启动目录下的 .env
4. $DSH_HOME/.env 中的 .env

若 Key 挂在别的变量名上，可在插件的 cordis.patch.yml 中改 credentialRef：

- id: minimax-quota
  name: 'dsh-minimax-quota'
  config:
    credentialRef: MY_MINIMAX_KEY

仓库源码中不出现真实密钥；Host 侧通过 ctx.credentials.resolve 取值，仅用于请求 MiniMax，不会出现在路由响应里。

典型用法¶

1. 在 Harness 中为当前 profile 配置 MiniMax 供应商与 API Key。
2. 按上文命令安装插件并启用。
3. 在对话里选择 MiniMax 系列模型，输入框下方应出现额度药丸。
4. 需要看重置时间或刷新读数时，点击药丸打开详情面板。

实现上，index.js 负责解析凭据、调用 MiniMax、/plugin/minimax-quota 路由；client.js 在对话输入框下方注册 UI。Node 引擎要求 >=20.18（见 package.json）。

数据来源与工作原理（简述）¶

额度来自 MiniMax 未公开的控制台相关接口（路径可能在官方侧变动）。插件在 Host 侧对多个等价路径做兜底，例如：

GET https://api.minimaxi.com/v1/coding_plan/remains
Authorization: Bearer <你的 Key>

响应里 current_interval_remaining_percent、current_weekly_remaining_percent 已是「剩余百分比」，无需再用 100 减去已用量。注意：鉴权失败时 HTTP 仍可能为 200，需看 base_resp.status_code 是否为 0。

Host 插件声明了 inject: ['webServer']，以便在 web 服务就绪后注册路由；否则界面可能表现为「无法连接」。

适用场景与注意¶

适合：在国内 MiniMax Coding Plan 下用 DSH 日常对话 / 编码，希望在 Harness 内一眼看到 5 小时与周额度、避免突然限流。

务必留意：

• 插件以当前 dsh 进程权限 运行，安装前应自行查看仓库源码与 MIT 许可证，确认可接受其网络访问与凭据读取方式。
• 仅支持国内版 api.minimaxi.com；国际版 api.minimax.io 账号体系不同，密钥不通用。
• 接口未文档化，MiniMax 改路径后需等插件更新 QUOTA_ENDPOINTS。
• BYOK / 无套餐额度账号无药丸展示，属预期行为。

结尾¶

dsh-minimax-quota 把 MiniMax 编程套餐的两档剩余额度收进对话输入框下方，选中 MiniMax 模型即见摘要，点开即见重置与刷新时间；与 Harness 现有凭据配置对齐，多数情况下装好即用。

• 插件目录页：https://www.skillhub.cn/plugins/woaiCarlos/dsh-minimax-quota
• 源码与说明：https://github.com/woaiCarlos/dsh-minimax-quota