前言¶
在 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 | src/index.js |
60 秒向上游轮询 + 注册两个 HTTP 路由 |
| Client | client/client.js |
5 秒轮询 host + 在 conversation.input.left 挂载 dock UI |
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。
可选环境变量如下：
| 变量 | 默认值 | 用途 |
|---|---|---|
MMX_API_KEY |
必填 | 用于 MiniMax Bearer + x-api-key |
MMX_REGION |
cn |
cn 对应 api.minimaxi.com，global 对应 api.minimax.io |
MMX_REFRESH_MS |
60000 |
Host 对上游的轮询间隔 |
MMX_POLL_INTERVAL_MS |
5000 |
Client bundle 的拉取间隔 |
环境要求：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 为准。
