%20(1).png)
ComfyUI-Loop 插件：让图片在工作流中循环处理的神器
1. 插件简介
插件地址： https://github.com/Hullabalo/ComfyUI-Loop
ComfyUI-Loop 是一个专门为循环处理图片而设计的插件。简单来说，它就像一个"图片传送带"，能让你的图片在工作流中不断循环处理，特别适合用于图片修复（inpainting）的场景。
想象一下，你有一张需要反复修复的图片，传统方法需要你手动保存、重新加载、再处理，非常麻烦。而这个插件就像一个自动化的助手，它会把处理完的图片自动保存到指定位置，然后下次循环时自动加载回来继续处理，完全不需要你手动操作。
主要功能：
- 自动保存和加载图片，形成循环处理
- 支持图片切割和粘贴操作
- 保持图片质量不损失（即使循环1000次也不会糊）
- 特别适合图片修复、局部调整等需要反复处理的场景
2. 如何安装
有两种简单的安装方法：
方法一：使用 ComfyUI 管理器（推荐）
- 打开 ComfyUI 管理器
- 在搜索框中输入 "Loop"
- 找到 ComfyUI-Loop 插件点击安装
- 重启 ComfyUI 即可
方法二：手动安装
- 下载插件文件
- 将 ComfyUI-Loop 文件夹复制到 ComfyUI 的 custom_nodes 目录下
- 重启 ComfyUI
3. 节点详解
3.1 Load Image (LOOP) 节点 - 图片加载器
这个节点就像一个专门的图片读取器，它能从你的输出文件夹中读取图片文件，为循环处理做准备。
3.1.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 文件名字符串 | "image.png" | 告诉节点要加载哪个图片文件，就像告诉助手"去拿桌上的那本红色书" | 指定要加载的图片文件名称 | 输入 "my_photo.png" 就会加载这个文件 |
| 浏览按钮 | browse_button | 无 | 无 | 点击后会弹出文件选择窗口，让你用鼠标点击选择图片文件 | 提供图形化界面选择文件 | 点击浏览按钮，选择你想要的图片文件 |
3.1.2 输出说明
| 输出名 | 输出类型 | 通俗解释 | 专业解释 |
|---|---|---|---|
| IMAGE | 图像 | 加载出来的图片内容，就像从相册里拿出的照片 | 图像数据对象 |
| path | 文字 | 图片文件的完整路径地址，就像家庭住址 | 图片文件的完整路径字符串 |
3.2 LoopImageSimple 节点 - 简化版图片加载器
这是 Load Image (LOOP) 的简化版本，操作更简单，选择更灵活。
3.2.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image_name | image_name | 文件名字符串 | "loop_image.png" | 设置你想要的图片文件名，就像给照片起个名字 | 指定图片文件名称 | 输入 "my_loop.png" 创建这个名字的循环文件 |
| folder | folder | 文件夹名 | "output" | 选择图片保存在哪个文件夹，就像选择把照片放在哪个相册里 | 指定图片存储的文件夹路径 | 可以选择 "output" 或其他自定义文件夹 |
| image (可选) | image | 图像输入 | 无 | 如果你有现成的图片，可以直接连接进来，不用文件名 | 可选的图像输入接口 | 连接其他节点的图片输出 |
| mask (可选) | mask | 遮罩输入 | 无 | 如果需要遮罩，可以连接遮罩图像，就像给照片贴个贴纸 | 可选的遮罩输入接口 | 连接遮罩生成节点的输出 |
3.2.2 输出说明
| 输出名 | 输出类型 | 通俗解释 | 专业解释 |
|---|---|---|---|
| IMAGE | 图像 | 加载出来的图片内容 | 图像数据对象 |
| path | 文字 | 图片文件的完整路径地址 | 图片文件的完整路径字符串 |
3.3 Save Image (LOOP) 节点 - 图片保存器
这个节点就像一个智能的图片保存助手，它会把处理好的图片保存到指定位置，覆盖之前的文件，为下一次循环做准备。
3.3.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| images | images | 图像输入 | 必需 | 要保存的图片，就像要放进相册的照片 | 图像数据输入接口 | 连接处理节点的图片输出 |
| image_path | image_path | 路径文字 | 必需 | 图片保存的位置和名称，就像告诉助手"把照片放到桌上的红色文件夹里" | 图片保存的完整路径 | 通常连接 Load Image (LOOP) 的 path 输出 |
| mask (可选) | mask | 遮罩输入 | 无 | 如果需要透明效果，可以连接遮罩，就像给照片加个透明贴纸 | 可选的遮罩数据输入 | 连接遮罩生成节点的输出 |
| save_steps | save_steps | 开关 | False | 是否保存每一步的处理结果，就像拍照时是否保留每张试拍的照片 | 是否保存中间处理步骤 | 设为 True 会保存每次循环的结果副本 |
3.3.2 输出说明
| 输出名 | 输出类型 | 通俗解释 | 专业解释 |
|---|---|---|---|
| IMAGE | 图像 | 保存后的图片内容，用于后续处理 | 保存后的图像数据对象 |
3.4 Cut Image (LOOP) 节点 - 图片切割刀
这个节点就像一把精准的剪刀，能从大图片中切出指定的小块，方便对局部进行处理。
3.4.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图像输入 | 必需 | 要切割的原图片，就像要剪切的大海报 | 源图像数据输入 | 连接原始图片的输出 |
| x | x | 数字 | 0 | 切割起始点的水平位置，就像告诉剪刀从左边第几个像素开始剪 | 切割区域左上角的X坐标 | 设为 100 表示从左边第100个像素开始 |
| y | y | 数字 | 0 | 切割起始点的垂直位置，就像告诉剪刀从上边第几个像素开始剪 | 切割区域左上角的Y坐标 | 设为 50 表示从上边第50个像素开始 |
| width | width | 数字 | 512 | 切割区域的宽度，就像告诉剪刀要剪多宽 | 切割区域的宽度像素数 | 设为 256 表示切割区域宽256像素 |
| height | height | 数字 | 512 | 切割区域的高度，就像告诉剪刀要剪多高 | 切割区域的高度像素数 | 设为 256 表示切割区域高256像素 |
| mask (可选) | mask | 遮罩输入 | 无 | 如果有遮罩，可以用来指导切割，就像用模板剪纸 | 可选的遮罩输入，用于指导切割 | 连接遮罩节点的输出 |
3.4.2 输出说明
| 输出名 | 输出类型 | 通俗解释 | 专业解释 |
|---|---|---|---|
| IMAGE | 图像 | 切割出来的小图片 | 切割后的图像数据 |
| cutting_mask | 遮罩 | 切割位置的遮罩信息，记录了切割的位置 | 标记切割区域的遮罩数据 |
3.5 Paste Image (LOOP) 节点 - 图片粘贴器
这个节点就像一个精准的粘贴工具，能把处理好的小图片贴回到原来的大图片上。
3.5.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| base_image | base_image | 图像输入 | 必需 | 要粘贴到的底图，就像要贴贴纸的大海报 | 基础图像数据输入 | 连接原始大图的输出 |
| paste_image | paste_image | 图像输入 | 必需 | 要粘贴上去的小图片，就像要贴上去的贴纸 | 要粘贴的图像数据输入 | 连接处理后的小图片输出 |
| x | x | 数字 | 0 | 粘贴位置的水平坐标，就像告诉助手贴纸要贴在左边第几个位置 | 粘贴位置的X坐标 | 设为 100 表示贴在左边第100个像素位置 |
| y | y | 数字 | 0 | 粘贴位置的垂直坐标，就像告诉助手贴纸要贴在上边第几个位置 | 粘贴位置的Y坐标 | 设为 50 表示贴在上边第50个像素位置 |
| cutting_mask (可选) | cutting_mask | 遮罩输入 | 无 | 从 Cut Image 节点来的位置信息，自动知道要贴在哪里 | 来自切割节点的遮罩数据 | 连接 Cut Image 节点的 cutting_mask 输出 |
3.5.2 输出说明
| 输出名 | 输出类型 | 通俗解释 | 专业解释 |
|---|---|---|---|
| IMAGE | 图像 | 粘贴完成后的完整图片 | 粘贴完成后的图像数据 |
3.6 Crop Image 节点 - 图片裁剪器
这个节点提供了一个可视化的图片裁剪界面，让你能够直观地选择要保留的区域。
3.6.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图像输入 | 必需 | 要裁剪的图片，就像要修剪的照片 | 源图像数据输入 | 连接原始图片的输出 |
| crop_data | crop_data | 裁剪数据 | 界面操作 | 通过拖拽界面选择裁剪区域，就像用手指在触摸屏上画框 | 通过可视化界面设置的裁剪区域数据 | 在节点界面上拖拽选择要保留的区域 |
3.6.2 输出说明
| 输出名 | 输出类型 | 通俗解释 | 专业解释 |
|---|---|---|---|
| IMAGE | 图像 | 裁剪出来的图片 | 裁剪后的图像数据 |
4. 使用技巧和建议
4.1 基本循环流程设置
最简单的循环：
- 用 Load Image (LOOP) 加载初始图片
- 连接你的处理节点（比如 KSampler 生图节点）
- 用 Save Image (LOOP) 保存结果
- 把 Load Image (LOOP) 的 path 输出连接到 Save Image (LOOP) 的 image_path 输入
切割处理流程：
- Load Image (LOOP) 加载大图
- Cut Image (LOOP) 切出需要处理的部分
- 处理小图片（修复、生成等）
- Paste Image (LOOP) 把处理好的小图贴回大图
- Save Image (LOOP) 保存完整结果
4.2 参数设置建议
图片质量保护：
- 插件会自动保存为无损格式，不用担心画质损失
- 建议第一次使用时先复制一份原图，避免误操作
文件管理：
- 建议给循环图片起个容易识别的名字，如 "loop_portrait.png"
- 如果启用 save_steps，每次循环都会保存副本，注意硬盘空间
切割尺寸：
- 切割时建议尺寸设为 512x512 或 1024x1024 这样的标准尺寸
- 切割位置要确保不会超出原图边界
4.3 常见搭配组合
人像修复循环：
- Load Image (LOOP) → Cut Image (LOOP) → 人脸修复节点 → Paste Image (LOOP) → Save Image (LOOP)
风格化处理：
- Load Image (LOOP) → 风格化节点 → Save Image (LOOP)
局部重绘：
- Load Image (LOOP) → Cut Image (LOOP) → Inpaint 节点 → Paste Image (LOOP) → Save Image (LOOP)
5. 常见问题解答
5.1 安装和使用问题
Q: 为什么找不到 Loop 节点？
A: 确保正确安装了插件，并且重启了 ComfyUI。如果使用管理器安装，搜索 "Loop" 关键词。
Q: 循环后图片质量会不会降低？
A: 不会！插件特别设计了无损保存机制，即使循环1000次画质也不会损失。
Q: 为什么浏览按钮点击没反应？
A: 浏览按钮目前只能选择 output 文件夹中的图片，确保你的图片放在正确的位置。
5.2 操作问题
Q: 如何停止循环？
A: 在 ComfyUI 界面点击停止按钮，或者断开节点连接。
Q: 切割后粘贴位置不对怎么办？
A: 使用 Cut Image 节点的 cutting_mask 输出连接到 Paste Image 节点，会自动定位到正确位置。
Q: 可以处理多张图片吗？
A: 目前 Save Image (LOOP) 只支持单张图片，如果输入多张会只保存第一张。
5.3 兼容性问题
Q: Crop Image 节点不工作怎么办？
A: 这个节点在最新版本的 ComfyUI 中可能有兼容性问题，可以使用其他裁剪节点替代。
Q: 支持什么格式的图片？
A: 主要支持 PNG 格式，对 JPG/JPEG 的支持在新版本中被移除了。
6. 高级应用案例
6.1 渐进式图片优化
通过多次循环处理，可以实现渐进式的图片优化：
- 第一轮：基础降噪
- 第二轮：细节增强
- 第三轮：色彩调整
- 每轮都基于上一轮的结果继续优化
6.2 批量局部处理
对于需要处理多个局部区域的图片：
- 使用不同的切割参数创建多个 Cut Image 节点
- 分别处理各个区域
- 最后统一粘贴回原图
6.3 A/B 测试对比
利用 save_steps 功能：
- 启用步骤保存
- 尝试不同的处理参数
- 对比每次循环的结果
- 选择最佳效果
这个插件虽然看起来简单，但在实际使用中非常实用，特别是对于需要反复调整和优化的图片处理场景。配合其他 ComfyUI 节点使用，可以创造出很多有趣的自动化工作流程。