前言¶
DeepSeek Harness（DSH）通过 @deepseek-ai/dsh-llm-pi-ai 已经能走 MiniMax 国内（minimax-cn）与国际（minimax）两条 Anthropic Messages 路由，但模型目录仍偏旧、Key 要在「设置 → 模型」里按提供商逐项添加，也没有 M Plan 额度视图。若你主要用 MiniMax 开放平台（api.minimaxi.com / api.minimax.io）的 MiniMax-M3.1-Flash 与 MiniMax-M3，更希望在一个设置页粘贴 Key、在模型选择器里直接选官方路由，社区插件 dsh-llm-minimax（维护者 elfgzp，分类：模型推理）补的是配置与 UI，而不是再写一套模型适配器。下面介绍它做什么、怎么装、怎么用，以及和自带能力之间的边界。
这是什么¶
dsh-llm-minimax 把 MiniMax 官方开放平台的模型写进 DSH 模型选择列表：在 设置 → MiniMax 粘贴 API Key，校验通过后可在输入框模型选择器里选 MiniMax 国内 → MiniMax-M3.1-Flash（或 MiniMax-M3），并查看 M Plan / Token Plan 的套餐额度窗口。插件不实现新的 LLM 适配器，而是在现有 minimax-cn / minimax 路由上更新模型目录、思考档位行为、凭据写入与额度展示。
- 目录页：https://www.skillhub.cn/plugins/elfgzp/dsh-llm-minimax
- 源码与说明：https://github.com/elfgzp/dsh-llm-minimax
- 当前 package 版本：0.1.0（MIT）
核心功能¶
模型目录与思考行为¶
插件内置的目录聚焦 MiniMax-M3.1-Flash、MiniMax-M3，不写已退役的 M2.x；M2.5 / M2.7 系列将于 2026-11-18 退役（资料中的时间表以 MiniMax 公告为准）。相对 DSH 自带目录，插件还会打开 forceAdaptiveThinking，使选择器上的思考档位以 output_config.effort 发出；MiniMax-M3.1-Flash 始终思考，不提供「关闭思考」（关闭会返回 400）。
| 模型 | 上下文 | 默认最大输出 | 思考 |
|---|---|---|---|
| MiniMax-M3.1-Flash | 1,000,000 | 131,072（上限 524,288） | 始终思考；深度可选 low … max |
| MiniMax-M3 | 1,000,000 | 131,072（上限 524,288） | 自适应；可选关闭或 low … max |
你在「设置 → 模型」里为该路由手动添加的其它模型条目会保留；插件不会改路由上的 baseURL、retryPolicy、headers 等，但会在配置变化时检查目录并补全缺项。
设置页填 Key 与凭据¶
- 打开 设置 → MiniMax。
- 在「API Key」粘贴 Key，点 校验并保存；区域默认自动识别（先试国内，再试国际）。
保存时任一步失败则不会写入。成功时插件会：
- 用
GET /v1/models校验 Key 并区分国内 / 国际； - 将 Key 写入本机
$DSH_HOME/.credentials.yaml，引用名为MINIMAX_CN_API_KEY/MINIMAX_API_KEY（与「设置 → 模型」页一致）； - 在
llm-pi-ai中启用对应路由并写入当前模型目录。
Key 仅在宿主进程内流转，浏览器侧只显示末 4 位。
输入框工具栏（仅官方 MiniMax 路由）¶
选中 minimax-cn / minimax 官方路由时，模型选择器左侧会出现：
| 控件 | 含义 |
|---|---|
▣ 1M |
上下文预算，可选 200K / 512K / 1M |
● MiniMax 62% |
套餐额度；悬停可见 5 小时与每周窗口的剩余与重置时间 |
换成腾讯内网网关、DeepSeek、GLM 等其它模型时，这两个控件会消失。选择器里可能出现两个 MiniMax 分组：带 x0.08 倍率的是内网转发，控件只在 minimax-cn 分组下的官方 API 条目上出现。
额度¶
额度来自 GET /v1/token_plan/remains，约每分钟刷新。M Plan / Token Plan 订阅 Key（sk-cp- 或有订阅的账号 Key）会显示各用量桶窗口与每周窗口的剩余百分比与重置倒计时；按量付费 Key（sk-api-）因 MiniMax 不提供余额查询接口，仅附控制台说明、不显示数字。接口 HTTP 200 时仍可能业务失败，插件按 base_resp.status_code 处理（如 2062 无生效订阅，1004 / 2049 Key 或区域问题）。
安装与启用¶
需要 DeepSeek Harness 0.2.x。插件以当前 DSH 进程权限运行，安装前建议浏览仓库源码与 MIT 许可证。
Web 界面：侧边栏 → 插件 → 添加插件 → 安装第三方插件，粘贴仓库地址：
https://github.com/elfgzp/dsh-llm-minimax
确认后在「已安装插件」里打开 MiniMax 模型。
在 agent 会话中（需开启插件管理工具）：
从 https://github.com/elfgzp/dsh-llm-minimax 安装这个插件并启用
命令行：
dsh plugin --profile <profile> add "github:elfgzp/dsh-llm-minimax#main"
SkillHub 等社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系；上述安装方式以仓库 README 为准。
典型用法¶
经过上面的安装与启用步骤后：
- 打开 设置 → MiniMax，粘贴 Key 并 校验并保存。
- 回到对话，在输入框模型选择器选择 MiniMax 国内 → MiniMax-M3.1-Flash 或 MiniMax-M3。
- 如需调整上下文预算或查看套餐额度，使用模型选择器左侧的
▣/●控件。
无需改配置文件，也无需重启 DSH。
适用场景与注意¶
适合：已在 MiniMax 开放平台开通 Key、希望在 DSH 里用官方 M3 / M3.1-Flash、并希望在工具栏看到 M Plan 窗口的用户。
边界与限制（来自 README）：
- 按量付费余额与消费只能在 MiniMax 控制台查看。
- 模型目录内置；MiniMax 发布新模型后，可在「设置 → 模型 → MiniMax 国内 → 模型选项」手动加一行，插件会保留。
- 插件版本 0.1.0；仓库测试命令为
node --test test/（可选MINIMAX_TEST_KEY做端到端）。
结尾¶
dsh-llm-minimax 在 DSH 已有 MiniMax 路由之上，补齐 M3 系模型目录、单页 Key 配置、思考档位与 M Plan 额度展示，适合把 MiniMax 官方 API 当作日常对话模型的人。详情见 SkillHub 目录页 与 GitHub 仓库。
