LoRA

定位

LoRA（Low-Rank Adaptation）是在基础模型上附加的小型权重，用于表达特定人物、物体、服装、画风或其他概念。它不能脱离兼容的基础模型独立生成。

模型文件通常放在：

ComfyUI/models/loras/

工作流

Load LoRA 位于模型加载与采样、提示词编码之间，同时修改 MODEL 和 CLIP：

Load Checkpoint.MODEL ─→ Load LoRA.model ─→ KSampler.model
Load Checkpoint.CLIP ──→ Load LoRA.clip ──→ CLIP Text Encode

参数	作用
lora_name	选择 LoRA 文件
strength_model	控制 LoRA 对模型权重的影响
strength_clip	控制 LoRA 对文本编码器的影响

0.6～1.0 可作为常见初始强度范围，但不是通用最佳值。推荐强度和触发词应以 LoRA 发布页为准。

触发词

部分 LoRA 只有在提示词包含指定触发词时才会明显生效。

检查内容：

• LoRA 对应的基础模型家族。
• 推荐的 strength_model 和 strength_clip。
• 必需或可选的触发词。
• 推荐分辨率、采样器和提示词结构。

叠加

多个 Load LoRA 可以串联：

Checkpoint → LoRA A → LoRA B → KSampler

叠加时应：

1. 分别测试每个 LoRA。
2. 固定 seed 和其他参数。
3. 从较低强度开始组合。
4. 记录顺序、强度和触发词。

效果过强、构图僵化或出现伪影时，先降低强度或移除其中一个 LoRA。

模型兼容

LoRA 需要与基础模型架构兼容。文件能被节点识别，不代表一定可以正确应用。

例如：

• SD 1.5 LoRA 通常不能用于 SDXL。
• Flux LoRA 不能直接用于 Z-Image。
• 仅修改 MODEL 的 LoRA 可能需要 LoraLoaderModelOnly 等对应节点。

排查

1. 检查 LoRA 是否放在 models/loras/。
2. 检查 LoRA 和基础模型是否属于同一模型家族。
3. 检查是否需要触发词。
4. 检查 MODEL 和 CLIP 输出是否接入后续流程。
5. 移除其他 LoRA，使用固定 seed 单独测试。
6. 调整强度并查看日志是否出现权重不匹配。