前言¶
DeepSeek Harness (DSH) 是一个本地智能体开发环境。在对话中直接生成图片通常需要调用云端 API。dsh-qwen-paint 插件解决了这个问题，它允许 DSH 在对话中直接调用本机运行的 ComfyUI，使用千问 Qwen-Image 2.1 模型进行绘图。整个过程运行在 127.0.0.1 上，不需要任何 API Key，也不需要网络连接。
插件简介¶
这是一个 DSH 插件，分为 Host 和 Client 两部分。它注册了一个名为 draw_image 的工具。
* Host 侧：负责工具注册、空闲 5 分钟自动关停 ComfyUI、挂载只读状态端点。
* Client 侧：负责在 Composer 下方显示 ComfyUI 在线状态，以及内联显示生成的图片。
依赖与安装¶
依赖环境¶
安装前需满足以下条件：
* ComfyUI：需跑在 127.0.0.1:8188。
* 模型文件：需要三个千问模型文件（约 13.3 GB），具体文件名和路径见下方说明。
* 显卡：NVIDIA 显卡开箱即用；AMD Radeon 建议使用 ROCm 路线（注意：A 卡可能遇到静默出错）。
安装步骤¶
- 通过 Plugin Manager 安装
在 DSH 完全退出后，使用以下命令安装插件：
dsh plugin --profile desktop add link:<本目录>
安装后**必须彻底退出 DSH 再重新打开**，宿主侧的工具清单只在启动时装配一次。
- 一键部署（推荐）
插件提供了安装脚本，可以自动检测环境并下载模型文件。
node scripts/setup.mjs
该脚本会自动查找 ComfyUI，下载所需的三个模型文件到正确目录，并进行 SHA256 校验。如果中途断网，直接重跑即可断点续传。
- 仅安装插件本体
如果 ComfyUI 和模型已就绪，只需挂载插件：
node scripts/install.mjs
使用方法¶
安装并重启 DSH 后，在聊天框中直接输入描述即可。助手会调用 draw_image 工具。
示例：
画一只在雪地里的柴犬，逆光，胶片颗粒，电影感
给我画一张 16:9 的赛博朋克雨夜街景，霓虹反射在积水上
用同样的种子再画一遍刚才那张
参数说明：
* prompt：必填，画面描述。
* size：画幅比例，默认 1:1，支持 3:4、16:9 等多种比例。
* megapixels：总像素，默认 1.0。
* seed：随机种子，不填则每次不同。
* negative：负面提示词。注意千问模型配置较低，负面词基本不生效。
功能特性¶
- 纯本地运行：不出网，不需要任何 API Key。
- 自动空闲关停：出图后 5 分钟无操作，ComfyUI 会自动关闭以释放显存。
- 状态可视化：在 Composer 下方显示 ComfyUI 的在线状态（绿色在线、黄色忙碌、灰色离线）。
- 内联显示：生成的图片会直接显示在聊天框中，而非仅作为附件。
注意事项¶
- 模型限制：模型文件禁止商用。
- 显存占用：三个模型共约 14 GB，对显存有要求。
- 首次加载：首次出图加载模型较慢，请耐心等待。
- AMD 用户：可能遇到静默出错，跑完必须人眼检查图片。
- 配置文件：修改配置需编辑
cordis.patch.yml，升级插件时不会覆盖该配置。
