前言¶

在 DeepSeek Harness 里做智能体，常见需求是让模型「说一句话就出一张图」，或「拿一张参考图按指令改一版」。比例、像素往往要对齐模型契约，后端又可能在云端 API 与本机 ComfyUI 之间切换。自己拼 HTTP、查宽高表、区分文生图和改图通道，会占掉不少集成时间。

下面介绍社区插件 dsh-image-forge（维护者 Demerier，分类：模型推理）。它把 Qwen-Image 2.1 的文生图与参考图编辑接到 DSH 工具链里，支持官方云端 API 与本机 ComfyUI 二选一（或 auto 组合），并把 wh_ratio 等契约做成一等参数；插件不自带运行时、不下载权重。

这是什么¶

dsh-image-forge 是 DeepSeek Harness 插件：用 Qwen-Image 做文生图和参考图编辑，后端可选 ComfyUI 或官方 API。装好后对话里会出现 qwen_image_generate、qwen_image_edit、qwen_image_status 三个工具，设置页左侧有「Qwen 出图」工作台。

仓库：https://github.com/Demerier/dsh-image-forge
社区目录页：https://www.skillhub.cn/plugins/Demerier/dsh-image-forge
当前包版本（package.json）：0.2.0，插件本体 MIT 许可。

核心功能¶

后端与能力矩阵¶

backend 默认 auto：有 key 走云 API，没有则走 ComfyUI。改图只能走 ComfyUI；若指定 backend: "api" 并带参考图，会明确报错，不会静默丢图。

文生图¶

在对话里直接描述需求即可；模型会把话改写成契约再调工具。比例由插件换算为约 1.5MP、32 对齐的像素，七档 wh_ratio：1:1、4:3、3:4、3:2、2:3、16:9、9:16。需要固定像素时可传 width / height（32 的倍数），优先于 wh_ratio。

生成文件默认落在 ~/Pictures/dsh-image-forge，命名形如 <prefix>_<W>x<H>_<n>.png，编号跳过已占用名，重复出图不覆盖旧文件。

改图¶

提供参考图即进入改图任务。参考路径须为绝对路径，仅认 PNG / JPEG / WebP。画布规则三选一：明说比例或像素；或 ratio_follow: "image1" 跟随某张图长宽比；都不传则跟随第一张参考图。wh_ratio 与 ratio_follow 不可同时传。多张参考图时用 <image1>、<image2> 说明用途并指明画布。

工作台与画板¶

设置页第一个页签为工作台：七档画幅、最多 10 张参考图（有图即改图）、可选「提示词优化」（依赖宿主安装 @deepseek-ai/dsh-llm，缺失时仅该按钮不可用）。结果以画布展示，支持按画板归档、board 参数串联多次调用。环境诊断可调用 qwen_image_status（不产图、不写盘）。

配置要点（日常六项）¶

其余字段见仓库 docs/configuration.md（共 14 项，均有默认值）。

API Key 读取顺序：apiKey → QWEN_IMAGE_API_KEY → DASHSCOPE_API_KEY → OPENAI_API_KEY。

安装与启用¶

在目标 profile 下执行官方安装命令（装完需重启 DSH）：

dsh plugin --profile <profile> add github:Demerier/dsh-image-forge

本地改插件源码时，在仓库内 pnpm install 与 pnpm build 后，用本仓库绝对路径 add。不要用 npm install 单独装插件——它依赖 DSH 宿主。pnpm build 若报 Cannot find package 'ansis'，可删除 node_modules 后重装（仓库使用 nodeLinker: hoisted）。

安全说明：插件以当前 DSH 进程权限运行，会读写你配置的输出目录并访问本机 ComfyUI 或云端 API。安装前请阅读仓库源码与 MIT 许可证；Qwen-Image 权重受 Qwen RESEARCH LICENSE 约束，商用需自行取得授权，插件不随包分发权重。

典型用法¶

对话里出图¶

直接说需求，例如「画一张 16:9 的夏日饮料海报」。工具侧契约示例：

{"rewritten_prompt": "A wide photograph of …", "wh_ratio": "16:9"}

对话里改图¶

给出参考图与改图指令，例如把客厅改成晚上。工具调用形态示例：

qwen_image_edit(prompt = <改图指令>, images = ["D:\\pictures\\room.png"], ratio_follow = "image1")

排障¶

不确定环境是否就绪时，先让模型调用 qwen_image_status，可查看云 API、ComfyUI、权重识别、显存与输出目录可写性等情况。

适用场景与注意¶

适合：已在用 DSH 做智能体，需要 Qwen-Image 2.1 文生图；有 ComfyUI 与权重时还要参考图编辑；希望用工作台和画板管理出图结果，而不是每次手写像素参数。

不适合或需知限制：

• 仅云端 key、无 ComfyUI 时无法改图。
• 无局部重绘、无放大；素材页侧重检索整理，非批量导出或调色。
• 插件不安装 ComfyUI、不下载权重；显存不足时多为 ComfyUI 侧 CUDA OOM。
• 对话中图片展示依赖工具返回的 Markdown 绝对路径。

ComfyUI 后端与工作流占位符协议参考并移植自 dsh-image-gen（Apache-2.0），详见仓库 THIRD-PARTY。

结尾¶

dsh-image-forge 把 Qwen-Image 的出图契约、双后端路由和改图约束收进 DSH 工具与工作台，适合既要对话出图、又要在本机 ComfyUI 上改图的开发者。更多部署与字段说明见 GitHub 仓库 docs/ 目录。

• 社区目录：https://www.skillhub.cn/plugins/Demerier/dsh-image-forge
• 源码与 README：https://github.com/Demerier/dsh-image-forge