前言¶
在 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
