asagi4/comfyui-prompt-control

ComfyUI 提示词控制

这是一个 ComfyUI 扩展，允许你使用纯文本提示词来控制复杂的 AI 图像生成工作流，而无需手动连接数十个节点。

功能介绍

在 ComfyUI 中，复杂的工作流（例如在提示词更改时进行调度，或在不同步骤加载不同的 LoRA）需要构建一个由相互连接的节点组成的混乱“面条汤”。该工具会解析一种特殊的文本语法，并为你自动生成该节点图。它可以从单个文本框中处理提示词调度、LoRA 加载、高级文本编码和区域提示词。

主要特性

• 提示词调度：在特定步骤之间切换提示词（例如，[cat:dog:0.1] 会在生成的 10% 处从猫切换到狗）。
• LoRA 调度：使用 ComfyUI 内置的钩子系统来加载和调度 LoRA（微调模型适配器）。
• 高级文本编码：使用 PCTextEncode 节点进行针对每个编码器的提示词（对于拥有多个文本编码器的 SDXL/Flux 非常有用），使用 BREAK 和 AND 等提示词组合器，以及不同的权重解释风格。
• 区域提示词：实现 Attention Couple，以便将不同的提示词应用于图像的不同区域（例如，背景中的狗，前景中的猫）。
• 惰性图执行：像 PCLazyTextEncode 这样的节点只会重新编码调度中实际发生变化的部分，从而加快迭代速度。
• 宏与片段：将非常复杂的提示词组织成可重用的片段。

工作原理

你使用特殊语法编写提示词。该扩展的解析器（为了速度使用 parsy 库重写）会读取此文本。然后，像 PCLazyTextEncode 和 PCLazyLoraLoader 这样的节点会动态构建底层 ComfyUI 图，该图由标准节点（如 CLIPTextEncode 和 LoraLoader）组成。它将繁重的工作委托给 ComfyUI 的核心引擎，因此它与大多数模型和其他自定义节点保持兼容。

使用场景

• 无需手动连接数十个节点即可创建复杂的动态图像工作流。
• 在生成的特定步骤之间切换主体或风格。
• 在生成过程的不同时间应用不同的 LoRA。
• 从单个文本提示词进行区域提示词（例如，控制前景与背景元素）。

值得注意的技术细节

• 需要 ComfyUI v0.8.0 或更高版本（v3.0.0+）。
• 与现有工作流向后兼容。
• Cutoff 功能（用于提示词掩码）与 Flux 模型使用的非 CLIP 文本编码器不兼容。