跳转至

Load LoRA 算子节点

从本地磁盘加载 LoRA 模型适配权重，并将其包装为下游管线能够接收的标准格式。

算子所属分类：ModularDiffusion/Pipeline

核心速查 (TL;DR)

  • 单节点对应单个 LoRA：每个节点负责装载一个独立的 LoRA 文件；若需叠加多个微调风格，可在画布中放置多个 Load LoRA 节点并将它们全部连入同一个消费端的插槽；
  • 两种截然不同的 LoRA 注入机制：
    • 融合至 Pipeline Builder (Fused 模式)：在构建管线阶段直接将 LoRA 权重永久融合（Bake/烘焙）到底模权重中。该模式下影响权重 weight 被固化锁定；调整权重会触发整个管线重新构建。适用于日常全局常驻的基础风格 LoRA；
    • 挂载至 LoRA Pipeline (Per-generation 运行时动态挂载模式)：在每次去噪推理前动态激活，生成完毕后自动释放。主干管线权重丝毫未变，因此在多轮生图之间随意微调 weight 绝不会触发管线重建。适用于 IC-LoRA、微调滑块 LoRA (Slider LoRAs) 或在不同分支间动态置换微调特征的工作流；
  • 兼容的文件格式后缀：.safetensors、.sft、.pt、.bin、.json、.lora。

典型工作流编排拓扑

# 方案 A：融合烘焙模式 (在构建管线时直接融合)
[Load LoRA] ─┐
[Load LoRA] ─┼─→ Pipeline Builder → Generate Media Latents
[Load LoRA] ─┘

# 方案 B：按次动态挂载模式 (在生成运行时动态加载/卸载)
Pipeline Builder ──┐
[Load LoRA] ───────┤→ LoRA Pipeline → Generate Media Latents
[Load LoRA] ───────┘

节点外观预览

Load LoRA 算子节点外观

输入端口规范 (Inputs)

端口名称 数据类型 是否必填 详细功能与业务规范说明
file_path 文件路径 (path) 是 本地磁盘上 LoRA 实体权重文件的物理绝对路径。
weight float (0.0~1.0) 否 该 LoRA 对主干模型特征的影响权重比例，出厂默认值为 1.0。

输出端口矩阵 (Outputs)

端口名称 数据类型 详细功能与业务规范说明
loras loras (字典映射) 包含 {path: weight} 映射关系的配置字典——直接连入 Pipeline Builder 或 LoRA Pipeline 的 loras 插槽。
trigger_phrase str 可选透传给下游提示词的特征触发词 (Trigger Word) 文本；默认折叠隐藏。

避坑技巧与最佳实践 (Tips & pitfalls)

  • 不支持直接填入 Hugging Face Repo ID：本节点仅面向本地磁盘物理文件；若模型托管在云端，请先将其下载至本地存储。
  • 架构必须与主干管线严密匹配：Flux LoRA 只能施加于 Flux 管线，SDXL LoRA 只能作用于 SDXL 管线。若架构不兼容，该异常会在下游管线构建装配时触发阻断，而非在 Load LoRA 加载本身抛出。
  • 融合模式下的权重固化特性：若将本节点连入 Pipeline Builder，由于采用了物理权重融合算法，若在两轮生图之间微调 weight，将无条件触发一次完整的显存管线重构。若需频繁微调测试 LoRA 强度，请始终改用 LoRA Pipeline 模式。
  • 触发词 (Trigger Phrase) 的使用：某些 LoRA 需要在提示词中显式附带特定的激活单词才能唤醒特定概念；请务必在生成节点的 Prompt 中手动附加上该词汇——本节点的 trigger_phrase 目前仅作为静态透传元数据使用。

推荐延伸阅读

  • Modular Diffusion Pipeline Builder — 消费融合式 (Fused) LoRA 的管线总构建器
  • LoRA Pipeline — 支持每轮生成动态即时装载/卸载 LoRA 的挂载节点
  • 开箱即用工作流样板：workflows/templates/LoRAText2Image.py