DSH（DeepSeek Harness）采用插件化架构，当基础 bundle 缺少必要的搜索或图像理解能力时，接入外部 CLI 是常见方案。dsh-mmx 插件将 MiniMax CLI 的能力桥接到 DSH，解决在没有有效 DeepSeek 搜索 Key 时自动回退，以及让纯文本模型具备识图能力的问题。
这是一个由 crazyma99 维护的插件，遵循 MIT 许可证。
核心功能¶
-
网络搜索回退
插件向ctx.web注册mmx-search搜索 provider。通过 profile patch 将searchProvider指向mmx-search（或在未钉选 provider 时由 DSH 自动选用唯一可用的 provider），web_search工具即可透明地由 MiniMax 提供服务。 -
透明识图
纯文本模型发送图片时，插件在发送前调用mmx vision describe生成文字描述，并以「模型可见替换」方式注入——对话记录中正常显示图片，模型实际收到的是文字描述。read_image工具同样返回文字描述而非错误。多模态模型默认原样放行（配置项alwaysUseMmx可改为总是走 mmx）。 -
首次使用引导（OOBE）
插件会检测 mmx 是否安装或登录。未就绪时，上述两个能力会自动停用。设置页卡片提供一键安装功能（填入 API Key → 自动npm install -g mmx-cli+mmx auth login→ 刷新状态），并附按操作系统区分的手动安装指引。插件每 30 秒重新探测，CLI 就绪后自动开启。
安装与前置¶
前置条件：本地需安装 Node.js >= 20。
安装方式如下：
# 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。
配置与使用¶
安装完成后，需要进行配置以启用功能。
1. 搜索 Provider 钉选¶
DSH 基础 bundle 默认将搜索 provider 钉选为 deepseek-official。若 DeepSeek 搜索未配置有效 key，请在 profile 的 cordis.patch.yml 中覆盖：
- id: web
config:
searchProvider: mmx-search
2. 设置页配置¶
在 DSH 设置页的插件卡片中，你可以配置以下选项：
* enabled：总开关（默认 true）。
* searchEnabled：注册 mmx 搜索 provider（默认 true）。
* visionEnabled：透明识图（默认 true）。
* alwaysUseMmx：多模态模型是否也走 mmx 识图（默认 false）。
* visionPrompt：识图提示词模板。
点击“一键安装”并填入 API Key，可自动完成 mmx CLI 的安装与登录。
隐私与安全¶
- API Key 安全：插件不读取、不打印、不记录你的 API Key。
- 图片处理：图片经 mmx CLI 上传至 MiniMax API（base64）用于识图；临时图片文件权限设置为 0600，用完即删。
- 进程安全：所有子进程调用均以参数数组直接
spawn，并设置超时与取消传播。
卸载¶
dsh plugin --profile web remove dsh-mmx
