前言¶

在 DeepSeek Harness（DSH）裏接第三方模型，常見做法是自備 API Key 或自建反代。若你已經在本機用 MiniMax Code（Mavis） 登錄過訂閱，賬號走的是積分制而不是獨立 LLM API Key，關掉桌面客戶端後 access token 大約一小時過期，Harness 側若沒有續期邏輯，provider 會在第一次 401 後失效。

下面介紹的 dsh-minimax-connect（維護者 VICqiufeeng，社區分類：模型推理）把本機 ~/.minimax 裏已有的登錄態讀出來，作爲 DSH 的一個 model provider；插件自行 OAuth 續期，並在設置裏提供積分、簽到與模型清單管理。MiniMax 推理端點本身是 Anthropic Messages 協議，DSH 的 pi-ai 可直接對接官方 URL，不需要額外反代進程。

這是什麼¶

dsh-minimax-connect（npm 包名 dsh-minimax-connect，顯示名 DSH Connect MiniMax，當前版本 0.1.0，MIT）是一條 Cordis 插件：消耗 MiniMax Code 訂閱積分，不消耗單獨的 API key。前提是在本機 MiniMax Code 中至少登錄過一次，憑據落在默認路徑 ~/.minimax/auth/prod/cn/mcode-public/auth.json（插件 README 寫明目前主要驗證 Windows + 國內 cn 區域）。

爲什麼不需要反代¶

MiniMax Code 的 LLM 基址與官方客戶端配置一致，例如 ~/.minimax/config.yaml 中的：

provider:
  minimax:
    npm: '@ai-sdk/anthropic'
    options:
      baseURL: https://agent.minimax.cn/mavis/api/v1/llm/v1

對話走 POST {llm}/v1/messages（Anthropic Messages；流式含 thinking_delta 與 text_delta）。鑑權使用 Authorization: Bearer 加 mmoat_ 開頭的 access token（從 auth.json 讀取），不能用 Anthropic 的 x-api-key（實測 401）。插件默認 baseUrl 爲 https://agent.minimax.cn/mavis/api/v1/llm（注意：給 SDK 的 base 不帶末尾 /v1，由 SDK 自行拼接 /v1/messages）。

核心功能¶

憑據自續期¶

access token 有效期約 1 小時。官方客戶端退出後，無人續期時 refresh token 雖在文件中卻不會被使用。本插件在到期前 5 分鐘主動刷新，並另有 60 秒巡檢；與客戶端複用同一套 on-disk 鎖與 auth.json / auth-state.json 代際約定，實測可與 MiniMax Code 雙向共存（客戶端進程數爲 0 時仍可通過 test/renew-e2e.mjs 端到端驗證）。

續期請求（與 README 一致）：

POST https://account.minimax.cn/oauth2/token
     grant_type=refresh_token
     refresh_token=<mmort_…>
     client_id=mcode-public
     scope=agent.default
     audience=agent-backend

設置頁會顯示自動續期狀態（已啓用 / 續期中 / 暫停重試 / 缺少 refreshToken 需重新登錄等）。invalid_grant 視爲致命失敗，需回到 MiniMax Code 重新登錄。

積分、簽到與用量¶

Cloud API 基址默認爲 https://agent.minimax.cn/minimax-cloud/api/v1。插件調用例如：

• 積分：GET {cloud}/credit/details
• 簽到狀態：GET {cloud}/signin/status?timezone_id=Asia/Shanghai（timezone_id 必填）
• 簽到：POST {cloud}/signin/claim?timezone_id=Asia/Shanghai，body {}

本地環迴路由（僅本機）包括 /plugins/dsh-minimax-connect/status、/usage、/checkin、/signin、POST .../signin/claim 等，供設置頁與自包含 HTML 面板 GET /plugins/dsh-minimax-connect/panel 使用。

模型 provider 與清單¶

GET {llm}/v1/models 實測返回 503 direct_route_not_configured，因此模型列表從本地 ~/.minimax/config.yaml 的 whitelist 與 model_order 解析。默認涉及例如 MiniMax-M3、MiniMax-M3.1-Flash-Preview、MiniMax-M2.7、MiniMax-M2.7-highspeed（各模型上下文、圖片、推理能力見 README 表格）。

在 設置 → MiniMax（order 460）可開關模型、圖片輸入、上下文窗口（200K 或 1M），保存寫入命名空間 llm-minimax。模型描述符的 cost 均爲 0（積分制無公開單價）。圖片輸入依賴宿主 durable attachment service；老宿主可能返回 UNSUPPORTED_CONTENT。

安裝與啓用¶

安裝命令以 README 爲準：

dsh plugin --profile desktop add "github:VICqiufeeng/dsh-minimax-connect"

說明：

1. 插件裝進 profile 的 node_modules，dsh.profile.bundles 會自動登記。
2. 重啓 DSH 後生效。
3. 不寫用戶補丁層（不修改 cordis.patch.yml）；卸載時從 dependencies 與 dsh.profile.bundles 移除即可。

若 pnpm 報 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION，可追加 --config.minimumReleaseAge=0。運行環境要求 Node ^22.19.0 || >=24.0.0（見 package.json）。

典型用法¶

前置：本機 MiniMax Code 已登錄，憑據文件存在；DSH 使用 desktop profile 並已安裝插件。

1. 執行上述 dsh plugin ... add 命令，重啓 DSH。
2. 打開 設置 → MiniMax，確認續期狀態與積分；需要時在界面完成每日簽到。
3. 在模型清單中啓用目標模型並保存。
4. 在 DSH 對話或智能體流程中選擇 MiniMax provider 對應模型進行推理。

開發者驗證續期（不修改真實 token，僅改過期時間戳）：

node test/renew-e2e.mjs ~/.minimax/auth/prod/cn/mcode-public/auth.json

需在倉庫內、且 MiniMax Code 未運行時按 README 說明執行。

配置項（可選覆蓋）¶

通過 schemastery Config 可覆蓋部分默認值：

enabledModelIds、imageOverrides、useMaximumContextWindow 由設置頁寫入；各 *Route 與 README 路由表一致。

適用場景與注意¶

適合：已訂閱 MiniMax Code、希望在 DSH 裏用同一積分賬號做 Anthropic 協議推理，且希望關閉桌面客戶端後仍能自動續期的開發者。

注意：

• 插件以 當前 DSH 進程權限 讀取本機 auth 文件併發起 OAuth；安裝前請自行審閱 GitHub 源碼 與 MIT 許可證。
• 依賴 MiniMax 非公開接口，後端變更可能導致插件需更新；端點集中在 lib/index.js 頂部註釋。
• 社區目錄 SkillHub 插件頁 與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本文事實均來自項目 README 與 package.json。

結尾¶

dsh-minimax-connect 把本機 MiniMax Code 登錄態變成 DSH 的 model provider，補上 token 自續期、積分簽到與模型開關，並直連官方 Anthropic Messages 端點。進一步瞭解可訪問社區目錄頁與倉庫：

• 目錄：https://www.skillhub.cn/plugins/VICqiufeeng/dsh-minimax-connect
• GitHub：https://github.com/VICqiufeeng/dsh-minimax-connect