前言¶

在 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