dsh-mmx
DeepSeek Harness (dsh) 的 MiniMax CLI 桥接：由 mmx 支持的网页搜索备用方案和透明图像理解，包含首次运行引导和设置卡片。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:crazyma99/dsh-mmx#37de1124fa85eb62e0664b997cc43397f8dc2f4f
Mmx 以 dsh-mmx 发布，当前版本为 1.5.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
MiniMax CLI bridge for DeepSeek Harness — 把 MiniMax CLI（mmx） 的网络搜索与图像理解接入 DSH：搜索自动回退、贴图自动识图、首次使用按操作系统给出安装指引，CLI 就绪后 30 秒内自动启用。
语言：English
ctx.web 注册 mmx-search 搜索 provider。通过 profile patch 将 searchProvider 指向 mmx-search（或在未钉选 provider 时由 DSH 自动选用唯一可用的 provider），web_search 工具即可透明地由 MiniMax 提供服务。mmx vision describe 生成文字描述，并以「模型可见替换」方式注入——对话记录中正常显示图片，模型实际收到的是 [图片内容描述] … 文字；read_image 工具同样返回文字描述而非 UNSUPPORTED_CONTENT。多模态模型默认原样放行（alwaysUseMmx: true 可改为总是走 mmx）。npm install -g mmx-cli + mmx auth login → 完成后刷新状态），并附按操作系统区分的手动安装指引（Windows PowerShell / macOS / Linux Terminal）。插件每 30 秒重新探测，CLI 就绪后自动开启，无需重启。设置 → 插件 → 「MiniMax 桥接 (dsh-mmx)」配置卡片：
dsh-mmx settings card在 DSH Web 设置页的「插件市场」中搜索 dsh-mmx 并一键安装（提交审核后可用）。
# GitHub（推荐）
dsh plugin --profile web add github:crazyma99/dsh-mmx
# npm registry
dsh plugin --profile web add dsh-mmx
# 本地目录
dsh plugin --profile web add file:/path/to/dsh-mmx
安装后重启 dsh web。
| 操作系统 | 终端 | 命令 |
|---|---|---|
| Windows | PowerShell | npm install -g mmx-cli → mmx auth login --api-key <你的 MiniMax API Key> |
| macOS | Terminal | npm install -g mmx-cli → mmx auth login --api-key <你的 MiniMax API Key> |
| Linux | Terminal | npm install -g mmx-cli → mmx auth login --api-key <你的 MiniMax API Key> |
前置条件：Node.js ≥ 20。验证安装：
mmx quota（可查看 TokenPlan 余额）。 本插件不读取、不打印、不存储你的 API Key——仅判断本地~/.mmx/config.json中是否存在密钥。
DSH 基础 bundle 默认将搜索 provider 钉选为 deepseek-official。若 DeepSeek 搜索未配置有效 key，请在 profile 的 cordis.patch.yml 中覆盖：
- id: web
config:
searchProvider: mmx-search
若后续获得有效的 DeepSeek 搜索 key，可改回
deepseek-official；在未钉选 provider 时，DSH 会自动选用唯一available()的 provider。
优先级：settings 命名空间 dsh-mmx ＞ cordis.patch.yml 的 config 行 ＞ 默认值。
| 键 | 默认值 | 说明 |
|---|---|---|
enabled | true | 总开关 |
searchEnabled | true | 注册 mmx 搜索 provider |
visionEnabled | true | 透明识图 |
patchAdmission | true | 包装 resolveModelInfo 放行图片准入（仅 mmx 就绪时生效） |
alwaysUseMmx | false | true = 多模态模型也走 mmx 识图 |
visionPrompt | 中文详细描述模板 | 识图提示词 |
mmxBin | mmx | CLI 命令名或绝对路径 |
npmBin | npm | 一键安装使用的 npm 命令名或绝对路径 |
timeoutMs | 60000 | 单次 CLI 调用超时（5000–300000 ms） |
设置页卡片：设置 → 插件 → 「MiniMax 桥接 (dsh-mmx)」。布尔开关即时保存；文本/数字字段编辑后点击「保存」。卡片底部提供一键安装（填 API Key → 自动安装并登录 → 刷新状态）与按操作系统切换的手动安装指引。
'dsh-mmx' 加入 DSH WEB_SETTINGS_NAMESPACES 白名单（packages/host/apiproxy/src/api-proxy.ts，一行；升级 DSH 后需重打）。~/.dsh/settings.yaml（热加载，无需重启）：
dsh-mmx:
enabled: true
searchEnabled: true
visionEnabled: true
patchAdmission: true
alwaysUseMmx: false
mmxBin: mmx
timeoutMs: 60000
profile cordis.patch.yml 的 config 行（需重启）。
mmx-search；mmx-search → 始终使用 MiniMax（本仓库推荐配置）；WEB_PROVIDER_AMBIGUOUS，需显式钉选其一。spawn（不经 shell），并设置超时与取消传播；POST /dsh-mmx/install 强制同源校验、请求体 4 KiB 封顶、互斥串行，API Key 仅透传给 mmx auth login 一次、不回显；临时图片文件权限 0600，用完即删；dsh plugin --profile web remove dsh-mmx
卸载后重启 dsh web；settings.yaml 中的 dsh-mmx: 段可手动删除。