EasyKSampler（图像修复）(samplerSimpleInpainting)

描述

EasyKSampler（图像修复） 节点是 ComfyUI-Easy-Use 包中专为基于遮罩/区域的图像修复工作流而构建的采样器。它接收一个 EasyUse PIPE_LINE，可选择覆盖模型和遮罩，并输出已更新的管道、结果图像以及采样过程中使用的 VAE。

输入

pipe

包含模型、条件、潜变量、VAE 及其他工作流状态的 EasyUse PIPE_LINE。此节点从该管道中读取采样输入，并返回一个已更新的管道，该管道可链接到下游的 EasyUse 节点。

grow_mask_by

一个整数，用于控制采样之前将图像修复遮罩扩展多少像素。取值范围为 0 到 64，默认值为 6。扩展遮罩有助于确保采样区域与周围图像上下文自然融合。

image_output

控制采样之后对输出图像执行的操作。

• Hide（隐藏）：不显示或保存输出图像。
• Preview（预览）：在 UI 预览中显示图像。
• Save（保存）：使用 save_prefix 保存图像。
• Hide&Save（隐藏并保存）：保存图像但不预览。
• Sender（发送）：将图像发送到 link_id 指定的工作流连线。
• Sender&Save（发送并保存）：将图像发送到工作流连线，同时保存图像。

默认值：Preview

link_id

当 image_output 为 Sender 或 Sender&Save 时使用的整数连线 ID。它决定已生成图像的发送位置。对于其他图像输出模式无效。

save_prefix

保存输出图像时使用的文件名前缀。仅当 image_output 包含 Save 时相关。

默认值：ComfyUI

additional

要使用的辅助图像修复策略。这会改变采样过程中遮罩和条件的应用方式。

• None（无）：使用提供的遮罩进行标准图像修复。
• InpaintModelCond：使用模型原生的图像修复条件路径。
• Differential Diffusion（差异扩散）：使用差异扩散，将遮罩值视为逐像素的去噪强度。
• Fooocus Inpaint（Fooocus 图像修复）：应用 Fooocus 图像修复策略。
• Fooocus Inpaint + DD（Fooocus 图像修复 + 差异扩散）：组合 Fooocus 图像修复与差异扩散。
• Brushnet Random（Brushnet 随机）：使用 Brushnet，搭配随机生成的遮罩引导。
• Brushnet Random + DD（Brushnet 随机 + 差异扩散）：组合 Brushnet 随机与差异扩散。
• Brushnet Segmentation（Brushnet 分割）：使用 Brushnet，搭配基于分割的引导。
• Brushnet Segmentation + DD（Brushnet 分割 + 差异扩散）：组合 Brushnet 分割与差异扩散。

默认值：None

model

可选的模型覆盖。如果提供，则使用此模型进行采样，而不是 pipe 中的模型。

mask

可选的遮罩覆盖。如果提供，则使用此遮罩作为图像修复区域，而不是 pipe 中的遮罩。

输出

PIPE_LINE

已更新的 EasyUse 管道，包含图像修复之后的采样状态。可将其传递给另一个 EasyUse 节点以继续工作流。

IMAGE

图像修复采样完成后的最终输出图像。

VAE

与图像修复过程关联的 VAE。这对于下游的编码/解码操作非常有用。

使用说明

此节点专为已使用 EasyUse 管道的图像修复工作流而设计。典型用法是连接来自 EasyUse 加载器/采样器链的管道，可选择提供遮罩，并使用返回的管道进行进一步处理。

当 model 或 mask 未连接时，此节点会回退到 pipe 中存储的模型或遮罩。grow_mask_by 设置可在采样之前扩展图像修复区域，有助于避免生硬的遮罩边缘。

对于 Brushnet 和 Differential Diffusion 选项，请确保模型和管道状态与已选择的附加策略兼容。+ DD 变体将基础策略与差异扩散风格的去噪强度处理组合在一起。