Easy Apply Inpaint 节点：ComfyUI-Easy-Use 图像修复指南(applyInpaint)

描述

Easy Apply Inpaint 节点（applyInpaint）在通过节点图传递 EasyUse PIPE_LINE 的同时，对图像执行基于蒙版的图像修复。它属于 EasyUse/Inpaint 类别，并返回已更新的 PIPE_LINE，因此它被设计为插入 EasyUse 管道流程中，而非用作独立输出节点。

该节点接收输入图像、蒙版和管道对象，然后使用已选择的后端和条件策略执行一次图像修复。它提供蒙版展开、计算精度、调度以及可选噪波蒙版处理的控制项。

输入

pipe

• 类型：PIPE_LINE（必填）
• 携带模型、VAE、条件、Latent 及其他工作流状态的 EasyUse 管道对象。图像修复操作在此管道的上下文中执行，并返回已更新的管道作为输出。

image

• 类型：IMAGE（必填）
• 需要修复的图像。在大多数工作流中，这是包含要修改的对象或区域的原始图像。

mask

• 类型：MASK（必填）
• 指示要修复区域的单通道蒙版。非零区域被视为要重新生成的区域。

inpaint_mode

• 类型：COMBO（必填）
• 选项：normal、fooocus_inpaint、brushnet_random、brushnet_segmentation、powerpaint

选择图像修复后端或策略：

• normal：标准图像修复行为。
• fooocus_inpaint：Fooocus 风格的图像修复。
• brushnet_random：使用随机生成模式的 BrushNet 图像修复。
• brushnet_segmentation：由分割信息引导的 BrushNet 图像修复。
• powerpaint：基于 PowerPaint 的图像修复，使 function 选择器适用于不同任务类型。

encode

• 类型：COMBO（必填，默认 "none"）
• 选项：none、vae_encode_inpaint、inpaint_model_conditioning、different_diffusion

控制输入图像和蒙版如何为图像修复过程进行编码或条件处理：

• none：不应用额外的图像修复专用编码。
• vae_encode_inpaint：使用专用于图像修复的 VAE 编码路径。
• inpaint_model_conditioning：使用针对图像修复模型设计的条件。
• different_diffusion：使用不同扩散风格的条件与推理策略。

grow_mask_by

• 类型：INT（必填，默认 6，范围 0–64，步长 1）
• 在图像修复之前展开蒙版的像素数。展开蒙版有助于避免生硬边缘，并让模型有空间将已生成内容混合到周围区域。

dtype

• 类型：COMBO（必填）
• 选项：float16、bfloat16、float32、float64
• 用于图像修复计算的精度。float16 通常最快且内存占用最少；在兼容硬件上可能更倾向使用 bfloat16；float32 和 float64 会提高数值精度，但会牺牲性能。

fitting

• 类型：FLOAT（必填，默认 1，范围 0.3–1）
• 控制已修复内容与已选择行为的拟合程度。1 是默认的完整拟合值；较低的值可用于降低条件强度或允许更松散的结果。

function

• 类型：COMBO（必填）
• 选项：text guided、shape guided、object removal、context aware、image outpainting

选择图像修复操作的语义行为，尤其是在支持不同任务类型的模式中：

• text guided：由文本提示驱动的生成。
• shape guided：由形状信息引导的生成。
• object removal：移除对象并自然填充该区域。
• context aware：对蒙版区域进行上下文感知填充。
• image outpainting：将图像扩展到现有边界之外。

scale

• 类型：FLOAT（必填，默认 1，范围 0–10）
• 应用于图像修复操作的附加比例乘数。1 是中性默认值；较高的值会放大图像修复模型使用的比例。

start_at / end_at

• 类型：INT（必填；start_at 默认 0，end_at 默认 10000，范围 0–10000）
• 定义受图像修复操作影响的采样与去噪范围的开始和结束。默认的 0–10000 覆盖完整调度。限制此范围可用于轻度修整，而非完全重新生成。

noise_mask

• 类型：BOOLEAN（可选，默认 true）
• 启用后，节点在采样期间使用噪波蒙版，使蒙版图像修复区域从噪波扩散，而未蒙版区域得以保留。当已选择的编码或条件路径已处理蒙版，或需要减少内存使用时，可禁用此选项。

输出

PIPE_LINE

• 包含图像修复结果及相关状态的已更新 EasyUse 管道。使用下游节点来解码、预览或保存结果。

使用说明

• 除 noise_mask 外，所有输入均为必填，因此节点可以直接执行图像修复过程。
• 该节点仅返回一个 PIPE_LINE；它不会输出独立的图像或蒙版。
• 对于 PowerPaint 风格的任务选择，请将 inpaint_mode 设置为 powerpaint，然后选择所需的 function。
• 当输入蒙版紧贴对象时，增大 grow_mask_by 是减少可见接缝的实用方法。
• 使用 inpaint_model_conditioning 或 different_diffusion 等 encode 模式时，请分别测试 noise_mask 的开启和关闭，因为其交互效果取决于图像修复模型和采样器。
• start_at 和 end_at 使用 0–10000 的比例。较窄的窗口可用于细微编辑：将 start_at 设置得足够高以跳过早期结构形成步骤，或将 end_at 设置得较低以避免完全覆盖精细细节。