dsh-qwen-paint：面向 DeepSeek Harness 的本地图像生成插件（优化版）

前言¶

DeepSeek Harness（DSH）支持插件化扩展。本插件为 DSH 提供了本地图像生成能力。它通过调用本机已安装的 ComfyUI，执行 Qwen-Image 2.1 模型，完成文生图与图生图任务。生成的图像落盘保存，并在会话界面中直接呈现。插件的所有网络流量严格限制在本机回环地址（127.0.0.1），不依赖外部网络，无需任何 API 密钥。

插件定位¶

名称：dsh-qwen-paint
所有者：yanfei0725
许可协议：MIT
核心价值：在本地利用 Qwen-Image 2.1 模型生成图像，降低使用成本，保障数据隐私。

核心功能¶

插件主要包含以下功能模块：

生成模式
- 文生图与图生图：支持通过文本或参考图生成新图像。
- 生成后自动放大：设置参数后，生成完成后可自动进行分块放大。
- 串行抽卡（排队模式）：当显存不足时，采用“提交一张→等待结果→落盘→再提交下一张”的模式，适合批量生成。
- 单次批量生成：支持一次提交生成多张图像。
显存与性能管理
- 显存档位：支持 auto、resident（全驻留）、standard、save（省显存）、ram（权重放内存）、cpu 多种模式。
- 模型精度档：支持 BF16、FP8、int8、GGUF。
- 文本控制档：支持 turbo（8步/CFG 1.0）与 native（千问原生工作点）。
- 权重可调：支持主模型、LoRA、ControlNet 权重的调节。
- 通用 ControlNet 支持：通过 controlImage 参数传入控制图。
- SageAttention：支持性能模式与兼容模式，依赖 ComfyUI 全局开关 --use-sage-attention。
- RDNA3 FlashAttention：接入已安装的 RDNA3 FlashAttention 节点。
- OOM 自动回退：显存不足时自动切换 VAE 解码为分块模式并重试。
生态联动
- 记忆联动：支持与 dsh-auto-memory 插件联动，读取记忆偏好。

使用方法¶

在 DSH 的配置或调用参数中设置以下项：

设置放大：设置 upscaleAfter 参数，例如设置为 2。
设置串行：设置 serialBatch 为 auto（默认）、on 或 off。
设置显存模式：设置 vramMode，例如设置为 ram 以将权重放至内存。
设置精度：设置 precisionTier，例如设置为 BF16。
设置文本控制：设置 textControl，例如设置为 native。
启用 ControlNet：传入 controlImage 参数，并确保 ComfyUI 中存在对应的 ControlNet 节点。
启用 SageAttention：在 ComfyUI 启动参数中添加 --use-sage-attention，插件内部可配置 SageAttention 模式。
设置 AMD 优化（可选）：在 ComfyUI 启动参数中调整 AMD 专属内核或异步卸载参数，需重启生效。

依赖与安装¶

插件运行依赖以下环境：
* DeepSeek Harness：版本需满足插件兼容性要求。
* ComfyUI：需已安装并配置好 Qwen-Image 2.1 模型文件。
* 模型文件：本地需存放 Qwen-Image 2.1 的对应权重文件（根据精度档位要求）。

注意事项¶

网络与安全：全部网络流量限于本机回环地址（127.0.0.1），不产生外部调用费用。
启动参数：修改 vramMode、AMD 优化参数等涉及 ComfyUI 启动的配置，必须重启 ComfyUI 才能生效。
ControlNet：使用 ControlNet 时，必须同时满足三个条件：ComfyUI 中探测到 ControlNetLoader 和 ControlNetApplyAdvanced 节点、在面板中选中了权重、传入了 controlImage 参数。缺一不可。
AMD 平台：BF16、FP8、ControlNet 在开发机（AMD）上未实测。AMD 专属优化（内核/异步卸载）默认关闭，启用需重启 ComfyUI。
SageAttention：该功能依赖 ComfyUI 的全局开关 --use-sage-attention。如果启用后 ComfyUI 启动失败，插件会在当前会话内自动关闭该功能并回退，避免反复崩溃。
不实测声明：SADA 节点类型、画质/速度收益未做真机验证。