ComfyUI-BrushNet 图像编辑实战指南

ComfyUI-BrushNet 图像编辑实战指南

ComfyUI-BrushNet 是 ComfyUI 的一套强大扩展，集成了 BrushNet、PowerPaint 和 HiDiffusion 等前沿模型。它让图像修复、对象移除和扩展绘画变得像搭积木一样简单，无需编写复杂代码即可实现专业级效果。

环境准备与安装

安装过程主要涉及模型文件配置和节点部署。

首先获取必要的模型权重。BrushNet 和 PowerPaint 模型通常放置在 models/inpaint 目录下，文本编码器则放入 models/clip。确保版本匹配是稳定运行的前提。

接着处理依赖项，在终端执行 pip 安装命令加载所需库：

pip install -r requirements.txt

最后将项目克隆至 ComfyUI 的 custom_nodes 目录，重启软件后节点列表里应该就能找到对应的功能入口。

核心工作流解析

基础修复流程其实很直观：加载底模和 BrushNet 模型，准备好输入图和掩码，设定好提示词，连线运行即可。官方仓库里通常有现成的 JSON 工作流可以参考，直接导入能省去很多摸索时间。

对于批量任务，利用内置的批处理功能可以一次性处理多张图片，效率提升明显。遇到大尺寸图片时，显存可能会吃紧，这时候可以用 CutForInpaint 节点先切割图像，修完再合并，避免崩溃。

物体移除是常用场景，配合 PowerPaint 功能，在提示词中加入'空场景模糊'这类引导词，能让背景融合得更自然。

关键参数调优

参数的微调往往决定了最终效果的细腻程度。

BrushNet 的 scale 控制强度，默认 1.0，数值越大越贴近原图意图。start_at 和 end_at 定义了干预的时间窗口。如果希望保留更多原图结构，可以让 BrushNet 晚一点介入；反之则让它早点参与构建。

PowerPaint 方面，save_memory 选项对显存紧张的用户很友好。另外，HiDiffusion 里的 RAUNet 技术能有效修正手指多余、面部扭曲等问题，开启相关参数能显著改善细节质量。

避坑指南与建议

实际使用中可能会遇到兼容性问题，比如某些高级 FreeU 节点可能与 BrushNet 冲突，建议优先保证主流程稳定。模型更改操作最好放在 BrushNet 节点之前执行。

掩码形状不规则时效果可能打折，尽量保持选区平滑。如果结果不够理想，可以尝试 Blend Inpaint 节点混合原图与修复结果，或者调整采样步数。

最好的学习方式是动手尝试，多观察不同参数组合下的变化，很快就能找到适合自己的工作流。