前言¶
在 DeepSeek Harness（DSH）裏接第三方模型，常見做法是配 API Key、維護 base URL，或在多個客戶端之間重複登錄。若你已經在本機安裝了 MiniMax Code 桌面 App（國內版） 並完成登錄，理論上賬號裏可用的模型只服務於 App 本身，DSH 側還要再搭一套通路。
DSH Connect MiniMax Code（npm 包名 dsh-connect-minimaxcode）走另一條路：讀取本機 App 已有的登錄態（或插件頁自行 OAuth 設備碼登錄），在 DSH 裏註冊 minimaxcode provider，動態拉取模型目錄，並通過標準 Anthropic Messages 協議對接網關。裝好即用，不在 DSH 裏存明文 Token。項目由 JeffTsuiCUG 維護，MIT 許可，非官方，與 MiniMax、DeepSeek 均無關聯。
這是什麼¶
一句話定位：把本機已登錄的 MiniMax Code 桌面 App 模型（或插件獨立登錄態）接到 DSH，零配置 API Key，模型列表隨上游更新。
思路與社區裏的 dsh-workbuddy-connect 同類——桌面 App 已登錄的模型可以零配置搬進 DSH；本插件把同一套做法用在 MiniMax Code 上。插件結構與 provider 註冊方式參考了 dsh-connect-trae 等既有 DSH 插件約定。
目錄頁：SkillHub 插件頁
源碼：github.com/JeffTsuiCUG/dsh-connect-minimaxcode
核心功能¶
以下能力均來自項目 README 與實現說明，安裝前請自行閱讀倉庫聲明與 MiniMax 服務條款。
模型通路¶
- 零配置（複用桌面 App）：從
~/.minimax/local-runtime.auth.json讀取 JWT，僅在內存中使用，不在 DSH 中存儲明文 Token。 - 動態模型目錄：調用
GET /mavis/api/v1/models，模型增減無需改插件；對話走POST /mavis/api/v1/llm/v1/messages（Anthropic Messages 協議），工具調用、推理塊、上下文壓縮由 DSH 自帶 provider 託管。 - 不裝桌面 App 也可登錄：插件頁「登錄 MiniMax Code」走 OAuth 2.0 設備碼流（RFC 8628），憑據寫入
~/.dsh/.minimaxcode-auth.json（權限 0600），不寫入 MiniMax 客戶端帶generation的文件，避免與桌面 App 登錄態衝突。
積分與簽到¶
- 積分膠囊：選中 MiniMax Code 模型時，在輸入框工具行（模型選擇器旁）顯示剩餘積分；可查看贈送/購買拆分、消耗與 token 統計。賬戶信息依賴 OAuth 令牌（
~/.minimax/auth/prod/<region>/mcode-public/auth.json或插件自有登錄文件），與調模型用的 JWT 互不通用。 - 每日簽到：MiniMax Code 免費積分需每日簽到；插件頁可手動簽到或開啓「每天自動簽到」（默認關）。七天一輪進度與領取接口見 README。
兼容處理¶
網關與通用 Anthropic 客戶端存在實測差異（如 Authorization: Bearer vs x-api-key、baseUrl 路徑、thinking 字段等），插件在模型描述符層做了對應處理，詳見 README「與網關對接時的三個兼容處理」。
響應行爲說明¶
MiniMax 相關模型強制先推理再輸出，首個 token 前會有等待（README 舉例 M3.1-Flash 約 3 秒），推理以 thinking 塊流式返回——屬於模型行爲，非插件額外延遲。
前置條件¶
二選一：
- 已安裝並登錄 MiniMax Code 桌面 App（國內版）（最省事）；或
- 不裝 App，在插件頁完成 OAuth 設備碼登錄（需能訪問
account.minimax.cn）。
另外需要 DSH 桌面版（內置內核 >=0.2.1-rc.2 <0.3.0，見 package.json 的 engines.dsh；README 實測 0.2.1-rc.2）或 Web profile。
安裝與啓用¶
DSH 生態裏插件通過 profile 安裝；Web 環境把下文命令中的 --profile desktop 換成 --profile web。
方式一：從 Git 倉庫安裝（README 推薦，便於拿到最新代碼）
dsh plugin --profile desktop add github:JeffTsuiCUG/dsh-connect-minimaxcode
方式二：npm 安裝
dsh plugin --profile desktop add dsh-connect-minimaxcode
若需要 README 中描述的積分餘額與到期提示，README 建議鎖版本安裝（pnpm 默認 minimumReleaseAge 可能導致無版本號安裝解析到較早版本）：
dsh plugin --profile desktop add dsh-connect-minimaxcode@0.4.2
若桌面版 dsh 不在 PATH，可使用 DSH 應用自帶的載體 CLI（路徑隨安裝位置而變，例如 <DSH安裝目錄>\resources\runtime\cli\bin\dsh.cmd）。
安裝後插件熱加載，模型出現在模型選擇器的 MiniMax Code 分組。積分膠囊與插件頁面卡片在首次安裝或升級到 0.3.0 及之後版本後，需重啓一次 DSH 纔會出現（模型通路本身可不重啓）。
若安裝出現 [ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED]，README 說明可改用 github:JeffTsuiCUG/dsh-connect-minimaxcode#v0.2.1，或在 profile 的 pnpm-workspace.yaml 中按 pnpm 提示配置 allowBuilds。
典型用法¶
經過上面的安裝步驟後，可按 README 流程使用：
-
確認登錄
若走桌面 App：打開 MiniMax Code，確認已登錄。若走插件登錄：在插件頁完成設備碼授權。 -
選擇模型
在 DSH 模型選擇器的 MiniMax Code 分組下選擇模型（目錄示例：M3、M3.1-Flash，以 upstream 實時列表爲準）。 -
正常對話
工具由 DSH 本地執行，插件只提供模型通路。 -
鑑權異常時
- 模型報鑑權錯誤：多爲 JWT 失效，在 MiniMax Code 中重新登錄後重啓 DSH。
- 積分膠囊「登錄態已過期」：OAuth 過期；插件會嘗試用 refresh token 續期，失敗則打開一次桌面 App 讓其自行續期。OAuth 過期不影響仍有效的 JWT 下的模型對話。
插件頁還可查看簽到進度、手動或自動簽到，以及（在選中 MiniMax 模型時）積分膠囊詳情。
適用場景與注意¶
適合誰
- 已在本機使用 MiniMax Code 桌面 App，希望在 DSH 裏複用同一賬號模型、且不想在 DSH 再配一套 API Key 的開發者。
- 未裝桌面 App、但願意在瀏覽器裏完成官方 OAuth 設備碼授權、僅在 DSH 內使用 MiniMax Code 模型的用戶。
務必知曉
- 項目 README 標明：僅供學習與研究，不面向生產，無商業支持；依賴 MiniMax 非公開接口，客戶端更新可能導致插件失效。
- 插件以當前 DSH 進程權限運行，會讀取本機 MiniMax 相關憑據文件（或寫入插件自有 auth 文件）。安裝前應閱讀源碼與 MIT 許可證，自行評估風險。
- 禁止用於商業用途、批量/多賬號/規避限額等超出個人合理使用的場景；後果（賬號受限、額度清空等）由使用者自行承擔。
DSH 社區插件目錄（如 SkillHub）是獨立站點，與 DeepSeek / 幻方無官方從屬關係；本插件亦非 MiniMax 官方出品。
結尾¶
DSH Connect MiniMax Code 把「本機已登錄的 MiniMax Code 模型」或「插件 OAuth 登錄態」接到 DSH：動態目錄、Anthropic Messages 兼容、積分與簽到輔助，並儘量與桌面 App 登錄態只讀共存。若你要在 Harness 裏統一編排工具與對話，又不想重複維護 MiniMax API 配置，可以按 README 命令安裝，並在插件頁與 README 重要聲明中確認使用邊界。
- 目錄頁：https://www.skillhub.cn/plugins/JeffTsuiCUG/dsh-connect-minimaxcode
- GitHub：https://github.com/JeffTsuiCUG/dsh-connect-minimaxcode
