DeepSeek Harness (DSH) 採用插件化架構。在使用 MiniMax Token Plan 訂閱時，查看剩餘額度通常需要打開瀏覽器控制台或跳轉到 MiniMax 官網。dsh-minimax-usage 插件通過讀取官方的 Token Plan 用量接口，將剩餘額度直接顯示在 Web UI 的模型選擇器旁，方便在對話過程中快速確認狀態。
基本信息¶
- 名稱：dsh-minimax-usage
- 類型：客戶端插件
- 維護者：pan17
- 許可證：MIT
- 作用：在 DSH Web UI 中內聯顯示 MiniMax Token Plan 的 5 小時和 7 天剩餘進度條及詳情。
安裝與啓用¶
推薦使用 npm 安裝。安裝命令如下：
npx @deepseek-ai/dsh plugin --profile web add dsh-minimax-usage
安裝後需要重啓 DSH。
注意：npm 上 dsh 這個名字早在 2016 年就被一個不相關的 JS shell 包占用了，該包沒有暴露 CLI bin，會報 could not determine executable to run。DSH 的 CLI 在 scoped 包 @deepseek-ai/dsh 下，必須使用完整名稱。
如果遇到 pnpm 提示不允許跑構建腳本（ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED），需要在 profile 的 pnpm-workspace.yaml 中添加以下配置，然後重跑安裝命令：
allowBuilds:
dsh-minimax-usage: true
功能說明¶
1. 內聯用量條與懸停詳情¶
插件會在對話框的模型選擇器左側顯示一個緊湊的用量條，包含 5 小時和 7 天兩條剩餘進度。鼠標懸停或使用鍵盤聚焦該區域，可以查看國內站/國際站、套餐名、窗口進度和重置倒計時。
2. 按 Provider 顯示¶
只有噹噹前選擇的 provider 爲 minimax-cn 或 minimax Token Plan 時，用量條纔會顯示。如果選擇了其他 provider（即使模型名中包含 MiniMax），該區域也會保持隱藏。
3. 交互操作¶
- 點擊刷新：點擊用量條可強制刷新數據，不會改變當前的模型選擇或觸發發送操作。
- 密鑰來源：插件優先讀取 DSH 上下文中的憑據，其次讀取進程環境變量。國際站使用
MINIMAX_API_KEY，國內站使用MINIMAX_CN_API_KEY。
4. 自動刷新機制¶
插件的刷新邏輯如下：
* 運行時刷新：只有實際運行中的 Agent 使用 minimax 或 minimax-cn Token Plan provider 時，纔會每 30 秒強制拉取一次官方用量。
* 空閒刷新：當 Agent 回到空閒狀態且本輪使用過 MiniMax 後，會先等待 15 秒執行一次空閒刷新。之後心跳間隔從 2 分鐘起每次翻倍（2m, 4m, 8m…），上限爲 24 小時。再次使用 MiniMax 並空閒後，心跳重置回 2 分鐘。
* 重置刷新：每輪快照會在 5 小時窗口的重置時刻 + 30 秒後觸發一次“重置後刷新”，以第一時間拉取翻頁後的額度。
* 緩存讀取：用量條本身每 15 秒只讀 Host 緩存，點擊則強制刷新。
使用示例¶
- 在 DSH 的 設置 → 模型 中，填寫 MiniMax 的 Token Plan 訂閱 Key（注意：不能使用普通的按量付費 API Key）。
- 在對話框中選擇 MiniMax Token Plan 模型。
- 模型選擇器左側會出現用量條，懸停查看詳情，點擊刷新。
注意事項¶
- Key 類型區分：訂閱 Key 與普通開放平臺 API Key 不能混用。如果用量接口拒絕普通 Key，頁面會提示改用訂閱 Key。
- 數據展示：插件原樣展示官方剩餘額度，不進行本地“修正”扣費。
remains_time的語義以 MiniMax 控制台爲準。 - 零額度處理：
*_quota = 0的模型會顯示爲“未包含”，而不是 0%。 - 生態背景：DSH 的插件目錄（如 SkillHub）是獨立站點，與 DeepSeek 或幻方無官方從屬關係。
