dsh-image-gen 是什么？给 DeepSeek Harness 对话补上原生文生图与多轮编辑

dsh-image-gen 是专为 DeepSeek Harness（DSH）打造的开源图像生成与编辑插件，它给 DSH 对话补上原生的文生图、图生图与多轮连续编辑能力，让你用自然语言就能让 Agent 画图并持续修改。 本文介绍 dsh-image-gen 是什么、核心功能、安装更新卸载命令与典型用法。

dsh-image-gen 是什么？

dsh-image-gen 解决的是「DSH Agent 能调用工具却无法直接在聊天里产出图片」的问题：它把图像生成与编辑做成了对话内的原生能力，装完配置好就能用一句话出图。 以下定位与事实来自官方 README（来源）：

dsh-image-gen（GitHub 仓库 shanliuling/dsh-image-gen）由 shanliuling 维护，MIT 协议开源，是 DSH Plugin 生态里的工具类插件。它在 DeepSeek Harness 之上补上 generate_image 与 edit_image 两个工具，让 Agent 把「生成图片」和「编辑图片」也纳入工具调用；模型对话仍由 DSH 本身负责，插件只接管图像这一环。它可以对接云端后端（Gemini、OpenAI Images / Compatible、Seedream、DashScope）与本地 ComfyUI，历史图片自动汇入会话顶栏的画廊。插件采用 BYOK 方式，API Key、Provider、模型与 Endpoint 都直接在 DSH 设置中配置，不需要额外的密钥文件。

dsh-image-gen 的核心功能有哪些？

核心能力围绕「对话生图、连续编辑、画廊管理、多后端、原生设置、工作区保存」展开：把画图这件事完整收进 DSH 的对话流里。 以下能力来自官方 README（来源）：

• 原生对话生图与编辑：直接在 DSH 对话中生成图片，也能基于已有图片继续修改。
• 连续多轮编辑：复用当前会话中的上传图片、历史生成图和上一轮编辑结果，持续迭代。
• 画廊与图片工具：自动汇总历史图片，支持搜索、筛选、全屏预览、复制、下载与删除。
• 多 Provider 支持：兼容 Google Gemini、OpenAI Images / Compatible、ByteDance Seedream、Aliyun DashScope 以及本地 ComfyUI 工作流。
• BYOK 与原生设置：API Key、Provider、模型和 Endpoint 都可在 DSH 设置中直接配置。
• 会话与工作区保存：图片接入 DSH Attachment / Conversation，并自动保存到当前工作区。

怎么安装与启用 dsh-image-gen？

安装 dsh-image-gen 有两条路：从 npm 装最新版，或从 GitHub 源码直装；装完后在 Settings → Plugins → Image generation 里配置 Provider 与 API Key 即可开始生图。 命令来自官方 README（来源）：

1. 从 npm 安装（推荐）：在 DeepSeek Harness 项目根目录执行，装进 web profile：

dsh plugin --profile web add dsh-image-gen@latest

等待安装完成，再在「设置 → 插件」确认已启用。

2. 从 GitHub 源码直装（可选）：需要审阅源码或试用未发布改动时使用：

dsh plugin --profile web add git+https://github.com/shanliuling/dsh-image-gen.git

3. 配置 Provider 与 API Key：打开 DSH Web 页面，进入 Settings → Plugins → Image generation，选择 Provider；云端 Provider 填写 API Key，本地 ComfyUI 填写地址并导入工作流 JSON。

4. 开始对话生图：在聊天框输入生图提示词，Agent 会调用 generate_image 工具并返回图片：

生成一张极简主义的现代建筑客厅插画。

5. 更新插件：更新到最新版，执行 update 命令（或重跑安装命令）：

dsh plugin --profile web update dsh-image-gen

6. 卸载插件：在宿主插件管理中移除，或执行移除命令：

dsh plugin remove dsh-image-gen

dsh-image-gen 典型用法

装完即用：先在设置里配好 Provider，再在对话里用自然语言生图、多轮编辑，历史图片都进画廊统一管理。 步骤来自官方 README（来源）：

1. 配置图像 Provider：打开 DSH 设置 → 插件 → 图像生成，选择 Provider 并填 API Key；ComfyUI 用户导入 API Format 工作流，提示词占位用 {{prompt}}。

2. 文生图：在聊天框直接说需求：

帮我画一张雨夜霓虹街头的赛博朋克猫咪。

3. 基于上一张图继续编辑：复用当前会话图片，让 Agent 调用 edit_image 修改：

给刚才那张图加上落地窗，并把窗外改成雪山。

4. 在画廊查看与管理：点击会话顶栏「画廊」Tab，集中查看、搜索、预览、下载或删除历史图片。

5. 本地 ComfyUI 出图：ComfyUI 支持文生图与图生图，导入多个命名工作流后，Agent 可在调用时按名称指定使用哪一个。

dsh-image-gen 常见问题与排错

常见问题集中在 API Key 无效、ComfyUI 地址连不上、工作流 JSON 占位符写错三类，分别核对 Key、地址与占位符写法即可。 依据来自官方 README（来源）：

1. API Key 无效：症状是调用生成时返回鉴权错误。原因：云端 Provider 的 API Key 未填或已失效。解决：在 Settings → Plugins → Image generation 重新填写正确的 Key 并保存。

2. ComfyUI 地址无法访问：症状是本地后端超时或连接失败。原因：ComfyUI 未启动，或地址端口不对。解决：确认本机回环地址与端口（默认 8188）可访问，再导入工作流 JSON：

curl http://127.0.0.1:8188/system_stats

3. 工作流 JSON 格式错误：症状是 ComfyUI 生图失败。原因：提示词占位符未用 {{prompt}}，或图生图工作流的 {{image}} 出现多次。解决：确认占位符写法正确，{{image}} 仅允许出现一次。

适用场景与注意

dsh-image-gen 适合想在 DSH 对话里直接生图、改图的重度用户，从云端 Gemini、OpenAI 到本地 ComfyUI 都能接，且历史图片集中可查。 适用性与限制来自官方 README（来源）：

典型场景包括：对话内快速生图——用一句话让 Agent 出图，无需切换工具；多轮创意迭代——基于上一张图持续修改直到满意；本地 ComfyUI 出图——用自建工作流在本地生成，数据不出机器；画廊复盘——集中查看和搜索历史图片。需要注意的限制有：云端 Provider 走 BYOK，需自备对应服务的 API Key；本地 ComfyUI 需自行搭建并导入 API Format 工作流；图片默认保存到当前工作区，可按需关闭或改子目录；插件只负责图像生成与编辑这一环，其余对话、工具与模型仍由 DeepSeek Harness 本身管理。

项目链接

dsh-image-gen 是 shanliuling 维护的 MIT 开源项目，作为 DeepSeek Harness 的对话图像插件持续迭代。 想查看完整功能、截图与插件信息，欢迎访问本站的 dsh-image-gen 插件详情页：dsh-image-gen。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：shanliuling/dsh-image-gen。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。