前言¶
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 模型进行创作。
