ComfyUI-BrushNet-Wrapper 插件完全教程

1. 插件简介

插件地址： https://github.com/kijai/ComfyUI-BrushNet-Wrapper

这个插件是什么呢？简单来说，它就像是给你的ComfyUI装了一个超级智能的"画笔修复工具"。想象一下，你有一张照片，想要修改其中的某个部分，比如给人物换个发型、去掉背景中的某个物体、或者给图片添加新的元素。传统的方法可能需要你手工一点点修改，但是有了BrushNet，你只需要用画笔在想要修改的地方涂一涂，然后告诉AI你想要什么效果，它就能智能地帮你完成修改。

这个插件能给我们带来什么效果：

• 智能修复：就像用魔法橡皮擦一样，可以去掉图片中不想要的东西
• 精准编辑：只修改你指定的区域，其他地方保持原样
• 创意添加：在指定位置添加新的物体或效果
• 风格转换：改变图片某个区域的风格，比如把白天变成夜晚
• 对象替换：把一个物体换成另一个物体

2. 如何安装

方法一：使用ComfyUI Manager（推荐）

1. 打开ComfyUI Manager
2. 点击"Install from Git URL"
3. 输入：https://github.com/kijai/ComfyUI-BrushNet-Wrapper
4. 点击安装

方法二：手动安装

1. 进入你的ComfyUI安装目录
2. 找到custom_nodes文件夹
3. 在命令行中运行：

cd custom_nodes
git clone https://github.com/kijai/ComfyUI-BrushNet-Wrapper.git
cd ComfyUI-BrushNet-Wrapper
pip install -r requirements.txt

方法三：便携版安装

如果你用的是ComfyUI便携版，在ComfyUI_windows_portable文件夹中运行：

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-BrushNet-Wrapper\requirements.txt

注意： 模型文件会自动从 https://huggingface.co/Kijai/BrushNet-fp16 下载到 ComfyUI/models/brushnet 文件夹中。

3. 节点详细解析

本插件总共包含 6 个节点，现在逐一详细解析：

3.1 BrushNet Model Loader（BrushNet模型加载器）

这个节点就像是一个"工具箱管理员"，负责把所有需要的工具（模型）准备好，让后面的节点可以使用。

参数详解：

brushnet_model 选项说明：

• brushnet_segmentation_mask：分割遮罩模式，适合精确的物体编辑
• brushnet_random_mask：随机遮罩模式，适合创意性编辑
• powerpaint_v2_brushnet：PowerPaint模式，功能更强大，支持多种编辑任务

3.2 BrushNet Sampler（BrushNet采样器）

这个节点就是真正的"魔法画笔"，它接收你的指令和遮罩，然后生成修改后的图片。

参数详解：

scheduler 选项说明：

• UniPCMultistepScheduler：速度快，质量好，推荐日常使用
• DPMSolverMultistepScheduler：质量高，速度中等
• EulerDiscreteScheduler：经典选择，效果稳定
• LCMScheduler：超快速度，适合快速预览
• TCDScheduler：新型调度器，平衡速度和质量

3.3 PowerPaint BrushNet Sampler（PowerPaint BrushNet采样器）

这个节点是BrushNet Sampler的升级版，就像从普通画笔升级到了多功能电子画笔，功能更强大。

参数详解：

task 选项详细说明：

• text-guided：文本引导模式，根据你的描述来修改
• object-removal：物体移除模式，专门用来去掉不想要的东西
• context-aware：上下文感知模式，智能填充空白区域
• shape-guided：形状引导模式，根据形状来生成内容
• image-outpainting：图像外绘模式，扩展图片边界

3.4 BrushNet ELLA Loader（BrushNet ELLA加载器）

这个节点就像给你的AI装了一个"语言理解增强器"，让它能更好地理解复杂的文字描述。

参数详解：

输出：

• brushnet：增强后的BrushNet模型，理解能力更强

3.5 BrushNet Sampler (ELLA)（BrushNet ELLA采样器）

这是配合ELLA增强器使用的特殊采样器，需要特殊的文本编码输入。

参数详解：

3.6 BrushNet IP Adapter (Matteo)（BrushNet IP适配器）

这个节点就像一个"风格模仿器"，可以让生成的图片模仿参考图片的风格。

参数详解：

4. 使用技巧和建议

4.1 基础使用流程

1. 准备素材：加载你要编辑的图片
2. 创建遮罩：用画笔工具标记要修改的区域
3. 加载模型：使用BrushNet Model Loader加载所需模型
4. 设置参数：根据需求调整采样器参数
5. 运行生成：执行工作流获得结果

4.2 参数调优建议

• 新手推荐设置：steps=25, cfg=7.5, cfg_brushnet=1.0
• 高质量设置：steps=40, cfg=9.0, cfg_brushnet=1.2
• 快速预览设置：steps=15, cfg=6.0, scheduler=LCMScheduler

4.3 不同任务的最佳实践

• 物体移除：使用PowerPaint的object-removal模式
• 风格转换：结合IP Adapter使用参考图片
• 精细编辑：使用较高的steps和cfg值
• 创意生成：开启guess_mode，降低cfg值

5. 常见问题解答

Q1: 为什么生成的图片质量不好？

A: 尝试以下解决方案：

• 增加steps数值（推荐25-40）
• 调整cfg值（推荐7.5-10.0）
• 检查遮罩是否准确
• 优化提示词描述

Q2: 模型下载失败怎么办？

A:

• 检查网络连接
• 手动从Hugging Face下载模型文件
• 确保有足够的磁盘空间

Q3: 生成速度太慢怎么办？

A:

• 降低steps数值
• 使用LCMScheduler或TCDScheduler
• 减小图片分辨率
• 关闭不必要的功能

Q4: 编辑效果不自然怎么办？

A:

• 调整control_guidance_end到0.8-0.9
• 降低cfg_brushnet值
• 优化遮罩边缘的羽化效果
• 使用更详细的提示词

Q5: PowerPaint和普通BrushNet有什么区别？

A:

• PowerPaint功能更强大，支持多种专门的编辑模式
• 普通BrushNet更通用，适合基础编辑任务
• PowerPaint需要使用专门的采样器节点

6. 总结

ComfyUI-BrushNet-Wrapper插件为我们提供了强大的图像编辑能力，通过6个不同的节点，我们可以实现从基础的图像修复到高级的风格转换等各种功能。掌握这些节点的使用方法和参数调节技巧，你就能像专业的数字艺术家一样，轻松地对图像进行精确而自然的编辑。

记住，好的结果需要耐心的调试和实践。建议从简单的编辑任务开始，逐步掌握各个参数的作用，然后再尝试更复杂的创作任务。随着经验的积累，你会发现这个插件的强大之处，它能帮你实现许多以前难以想象的图像编辑效果。