dsh-minimax-connect
使用此机器上已登录的 MiniMax Code (Mavis) 订阅作为 DSH 模型提供商，提供自动续期凭据、积分面板和每日签到。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:VICqiufeeng/dsh-minimax-connect#8c927d79d1ac09b384b48fd350783ec8cdb9e01eMinimax Connect 以 dsh-minimax-connect 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把本机 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 }
行为：
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"
node_modules 下，dsh.profile.bundles 会自动加上这一项。cordis.patch.yml），卸载时从 dependencies 与 dsh.profile.bundles 两处移除即可，不留残留。如果 pnpm 的供应链闸门报 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION（对 git 依赖一般不触发），追加 --config.minimumReleaseAge=0。
设置 → MiniMax（settings.section 插槽，order 460），四个区块：
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 好过填一个编出来的数字。lib/index.js 顶部注释里，便于对照。UNSUPPORTED_CONTENT，插件对两种 store 形状都做了适配。buildEnv 硬编码在 defaultAuthFile() 里，其它区域需要改这一处。代码里凡是"为什么这么写"的地方都留了注释，几处值得一读的：
credential renewal 段头：为什么插件不得不接管续期。mirrorAuthState / nextGeneration：两个文件代际必须一致的原因，以及那个会导致锁死自己的 off-by-one。withAuthLock：为什么复刻 proper-lockfile 的 on-disk 约定而不是依赖它。adaptAttachmentStore：宿主 attachment store 的两种形状。MIT