前言¶

在 DSH web 里使用 MiniMax token 套餐时，有一个常见的不便：当前 5h 窗口用了多少配额，界面上看不到，要确认只能自己另开上游页面查询，再切回来安排任务节奏。

mmx-quota-tool 把这个数字搬进了会话输入区：一个水滴形图标加上 5h 用量百分比，点开还有明细面板。下面介绍它的功能、安装步骤和注意事项。

这是什么¶

mmx-quota-tool 是面向 DSH web 的插件，由 mtty-ai 维护，README 的一句话定位是：

MiniMax token-plan quota dock for DSH web — drop-shape 5h usage %, click for detail panel, auto-hides for non-MiniMax models.

也就是一个挂在会话输入区的配额 dock：显示 5h 用量百分比，点击打开详情面板，当前模型不是 MiniMax 时自动隐藏。当前版本 0.1.0，许可证为 MIT。

核心功能¶

1、dock 常驻显示。挂载点在 conversation.input.left，即模型选择器旁边，水滴形图标按 5h 用量百分比填充（条越低用量越健康）。

2、颜色分级：< 50% 绿色、< 80% 黄色、≥ 80% 红色。

3、详情面板。点击图标展开，列出每个模型的 5h 与每周用量、重置倒计时和绝对数值。

4、自动隐藏。活跃默认模型不是 MiniMax 时整个 dock 隐藏，匹配规则为 provider 名 minimax / minimax-cn / minimax-global / MiniMax*，或模型名前缀 MiniMax- / minimax-。

5、交互细节。Shift+click 强制立即向上游刷新；鼠标离开 dock 或面板时关闭面板。

6、界面语言跟随 DSH。模型名称标签支持 zh / en 两套文案（如 zh 的 通用 / 视频 / 图像 / 音频 / 语音 / 音乐 / 视觉 / 向量 / 实时 / 长文本），默认 zh；语言服务不可用时 dock 仍正常渲染。

工作方式¶

插件分 Host 和 Client 两半：

Host 在 profile 的 webServer 上注册两个路由：

GET  /api/mmx-quota-tool/quota    # 当前快照
POST /api/mmx-quota-tool/refresh  # 强制刷新

quota 接口返回包含 rows、lastFetchedAt、lastError、lastStatus、model、isMmx、refreshIntervalMs 的对象。

Client 每 5 秒轮询 host 的 quota 接口，isMmx === false 时渲染 null——所以切到非 MiniMax 模型后，dock 会在 5 秒内消失。真正的上游拉取节奏由 MMX_REFRESH_MS 控制。

安装与启用¶

官方安装命令：

dsh plugin --profile web add github:mtty-ai/mmx-quota-tool

安装完成后重启一次 dsh web。

开发场景下也可以手动安装。先把仓库复制进 profile 的 node_modules：

git clone https://github.com/mtty-ai/mmx-quota-tool
cd mmx-quota-tool
cp -R . ~/.dsh/profiles/web/node_modules/mmx-quota-tool/

再在 ~/.dsh/profiles/web/cordis.patch.yml 中加入一行注册插件：

- insert:
    - id: mmx-quota-tool
      name: mmx-quota-tool

配置¶

插件必须提供 MiniMax API key，启动 dsh web 前先导出：

export MMX_API_KEY='sk-cp-your-key-here'
dsh web

也可以把 export 写进 ~/.zshrc 或 ~/.bashrc。

可选环境变量如下：

环境要求：Node.js >= 20，peerDependency 为 @deepseek-ai/cordis ^4.0.1。

典型用法¶

1、日常观察：进会话后看模型选择器旁的百分比和颜色，黄灯说明 5h 用量已过 50%，红灯说明已到 80% 以上。

2、看明细：点击图标，面板里逐模型列出 5h 与每周用量、重置倒计时和绝对数值；鼠标移开即关闭。

3、数据存疑时：Shift+click 图标，立即向上游刷新一次，不用等 60 秒轮询周期。

4、双区用户：账号在 cn 区就不用动；走 global 区的需要设置 MMX_REGION=global 后重启 dsh web。

5、切换界面语言：dock 标签与面板的标题、脚注提示都会随 DSH 的 zh / en 界面语言一起切换，无需单独配置。

适用场景与注意¶

适合在 DSH web 里绑定了 MiniMax token 套餐、想随时掌握 5h 和每周用量的开发者。即便装了插件，非 MiniMax 模型下它会自动隐藏，不占用界面。

几点注意：

1、MMX_API_KEY 必填，缺了拿不到配额数据；这个 key 以 MiniMax Bearer + x-api-key 的形式向上游请求。

2、插件以当前 dsh 进程的权限运行，能够读到你所配置的环境变量。安装前建议先审查仓库源码和许可证（MIT），确认可接受再装入 profile。

3、数据有两层延迟：host 对上游默认 60 秒，client 对 host 默认 5 秒。要更及时就 Shift+click 手动刷新，或调低 MMX_REFRESH_MS。

结尾¶

mmx-quota-tool 做的事情很集中：把 MiniMax token 配额从「另开页面查」变成会话里的一个常驻图标，配合颜色分级和强制刷新，用量管理不需要离开当前工作流。

• GitHub 仓库：https://github.com/mtty-ai/mmx-quota-tool
• 社区插件目录页：https://www.skillhub.cn/plugins/mtty-ai/mmx-quota-tool

社区目录为独立站点，与 DeepSeek、幻方无官方从属关系，收录信息以仓库 README 为准。