EasyKSampler (LayerDiffuse)(samplerSimpleLayerDiffusion)

描述

EasyKSampler (LayerDiffuse) 节点运行 Easy-Use KSampler pipeline，支持 Layer Diffusion 透明图像生成。它专为放入 PIPE_LINE 工作流而设计，可放在您通常放置常规 Easy KSampler 的位置，当您希望结果包含带有透明度通道的前景图层时即可使用。

此节点从 pipe 中读取模型、条件、Latent、VAE 及其他采样数据，执行采样步骤，并返回已更新的 pipe、已解码的图像以及 Layer Diffusion 过程生成的透明度遮罩。

输入

pipe

包含完整采样状态（模型、正面/负面条件、Latent 图像、VAE 等）的 PIPE_LINE。这是其他 Easy-Use 节点使用的同一个 pipe，因此此节点可直接插入现有的 Easy-Use 采样链中。除非显式覆盖，否则所有必需的采样数据均取自此输入。

image_output

控制采样之后对已生成图像执行的操作。可为以下值之一：

• Hide（隐藏）：图像会在 IMAGE 输出中返回，但不会显示在 UI 中，也不会保存。
• Preview（预览）：图像会发送到 UI 进行预览（默认）。
• Save（保存）：图像会保存到磁盘，不进行预览。
• Hide&Save（隐藏并保存）：图像会保存，但不预览。
• Sender（发送）：图像会通过 link_id 发送到另一个工作流中匹配的接收节点。
• Sender&Save（发送并保存）：图像既会通过 link_id 发送，也会保存到磁盘。

link_id

一个整数，当 image_output 设置为 Sender 或 Sender&Save 时，用于将此节点与接收节点配对。发送方和接收方必须使用相同的 link_id，图像才能被正确路由。对于其他 image_output 模式，此值将被忽略。

save_prefix

保存输出图像时使用的文件名前缀。图像将写入 ComfyUI 输出目录，文件名以此前缀开头。默认值：ComfyUI。

model

可选的 MODEL 输入。连接后，它将为此采样步骤覆盖 pipe 中存储的模型。当您需要使用不同的 checkpoint、refiner 或应用了不同 LoRA/注意力修改的模型进行采样，而无需重建整个 pipe 时，此功能非常有用。

输出

PIPE_LINE

已更新的 pipe，其中写入了采样后的 Latent 和采样后状态。将其链接到后续的 Easy-Use 节点（如 VAE 解码、图像放大或第二阶段采样），以继续工作流。

IMAGE

由采样器生成的已解码结果图像。

IMAGE (Layer Diffusion)

Layer Diffusion 感知的图像输出。当 Layer Diffusion 激活时，此图像携带已生成内容的透明度图层信息（RGBA）。

MASK

与 Layer Diffusion 透明度通道对应的透明度遮罩。使用此输出可将已生成的前景图层从背景中分离，或将其作为合成/透明度感知节点的输入。

使用说明

• 当 pipe 已设置为 Layer Diffusion（例如使用 Layer Diffusion checkpoint 或模型配置）时，此节点可直接替代常规的 Easy-Use KSampler。
• 除非您确实需要使用与 pipe 中存储的模型不同的模型进行采样，否则请保持 model 输入不连接。
• 如果只需要标准 RGB 图像，请使用第一个 IMAGE 输出。如果要合成透明前景，请将第二个 IMAGE 输出与 MASK 输出配合使用。