dsh-imagegen：为 DeepSeek Harness 提供绘图能力的插件

在 DeepSeek Harness（DSH）的生态中，为智能体添加多模态能力往往需要手动处理外部服务或复杂的集成。dsh-imagegen 插件通过注册 generate_image 工具，直接将绘图能力集成到对话流中，让智能体可以在对话中请求并展示图片。

插件介绍¶

这是一个面向 DeepSeek Harness 0.2.x 的图像生成插件，由用户 little-traincar 维护。它解决了智能体需要调用绘图 API 并将结果展示在聊天界面中的需求。

核心能力¶

内联渲染：生成的图片会附加到对话中，直接渲染在聊天窗口，同时也提供同源的 /imagegen/<file> 链接作为备选。
灵活配置：支持为每个渠道配置模型 ID，支持别名和调用时的覆盖。
开放提供商表：内置豆包 Seedream 和阿里云 Qwen，兼容任何 OpenAI 兼容的 /images/generations 端点（包括网关、中继或本地部署）。
无水印：默认发送 watermark: false，部分模型拒绝该字段时提供开关。
文字嵌入：提示词中的文字会被逐字嵌入到图片中，不会被改写。
图生图：支持通过 URL、本地绝对路径或 Data URI 传入参考图。
保存到磁盘：所有图片默认保存到 outDir。
多候选与容错：支持 supportsN 的渠道一次请求生成多张；部分请求失败时，成功的图片会被保留。

安装与启用¶

在 Desktop 模式下，需要先完全退出应用，再执行安装命令：

dsh plugin --profile desktop add @little-traincar/dsh-imagegen

重新打开应用即可加载。

配置说明¶

安装后，进入 Settings → imagegen。你需要为使用的渠道配置 API Key。

内置提供商：插件内置了豆包和阿里云 Qwen 的配置，只需填写对应的 API Key。
自定义提供商：支持任何 OpenAI 风格的 POST <baseUrl>/images/generations 接口。在 Custom providers 字段填入配置，例如本地 Ollama：

{
  "local": {
    "baseUrl": "http://127.0.0.1:11434/v1",
    "model": "x/flux2-klein",
    "apiKeyOptional": true,
    "sendWatermark": false,
    "size": "1024x1024"
  }
}

模型 ID：模型 ID 可在 Settings → imagegen → Models 中逐个修改，或在 cordis.patch.yml 中统一配置。支持别名，调用时可指定 provider 和 model。

使用示例¶

在对话中直接输入绘图请求。智能体会调用 generate_image 工具，图片会直接渲染在聊天窗口中。

例如：
“Draw a summer coffee-shop poster: retro magazine collage, cream yellow and coffee brown, portrait; headline ‘Summer Ice Cafe Festival’, subtitle ‘Half price for the second cup.’”

注意事项与卸载¶

该插件要求 DeepSeek Harness 版本为 0.2.x（兼容 0.2.0-rc.2 和 0.2.1-alpha.1）。

卸载时，必须先完全退出应用，然后运行：

dsh plugin --profile desktop remove @little-traincar/dsh-imagegen

注意：卸载命令不会删除已生成的图片（位于 outDir）和配置文件中的 imagegen 段落，如需清理需手动处理。

dsh-imagegen 提供了一个灵活、无水印且兼容性好的绘图方案，适合需要在对话流中直接输出图片的场景。更多细节可查看 GitHub 仓库。