EasyLoader (Kolors)(kolorsLoader)

EasyLoader (Kolors) 节点（kolorsLoader）可一步加载完整的 Kolors 推理管线，包括 UNet、VAE、ChatGLM3 文本编码器以及可选的 LoRA。它位于 EasyUse/Loaders 类别中。除了返回准备好的 MODEL 和 VAE 之外，它还会构建 PIPE_LINE，下游 EasyUse 节点可以直接使用。

描述

Kolors 是一个文生图模型系列，使用 ChatGLM3 作为其文本编码器，而非基于标准 CLIP 的编码器。该加载器专为此架构而设计：它加载所需的模型组件，并在单个节点中构建 EasyUse 管线、模型和 VAE。由于提示词编码必须使用 ChatGLM3，因此 chatglm3_name 组件为必填项。

输入

必填

• unet_name（组合）：选择要加载的 Kolors UNet 文件。
• vae_name（组合）：选择用于解码 Latent 的 VAE 文件。
• chatglm3_name（组合）：选择用于编码 positive 和 negative 的 ChatGLM3 文本编码器文件。
• lora_name（组合）：选择要应用的 LoRA。可用选项是 ComfyUI 已知的 LoRA 文件。
• lora_model_strength（浮点，默认=1，最小值=-10，最大值=10，步长=0.01）：应用于扩散模型权重的 LoRA 强度。0 会禁用模型侧的 LoRA 效果；负值会将其反转。
• lora_clip_strength（浮点，默认=1，最小值=-10，最大值=10，步长=0.01）：应用于 ChatGLM3 文本编码器权重的 LoRA 强度。0 会禁用文本编码器侧的 LoRA 效果；负值会将其反转。
• resolution（组合，默认="1024 x 576"）：预设快捷方式，可将 empty_latent_width 和 empty_latent_height 设置为标准值。选择预设之后仍可手动输入自定义尺寸。
• empty_latent_width（整数）：要创建的空 Latent 的宽度。此值通常由 resolution 组合设置，但可针对自定义尺寸进行覆盖。
• empty_latent_height（整数）：要创建的空 Latent 的高度。此值通常由 resolution 组合设置，但可针对自定义尺寸进行覆盖。
• positive（字符串，默认=""）：正面提示词文本。它使用所选的 ChatGLM3 文本编码器进行编码。
• negative（字符串，默认=""）：负面提示词文本。它使用所选的 ChatGLM3 文本编码器进行编码。
• batch_size（整数，默认=1，最小值=1，最大值=64）：在管线中创建的 Latent 数量。数值越高，占用显存越多。

可选

• model_override（模型）：连接时，节点将使用此模型，而不是从 unet_name 加载 UNet。
• vae_override（VAE）：连接时，节点将使用此 VAE，而不是从 vae_name 加载 VAE。
• optional_lora_stack（LoRA 堆栈）：在此连接 LoRA 堆栈，以便在主要的 lora_name 选择之外应用多个 LoRA。
• auto_clean_gpu（布尔，默认=否）：启用后将在加载后尝试自动清理 GPU，可在频繁切换模型时降低显存压力。如果希望将已加载模型缓存在内存中以供重复采样使用，请禁用此选项。

输出

• PIPE_LINE：一个 EasyUse 管线对象，包含已加载的模型、VAE、提示词、Latent 宽度/高度和批处理大小。将其连接到支持管线的 EasyUse 节点以进行采样。
• MODEL：加载并应用所选 LoRA、LoRA 堆栈或模型覆盖之后的有效模型。可与标准 ComfyUI 采样节点一起使用。
• VAE：加载并应用任何 VAE 覆盖之后的有效 VAE。用于将 Latent 解码为图像。

使用说明

• Kolors 使用 ChatGLM3 而非通常的 CLIP 文本编码器。若要更改提示词编码器，请使用 chatglm3_name。
• resolution 菜单是为了方便设置 empty_latent_width 和 empty_latent_height。选择预设会覆盖这些字段，因此如果需要的宽高比不同，请在之后输入自定义值。请保持尺寸与 Latent 格式兼容，通常要求为 8 或 16 的倍数。
• LoRA 强度彼此独立：lora_model_strength 影响扩散模型权重，而 lora_clip_strength 影响 ChatGLM3 文本编码器权重。值为 0 会禁用 LoRA 的相应侧，组件也接受负值。
• 如果需要多个 LoRA，请连接 optional_lora_stack；主要的 lora_name LoRA 仍会被应用，除非将其强度设置为 0 或选择无操作条目。
• 当已在节点图的其他位置加载模型或 VAE 时，请使用 model_override 和 vae_override。这样可以避免从磁盘重新加载相同文件，并允许您在多个加载器配置之间复用资源。