%20(1).png)
ComfyUI-UltraEdit-ZHO 插件完全教程
1. 插件简介
插件地址： https://github.com/ZHO-ZHO-ZHO/ComfyUI-UltraEdit-ZHO
这个插件就像是给你的ComfyUI装了一个超级厉害的图片编辑器！它能让你用简单的文字描述来修改图片，比如你想把图片里的猫变成狗，或者把红色的花变成蓝色的花，只要打几个字就能搞定。
主要功能：
- 🎨 全局编辑：就像用魔法棒一样，可以改变整张图片的内容
- 🎯 局部编辑：就像用橡皮擦和画笔一样，只改变你圈出来的部分
- 🤖 智能保持风格：改完后的图片还是原来的画风，不会变得奇怪
- 📱 简单操作：只要会打字就能用，不需要复杂的操作
能带来什么效果：
- 快速修改图片内容，比传统PS快100倍
- 保持图片原有的风格和质量
- 支持精确的局部修改
- 适合各种图片编辑需求
2. 如何安装
方法一：使用ComfyUI Manager（推荐）
- 打开ComfyUI Manager
- 搜索"UltraEdit"
- 点击安装
- 重启ComfyUI
方法二：手动安装
- 打开终端或命令提示符
- 进入ComfyUI的custom_nodes文件夹
- 运行以下命令：
git clone https://github.com/ZHO-ZHO-ZHO/ComfyUI-UltraEdit-ZHO.git
cd ComfyUI-UltraEdit-ZHO
pip install -r requirements.txt
- 重启ComfyUI
重要提醒： 这个插件需要特殊版本的依赖库，建议在虚拟环境中使用，避免和其他插件冲突。
3. 节点详细解析
3.1 🏕️UltraEdit Model(auto) 节点
这个节点就像是一个"自动下载器"，它会帮你从网上自动下载需要的模型文件，不用你手动去找和下载。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| base_model | base_model | 文本输入 | BleachNick/SD3_UltraEdit_w_mask | 就像告诉下载器要下载哪个版本的软件一样，这里填写模型的名字 | 指定要加载的HuggingFace模型仓库地址 | 保持默认值即可，除非你知道其他可用的模型地址 |
输出：
- pipe：就像一个"加工厂"，后面的节点需要用它来处理图片
3.2 🏕️UltraEdit Model(local) 节点
这个节点就像是一个"本地文件管理器"，它会使用你电脑上已经下载好的模型文件，速度更快但需要你提前准备好文件。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| base_model | base_model | 下拉选择 | 选择你下载的模型文件 | 就像从文件夹里选择一个软件来运行，这里选择你下载好的模型文件 | 从本地ultraedit文件夹中选择已下载的模型文件 | 需要先把模型文件放到ComfyUI/models/ultraedit文件夹里，然后从下拉菜单选择 |
输出：
- pipe：和上面一样，是一个"加工厂"
使用前准备：
- 去 https://huggingface.co/BleachNick/SD3_UltraEdit_w_mask 下载所有文件
- 把文件放到
ComfyUI/models/ultraedit文件夹里 - 重启ComfyUI后就能在下拉菜单看到文件了
3.3 🏕️UltraEdit Generation 节点
这个节点就像是一个"魔法师"，它接收你的图片和文字描述，然后变出一张新的图片。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| pipe | pipe | 连接输入 | 来自模型加载节点 | 就像插电源一样，这里连接上面的"加工厂" | 接收模型管道对象 | 用线连接到上面任意一个模型加载节点的输出 |
| image | image | 图片输入 | 任意图片 | 就像给画家一张底图，告诉他要在这张图上修改 | 输入要编辑的原始图像 | 连接Load Image节点或其他图片输出 |
| positive | positive | 多行文本 | cat | 就像告诉魔法师"我想要什么"，比如"把狗变成猫" | 正向提示词，描述想要的编辑效果 | 输入"turn the dog into a cat"或"把狗变成猫" |
| negative | negative | 多行文本 | worst quality, low quality | 就像告诉魔法师"我不想要什么"，比如"不要模糊的图片" | 负向提示词，描述不想要的效果 | 保持默认值，或添加"blurry, ugly"等 |
| steps | steps | 整数滑块 | 50 | 就像告诉魔法师要施法多少次，次数越多效果越好但时间越长 | 推理步数，影响生成质量和时间 | 快速预览用20-30，最终效果用50-80 |
| image_guidance_scale | image_guidance_scale | 小数滑块 | 1.5 | 就像调节"参考原图的程度"，数值越高越像原图 | 图像引导强度，控制对原图的保持程度 | 想大改用1.0-1.2，想小改用1.5-2.0 |
| text_guidance_scale | text_guidance_scale | 小数滑块 | 7.5 | 就像调节"听话程度"，数值越高越按你的文字描述来改 | 文本引导强度，控制对提示词的遵循程度 | 简单修改用5-7，复杂修改用8-12 |
| seed | seed | 整数输入 | 0 | 就像抽奖的号码，同样的号码会得到同样的结果 | 随机种子，控制生成的随机性 | 想要固定效果就用固定数字，想要随机效果就改变数字 |
| mask (可选) | mask | 图片输入 | 无 | 就像用遮罩纸告诉魔法师"只改这一块地方" | 蒙版图像，指定编辑区域 | 用白色标记要改的地方，黑色标记不改的地方 |
输出：
- IMAGE：修改后的新图片
4. 使用技巧和建议
🎯 基础使用流程
- 选择模型加载方式：新手推荐用auto版本，老手可以用local版本
- 准备图片：确保图片尺寸是4的倍数（比如512x512, 1024x768等）
- 写好描述：用简单明确的语言描述你想要的效果
- 调整参数：从默认参数开始，根据效果慢慢调整
- 生成图片：点击运行，等待魔法发生
💡 参数调优技巧
快速出图设置：
- steps: 20-30
- image_guidance_scale: 1.5
- text_guidance_scale: 7.5
高质量设置：
- steps: 50-80
- image_guidance_scale: 1.8
- text_guidance_scale: 8.5
大幅修改设置：
- image_guidance_scale: 1.0-1.2
- text_guidance_scale: 9-12
细微调整设置：
- image_guidance_scale: 2.0-2.5
- text_guidance_scale: 5-7
🎨 提示词写作技巧
好的提示词示例：
- "turn the red car into a blue car"（把红车变成蓝车）
- "change the cat to a dog"（把猫变成狗）
- "add sunglasses to the person"（给人戴上墨镜）
避免的提示词：
- 太复杂的描述
- 模糊不清的要求
- 互相矛盾的指令
🎭 蒙版使用技巧
制作蒙版：
- 用任何绘图软件画一个黑白图
- 白色 = 要修改的地方
- 黑色 = 不修改的地方
- 灰色 = 部分修改
蒙版连接：
- 如果你的蒙版是MASK格式，需要用"Convert Mask to Image"节点转换
- 然后连接到Generation节点的mask输入
5. 常见问题解答
❓ 为什么生成了512张图而不是1张？
解决方法： 打开UltraEdit.py文件，找到最后一行的 output_t = output_t.squeeze(0)，把这行删掉，然后重启ComfyUI。
❓ 为什么图片变得很模糊？
可能原因：
- steps设置太低，建议调到50以上
- text_guidance_scale设置太高，建议降到10以下
- 原图质量不好
❓ 为什么修改效果不明显？
解决方法：
- 降低image_guidance_scale到1.0-1.2
- 提高text_guidance_scale到8-12
- 检查提示词是否清晰明确
❓ 为什么会报错"图片尺寸问题"？
解决方法： 确保输入图片的宽度和高度都是4的倍数。比如：
- ✅ 512x512, 1024x768, 800x600
- ❌ 513x512, 1023x768, 801x600
❓ 本地模型加载失败怎么办？
检查步骤：
- 确认模型文件都下载完整了
- 确认文件放在正确的文件夹里（ComfyUI/models/ultraedit）
- 重启ComfyUI
- 检查文件夹权限
❓ 自动下载模型很慢怎么办？
解决方法：
- 检查网络连接
- 使用科学上网工具
- 或者改用本地模型加载方式
6. 进阶使用技巧
🔄 批量处理技巧
虽然这个插件主要处理单张图片，但你可以：
- 用Loop节点实现批量处理
- 用不同的seed值生成多个版本
- 结合其他插件实现工作流自动化
🎬 制作渐变视频
插件作者提供了特殊的工作流，可以制作图片编辑的渐变视频：
- 下载"UltraEdit + LatentTravel anne"工作流
- 需要额外安装ComfyUI_TravelSuite_Zho插件
- 可以制作从原图到编辑图的平滑过渡动画
🎨 创意组合使用
- 风格迁移：先用其他节点改变风格，再用UltraEdit微调细节
- 多步编辑：第一次大改，第二次精修
- AB测试：用不同参数生成多个版本对比
📊 性能优化建议
- 显存不足：降低图片分辨率，使用较小的steps
- 速度优化：使用本地模型，减少网络下载时间
- 质量平衡：根据用途选择合适的参数，预览用低参数，最终输出用高参数
7. 总结
ComfyUI-UltraEdit-ZHO是一个功能强大且易于使用的图片编辑插件。它的三个节点各司其职：
- 模型加载节点：负责准备"工具"
- 生成节点：负责实际的"魔法变换"
通过合理的参数设置和清晰的提示词，你可以轻松实现各种图片编辑效果。记住，熟能生巧，多试几次就能掌握最适合你的参数组合！
最后提醒： 这个插件基于SD3模型，主要适合512x512分辨率的图片。如果你需要处理更大的图片，建议先缩放到合适尺寸，处理完后再放大。
祝你使用愉快！🎉