前言¶
DeepSeek Harness（DSH）通過 @deepseek-ai/dsh-llm-pi-ai 已經能走 MiniMax 國內（minimax-cn）與國際（minimax）兩條 Anthropic Messages 路由，但模型目錄仍偏舊、Key 要在「設置 → 模型」裏按提供商逐項添加，也沒有 M Plan 額度視圖。若你主要用 MiniMax 開放平臺（api.minimaxi.com / api.minimax.io）的 MiniMax-M3.1-Flash 與 MiniMax-M3，更希望在一個設置頁粘貼 Key、在模型選擇器裏直接選官方路由，社區插件 dsh-llm-minimax（維護者 elfgzp，分類：模型推理）補的是配置與 UI，而不是再寫一套模型適配器。下面介紹它做什麼、怎麼裝、怎麼用，以及和自帶能力之間的邊界。
這是什麼¶
dsh-llm-minimax 把 MiniMax 官方開放平臺的模型寫進 DSH 模型選擇列表：在 設置 → MiniMax 粘貼 API Key，校驗通過後可在輸入框模型選擇器裏選 MiniMax 國內 → MiniMax-M3.1-Flash（或 MiniMax-M3），並查看 M Plan / Token Plan 的套餐額度窗口。插件不實現新的 LLM 適配器，而是在現有 minimax-cn / minimax 路由上更新模型目錄、思考檔位行爲、憑據寫入與額度展示。
- 目錄頁：https://www.skillhub.cn/plugins/elfgzp/dsh-llm-minimax
- 源碼與說明：https://github.com/elfgzp/dsh-llm-minimax
- 當前 package 版本：0.1.0（MIT）
核心功能¶
模型目錄與思考行爲¶
插件內置的目錄聚焦 MiniMax-M3.1-Flash、MiniMax-M3，不寫已退役的 M2.x；M2.5 / M2.7 系列將於 2026-11-18 退役（資料中的時間表以 MiniMax 公告爲準）。相對 DSH 自帶目錄，插件還會打開 forceAdaptiveThinking，使選擇器上的思考檔位以 output_config.effort 發出；MiniMax-M3.1-Flash 始終思考，不提供「關閉思考」（關閉會返回 400）。
| 模型 | 上下文 | 默認最大輸出 | 思考 |
|---|---|---|---|
| MiniMax-M3.1-Flash | 1,000,000 | 131,072（上限 524,288） | 始終思考；深度可選 low … max |
| MiniMax-M3 | 1,000,000 | 131,072（上限 524,288） | 自適應；可選關閉或 low … max |
你在「設置 → 模型」裏爲該路由手動添加的其它模型條目會保留；插件不會改路由上的 baseURL、retryPolicy、headers 等，但會在配置變化時檢查目錄並補全缺項。
設置頁填 Key 與憑據¶
- 打開 設置 → MiniMax。
- 在「API Key」粘貼 Key，點 校驗並保存；區域默認自動識別（先試國內，再試國際）。
保存時任一步失敗則不會寫入。成功時插件會：
- 用
GET /v1/models校驗 Key 並區分國內 / 國際； - 將 Key 寫入本機
$DSH_HOME/.credentials.yaml，引用名爲MINIMAX_CN_API_KEY/MINIMAX_API_KEY（與「設置 → 模型」頁一致）； - 在
llm-pi-ai中啓用對應路由並寫入當前模型目錄。
Key 僅在宿主進程內流轉，瀏覽器側只顯示末 4 位。
輸入框工具欄（僅官方 MiniMax 路由）¶
選中 minimax-cn / minimax 官方路由時，模型選擇器左側會出現：
| 控件 | 含義 |
|---|---|
▣ 1M |
上下文預算，可選 200K / 512K / 1M |
● MiniMax 62% |
套餐額度；懸停可見 5 小時與每週窗口的剩餘與重置時間 |
換成騰訊內網網關、DeepSeek、GLM 等其它模型時，這兩個控件會消失。選擇器裏可能出現兩個 MiniMax 分組：帶 x0.08 倍率的是內網轉發，控件只在 minimax-cn 分組下的官方 API 條目上出現。
額度¶
額度來自 GET /v1/token_plan/remains，約每分鐘刷新。M Plan / Token Plan 訂閱 Key（sk-cp- 或有訂閱的賬號 Key）會顯示各用量桶窗口與每週窗口的剩餘百分比與重置倒計時；按量付費 Key（sk-api-）因 MiniMax 不提供餘額查詢接口，僅附控制台說明、不顯示數字。接口 HTTP 200 時仍可能業務失敗，插件按 base_resp.status_code 處理（如 2062 無生效訂閱，1004 / 2049 Key 或區域問題）。
安裝與啓用¶
需要 DeepSeek Harness 0.2.x。插件以當前 DSH 進程權限運行，安裝前建議瀏覽倉庫源碼與 MIT 許可證。
Web 界面：側邊欄 → 插件 → 添加插件 → 安裝第三方插件，粘貼倉庫地址：
https://github.com/elfgzp/dsh-llm-minimax
確認後在「已安裝插件」裏打開 MiniMax 模型。
在 agent 會話中（需開啓插件管理工具）：
從 https://github.com/elfgzp/dsh-llm-minimax 安裝這個插件並啓用
命令行：
dsh plugin --profile <profile> add "github:elfgzp/dsh-llm-minimax#main"
SkillHub 等社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係；上述安裝方式以倉庫 README 爲準。
典型用法¶
經過上面的安裝與啓用步驟後：
- 打開 設置 → MiniMax，粘貼 Key 並 校驗並保存。
- 回到對話，在輸入框模型選擇器選擇 MiniMax 國內 → MiniMax-M3.1-Flash 或 MiniMax-M3。
- 如需調整上下文預算或查看套餐額度，使用模型選擇器左側的
▣/●控件。
無需改配置文件，也無需重啓 DSH。
適用場景與注意¶
適合：已在 MiniMax 開放平臺開通 Key、希望在 DSH 裏用官方 M3 / M3.1-Flash、並希望在工具欄看到 M Plan 窗口的用戶。
邊界與限制（來自 README）：
- 按量付費餘額與消費只能在 MiniMax 控制台查看。
- 模型目錄內置；MiniMax 發佈新模型後，可在「設置 → 模型 → MiniMax 國內 → 模型選項」手動加一行，插件會保留。
- 插件版本 0.1.0；倉庫測試命令爲
node --test test/（可選MINIMAX_TEST_KEY做端到端）。
結尾¶
dsh-llm-minimax 在 DSH 已有 MiniMax 路由之上，補齊 M3 系模型目錄、單頁 Key 配置、思考檔位與 M Plan 額度展示，適合把 MiniMax 官方 API 當作日常對話模型的人。詳情見 SkillHub 目錄頁 與 GitHub 倉庫。
