EasyLoader (HunyuanDiT)(hunyuanDiTLoader)

描述

EasyLoader (HunyuanDiT) 是一个便捷加载器，面向基于 HunyuanDiT 的工作流。它加载所选的 HunyuanDiT checkpoint 和 VAE，可选地应用 LoRA，并将模型、Latent 设置和提示词文本打包到 PIPE_LINE 中，供下游采样使用。它还直接提供已加载的 MODEL 和 VAE，使其既可与 EasyUse pipeline 节点配合使用，也可用于标准的 ComfyUI 采样器工作流。

输入

• ckpt_name (组合, 必填): 要加载的 HunyuanDiT checkpoint。
• vae_name (组合, 必填): 要加载并用于解码 Latent 的 VAE。
• lora_name (组合, 必填): 要应用于已加载 checkpoint 的 LoRA。
• lora_model_strength (浮点, 必填, 默认=1, 范围 -10 到 10): 应用于模型权重的 LoRA 强度。
• lora_clip_strength (浮点, 必填, 默认=1, 范围 -10 到 10): 应用于文本编码器/CLIP 侧的 LoRA 强度。
• resolution (组合, 必填, 默认 "1024 x 1024"): 用于生成 Latent 的分辨率预设。
• empty_latent_width (整数, 必填): 要为生成创建的空 Latent 的宽度。
• empty_latent_height (整数, 必填): 要为生成创建的空 Latent 的高度。
• positive (字符串, 必填, 默认 ""): 用于构建条件的正面提示词文本。
• negative (字符串, 必填, 默认 ""): 用于构建条件的负面提示词文本。可留空。
• batch_size (整数, 必填, 默认=1, 最小值=1, 最大值=64): 批处理中要创建的 Latent 数量。
• optional_lora_stack (LORA_STACK, 可选): 要应用的额外 LoRA 堆栈，每个条目带有各自独立的模型和 CLIP 强度。
• optional_controlnet_stack (CONTROL_NET_STACK, 可选): 在构建模型 pipeline 时要应用的 ControlNet 堆栈。

输出

• PIPE_LINE: 一个 EasyUse pipeline，包含已加载的模型、VAE、提示词条件和 Latent 设置，供下游 EasyUse 节点使用。
• MODEL: 应用 LoRA 和 ControlNet 修改之后的已加载 HunyuanDiT 模型，可直接用于采样器。
• VAE: 已加载的 VAE，可直接将 Latent 解码为图像。

使用说明

• 此节点旨在作为 HunyuanDiT 的一体化起点。将 PIPE_LINE 连接到 EasyUse pipeline 采样器，或在标准采样器工作流中直接使用 MODEL 和 VAE。
• resolution 组合是选择常用画布尺寸的便捷方式。请确保 empty_latent_width 和 empty_latent_height 与你想要生成的实际像素尺寸匹配。
• LoRA 既可通过 lora_name 以单个 LoRA 的形式提供（并分别设置模型和 CLIP 强度），也可通过 optional_lora_stack 以堆栈的形式提供，以便一次性组合多个 LoRA。
• ControlNet 设置通过 optional_controlnet_stack 提供；各个强度和预处理器设置由堆栈条目携带，而不是单独的节点输入。
• positive 和 negative 提示词文本包含在 PIPE_LINE 中，因此下游采样器节点无需单独的条件加载器即可使用它们。
• 此节点不输出独立的 CLIP/文本编码器模型。条件在内部构建，并存储在 PIPE_LINE 输出中。