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
