dsh-minimax-connect

把本机 MiniMax Code（Mavis） 已登录的订阅接入 DeepSeek Harness，作为一个模型 provider，并在设置侧边栏给出一个独立页面：积分余额 / 每日签到 / 模型清单 / 用量。

积分制账号：不消耗 API key，消耗 MiniMax Code 订阅的积分。

不用打开 MiniMax Code。 插件自己完成 OAuth 续期，桌面客户端可以完全退出。 详见 凭据自续期。

English: README.en.md

---

为什么不需要"反代"

MiniMax Code 的推理端点本身就是 Anthropic Messages 协议，DSH 的 pi-ai 原生支持该协议。所以直接把请求打到官方端点即可，不需要中间代理进程，也不需要 hook 客户端。

~/.minimax/config.yaml 里 MiniMax 自己就写着：

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
模型清单	—	GET {llm}/v1/models 返回 503 direct_route_not_configured；改从本地 config.yaml 静态解析
续期	POST https://account.minimax.cn/oauth2/token	grant_type=refresh_token，见下
积分	GET {cloud}/credit/details	details[] 带 granted_amount / remaining_amount / consumed_amount
签到面板	GET {cloud}/signin/status?timezone_id=Asia/Shanghai	timezone_id 是必需参数，缺则 1406010011 invalid timezone_id
签到	POST {cloud}/signin/claim?timezone_id=Asia/Shanghai，body {}	空 body 与官方客户端一致；同样需要 timezone_id

其中：

{llm}   = https://agent.minimax.cn/mavis/api/v1/llm
{cloud} = https://agent.minimax.cn/minimax-cloud/api/v1

注意两个 base 不同：Anthropic SDK 会自己在 baseURL 后补 /v1/messages，所以 {llm} 不带结尾的 /v1；而 cloud 路由带 /v1。

鉴权

读 ~/.minimax/auth/prod/cn/mcode-public/auth.json，取 records[*].accessToken（mmoat_ 开头），以 Authorization: Bearer 发送。

⚠️ 不能用 Anthropic 的 x-api-key：实测报 401 {"code":401,"message":"token is required"}。

记录键是 `${service}\0${account}`，分隔符是真的 NUL 字符，account = base64url(sha256(authHome + "\0" + "mcode-public"))。

凭据自续期

access token 有效期 1 小时。MiniMax Code 大致每小时续期一次并写回同一个文件 —— 在它之外没有任何东西会做这件事，所以关掉桌面客户端后，插件在 token 过期的那一刻就废了：实测过期后第一个请求回 401 invalid access token，而记录里躺着一个完全可用的 refreshToken 无人问津。

本插件自己执行同一个 grant：

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

行为：

• 提前 5 分钟续期，不让任何一条流开在一个正在死掉的 token 上。除按需触发外，还有一条 60 秒的巡检。
• refresh_token 单次有效、每次 grant 都轮换，所以旧值在应答到达的瞬间就死了，新的一对必须在用新 access token 之前落盘。写入是原子替换（临时文件 + rename），桌面客户端不会读到写了一半的记录。
• 与官方客户端共存。客户端用文件锁串行化自己的续期（proper-lockfile，auth.lock → auth.lock.lock 目录，stale: 30_000）。这里复用同一套 on-disk 约定：mkdir 抢占、超过 30 秒的锁按陈旧回收、写入前重新读一次文件并采纳更新的 generation 而不是覆盖它。两边轮流续期互不踢出，已实测双向共存。
• 两个文件必须同步推进。客户端 MCodeOAuthCore.readUsableCredential 要求 credential.generation === state.generation，不一致就当成未登录。新代际取 max(state.generation, credential.generation) + 1 —— 只用凭据自己的计数器，就可能写回一个低于 auth-state.json 的值，把账号锁在自己的新 token 外面。
• 失败不抛异常，一律回 { ok: false, reason, fatal? }，调用方继续用盘上已有的 token。fatal 只标记一种永久失败：invalid_grant（refresh token 本身没了），此时只有去 MiniMax Code 重新登录一次能把 provider 救回来。

设一面卡片会直接显示当前状态：自动续期已启用（到期前 5 分钟），不用打开 MiniMax Code / 正在自动续期… / 自动续期暂停，HH:MM:SS 后重试 / 凭据没有 refreshToken，需在 MiniMax Code 里重新登录一次。

端到端验证

test/renew-e2e.mjs 只把 expiresAtMs 改到"即将过期"（两个 token 一个都不碰，所以 grant 失败也是零代价），然后调用插件自己发货的 renewCredential，最后拿新 token 打真实模型端点：

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

在 MiniMax Code 进程数为 0 的情况下实测通过：grant 273 ms、代际 +1、两个文件代际相等、loginEpoch 保留、refreshToken 轮换，新 token 打 /v1/messages 返回 HTTP 200 {"text":"ok","base_resp":{"status_code":0}}。

安装

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（对 git 依赖一般不触发），追加 --config.minimumReleaseAge=0。

界面

设置 → MiniMax（settings.section 插槽，order 460），四个区块：

• 积分 + 签到 + 账号 —— 通用积分余额、七天签到面板、账号信息与续期状态。
• 模型清单 —— 逐模型开关 / 图片输入 / 上下文窗口（200K 或 1M）。
• 保存行 —— 落盘到插件自己的 settings 命名空间 llm-minimax。

同一份卡片也会出现在插件管理页（侧边栏「插件」图标 → 已安装 → dsh-minimax-connect）的详情里，因为它同时注册了 plugins.bundle.config 与 plugins.row.config。

另有一个自包含的零构建 HTML 面板：GET /plugins/dsh-minimax-connect/panel。

路由（全部仅回环）

路由	说明
GET /plugins/dsh-minimax-connect/status	汇总快照（面板用），含 selfRenewal
GET /plugins/dsh-minimax-connect/usage	积分明细原始应答
GET /plugins/dsh-minimax-connect/checkin	签到状态
GET /plugins/dsh-minimax-connect/signin	七天签到面板原始应答
POST /plugins/dsh-minimax-connect/signin/claim	执行签到
GET /plugins/dsh-minimax-connect/models	当前模型清单
POST /plugins/dsh-minimax-connect/__save	写回启用模型 / 图片开关 / 上下文窗口
GET /plugins/dsh-minimax-connect/panel	自包含 HTML 面板（无构建步骤）

配置

Config（schemastery）可覆盖的字段：

字段	默认
baseUrl	https://agent.minimax.cn/mavis/api/v1/llm
cloudBaseUrl	https://agent.minimax.cn/minimax-cloud/api/v1
authFile	~/.minimax/auth/prod/cn/mcode-public/auth.json
configFile	~/.minimax/config.yaml
cacheMs	15000
enabledModelIds / imageOverrides / useMaximumContextWindow	由设置页写入
各 *Route	见上表

模型

清单来自本地 ~/.minimax/config.yaml 的 whitelist + model_order，默认四个：

模型	上下文	图片	推理
MiniMax-M3	512K / 1M	✅	可开关
MiniMax-M3.1-Flash-Preview	512K / 1M	✅	强制
MiniMax-M2.7	200K	❌	强制
MiniMax-M2.7-highspeed	200K	❌	强制

已知限制

• 积分不换算成本：模型描述符的 cost 全为 0。积分制下没有公开的每 token 单价，填 0 好过填一个编出来的数字。
• 依赖客户端非公开接口：MiniMax 更新后端点可能变动；端点集中在 lib/index.js 顶部注释里，便于对照。
• 图片输入走宿主的 durable attachment service。老版本宿主不提供该服务时会回 UNSUPPORTED_CONTENT，插件对两种 store 形状都做了适配。
• 只测过 Windows + 国内版（cn）。区域路径与 buildEnv 硬编码在 defaultAuthFile() 里，其它区域需要改这一处。

设计说明

代码里凡是"为什么这么写"的地方都留了注释，几处值得一读的：

• credential renewal 段头：为什么插件不得不接管续期。
• mirrorAuthState / nextGeneration：两个文件代际必须一致的原因，以及那个会导致锁死自己的 off-by-one。
• withAuthLock：为什么复刻 proper-lockfile 的 on-disk 约定而不是依赖它。
• adaptAttachmentStore：宿主 attachment store 的两种形状。

License

MIT