EasyControlnet 节点：ComfyUI ControlNet 加载与应用指南(controlnetSimple)

描述

EasyControlnet 节点（controlnetSimple）是 EasyUse/加载器 类别中的加载器/应用节点。它接收现有 pipeline 和控制图像，将 ControlNet 模型应用于该 pipeline 的条件，并返回更新后的 pipeline 以及正面和负面条件输出。

此节点有两种使用方式：从 control_net_name 下拉框中按名称选择 ControlNet，或者将已加载的 CONTROL_NET 对象直接连接到可选的 control_net 输入。

输入

pipe

一个包含当前工作模型、正面和负面条件、latent 以及其他 pipeline 状态的 PIPE_LINE。ControlNet 将应用于此 pipeline 的条件，更新后的 pipeline 将作为第一个输出返回。

image

用于 ControlNet 条件图像的 IMAGE tensor。该图像应与已选择的 ControlNet 所期望的输入匹配，例如边缘图、骨骼姿态、深度图或其他结构引导。

control_net_name

一个必填的组合框，列出可用的 ControlNet 模型。按名称选择要加载的模型。可用条目来自环境中已安装的 ControlNet 模型。

control_net

可选的 CONTROL_NET 输入。如果将已加载的 ControlNet 对象连接到这里，则将使用该对象，而不再按名称加载模型。

strength

浮点类型，默认值 1.0，范围 0.0 到 10.0，步长 0.01。

控制 ControlNet 对条件的影响程度。值为 0.0 时禁用其影响；值越高，对控制图像结构的约束越强。

scale_soft_weights

浮点类型，默认值 1.0，范围 0.0 到 1.0，步长 0.001。

缩放 ControlNet 的软权重。较低的值会减少逐块/软权重的贡献，而 1.0 则应用完整的软权重缩放。

输出

pipe 输出

包含已应用 ControlNet 条件的更新后 PIPE_LINE，可随时传递给下游 pipeline 节点。

conditioning（正面）

已应用 ControlNet 的正面条件。将其连接到采样器的正面条件输入。

conditioning（负面）

已应用 ControlNet 的负面条件。将其连接到采样器的负面条件输入。

输出顺序为：更新后的 PIPE_LINE、正面条件、然后是负面条件。

使用说明

• 将两个 CONDITIONING 输出与 KSampler 或兼容的采样器节点一起使用。
• 如果需要应用多个 ControlNet，请串联额外的 EasyControlnet 节点，或在采样之前组合条件。
• control_net_name 下拉框是节点界面中的必填项；当连接了显式的 control_net 对象时，它将直接提供模型。
• 从 strength 值 1.0 开始，并根据控制图像对结果的驱动强度进行调整。
• 从 scale_soft_weights 值 1.0 开始；仅当 ControlNet 过度贡献或产生伪影时才降低该值。
• 控制图像的尺寸通常应与已生成图像相同，或由模型 pipeline 进行一致的缩放。