前言¶

在 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 爲準。