前言¶
DeepSeek Harness (DSH) 採用了插件化架構，允許開發者根據需要擴展功能。如果需要在對話中直接生成圖片並保存到本地工作區，需要專門的插件。dsh-minimax-image 是 Jack-sun-learner 維護的插件，它通過註冊 image-gen 工具，對接 MiniMax image-01 模型，將文本描述轉換爲 PNG 圖片並落盤。
核心功能¶
該插件主要提供以下能力：
- 文本生成圖像：基於 MiniMax
image-01模型，支持 8 種長寬比（16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9）。 - 工具集成：在 DSH 中註冊
image-gen工具，使模型能夠直接調用繪圖功能。 - 憑證複用：自動讀取
MINIMAX_API_KEY，無需額外配置。 - 本地保存：生成的 PNG 圖片會保存到工作區的
generated/目錄。
安裝與啓用¶
安裝插件需要先獲取插件源碼，然後通過 DSH 命令行註冊。
- 下載插件代碼到本地目錄，例如
/path/to/dsh-minimax-image。 - 安裝插件到
web和headless兩個 profile：
dsh plugin --profile web add /path/to/dsh-minimax-image
dsh plugin --profile headless add /path/to/dsh-minimax-image
安裝完成後，重啓 dsh web 進程。
配置說明¶
配置優先級從高到低依次爲：
1. Profile patch / Plugin row config
2. ~/.config/dsh-minimax-image/config.json
3. MINIMAX_IMAGE_* 環境變量
4. 內置默認值
環境變量¶
插件依賴以下環境變量：
MINIMAX_API_KEY：MiniMax API 密鑰（DSH 憑證存儲也支持讀取）。MINIMAX_IMAGE_MODEL：指定模型 ID。MINIMAX_IMAGE_BASE_URL：API 端點地址。MINIMAX_IMAGE_OUTPUT_DIR：輸出目錄。MINIMAX_IMAGE_TIMEOUT_MS：請求超時時間（毫秒）。
配置文件選項¶
在 ~/.config/dsh-minimax-image/config.json 中可覆蓋默認值：
| 字段 | 說明 | 默認值 |
|---|---|---|
apiKeyEnv |
存儲 API 密鑰的環境變量名 | MINIMAX_API_KEY |
baseUrl |
API 端點地址 | https://api.minimaxi.com/v1/image_generation |
model |
模型 ID | image-01 |
aspectRatio |
默認長寬比 | 16:9 |
outputDir |
輸出目錄（相對於工作區） | generated |
timeoutMs |
超時時間（毫秒） | 120000 |
典型用法¶
啓用插件後，在對話中描述畫面即可。模型會調用 image-gen 工具，處理成功後返回保存的文件路徑。
示例提示詞：
Generate a cyberpunk city night scene with neon lights and rain
模型返回示例：
Generated 1 image (16:9):
- D:\AI_video\generated\minimax-2026-08-18T12-16-11-1.png
適用場景與注意事項¶
- 權限要求：插件以當前 DSH 進程的權限運行，確保進程對輸出目錄（默認
generated/）有寫入權限。 - 源碼審查：在安裝社區維護的插件前，建議檢查源碼與許可證（本項目爲 MIT 許可證）。
- 生態背景：該插件收錄於 SkillHub 社區目錄，與 DeepSeek / 幻方公司無官方從屬關係。
總結¶
dsh-minimax-image 解決了 DSH 環境下模型直接生成圖片並持久化存儲的需求。通過簡單的安裝和配置，即可在對話流中利用 MiniMax 的 image-01 模型進行創作。
