让 ComfyUI 更舒适！ 

这是一组在使用 ComfyUI 时创建的节点和改进。我制作它们是为了让我的工作流更整洁、更简单、更快速。欢迎你尝试使用它们。但请记住，我是为满足我自己的使用场景而制作的 :)

开始使用

安装

1. 安装优秀的 ComfyUi。
2. 将此仓库克隆到 custom_modules:

cd ComfyUI/custom_nodes
git clone https://github.com/rgthree/rgthree-comfy.git
复制

1. 启动 ComfyUI。

设置

你可以配置 rgthree-comfy 的某些方面。例如，如果未来 ComfyUI 的更改破坏了 rgthree-comfy，或者你已经安装了其他具有类似功能的扩展，并希望为 rgthree-comfy 关闭该功能。

你可以通过右键点击画布空白部分并选择 rgthree-comfy > Settings (rgthree-comfy) 来访问 rgthree-settings，或者点击 ComfyUI 设置对话框中的 rgthree-comfy settings。

（注意，设置存储在 rgthree-comfy 目录下的 rgthree_config.json 中。还有其他高级设置只能在那里配置；你可以在修改前从 rgthree_config.json.default 复制默认设置，然后再进行 rgthree_config.json）。

✴️ 节点

请注意，您可以右键点击许多 rgthree-comfy 节点，并在可用时选择 🛟 Node Help 菜单项以获取应用内帮助。

Seed（种子）

一个直观的 ComfyUI 种子控制节点，其工作方式与 Automatic1111 的种子控制非常相似。

ℹ️ 查看更多信息

• 将种子值设置为“-1”以每次使用随机种子
• 设置任何其他数字以用作静态/固定种子
• 快速操作可随机化，或（重新）使用上次排队的种子。
• 图像元数据将存储种子值 （因此拖入图像时，种子字段将已固定为其种子）。
• 隐藏功能：您可以手动将种子值设置为“-2”或“-3”以递增或递减上次的种子值。如果没有上次的种子值，则首次将随机使用。

Reroute（重新路由）

使用这个大幅改进的 Reroute 节点保持工作流程整洁，它支持多方向和尺寸的实际重新路由。

ℹ️ 更多信息

• 使用右键单击上下文菜单更改宽度、高度和连接布局
• 还可以切换可调整大小（如果调整大小，最小尺寸为 40x43），以及标题/类型显示。

Bookmark（书签 🔖）

将书签节点放置在屏幕上的任何位置，以便通过快捷键快速导航到该位置。

ℹ️ 查看更多信息

• 定义 shortcut_key 以按下后直接跳转到该书签节点，并锚定在左上角。
• 您还可以定义缩放级别！
• 专业提示：shortcut_key 可以是多个按键。例如，“alt + shift + !” 需要按下 alt 键、shift 键和“!”（即“1”键，但需按住 shift）才能触发。

上下文 / 大上下文

在常规流程中传递属性，并合并新数据。类似于其他节点套件中的“管道”，但更易于合并，并且通过在一个节点中同时组合和拆分，更容易与标准节点互操作。

ℹ️ 更多信息

• 上下文和大上下文节点彼此向后兼容。也就是说，连接到“大上下文”的输入将通过常规上下文节点的 CONTEXT 输出传递，并可在任一节点上作为输出使用（或者，如果输出仅存在于该节点上，如“steps”，则在大上下文节点上）。
• 专业提示：将上下文输出拖到另一个节点上时，按住“ctrl”并释放，即可自动将其他上下文输出连接到悬停的节点。
• 专业提示：您可以从菜单中在上下文和大上下文节点之间切换。

图像比较器

图像比较器节点将两张图像叠加在一起进行比较。

ℹ️ 更多信息

• 注意：右键菜单可能显示图像选项（如打开图像、保存图像等），如果点击节点的左半部分，这些选项将对应第一张图像（image_a）；如果点击右半部分，则对应第二张图像。
• 输入：
  • image_a 必填。用于比较的第一张图像。如果未提供 image_b 且 image_a 是一个批次，则比较器将使用 image_a 的前两张图像。
  • image_b 可选。用于比较的第二张图像。仅当 image_a 是包含两张图像的批次时才可选。
• 属性：您可以通过右键点击节点并从菜单中选择“属性”或“属性面板”来更改以下属性：
  • comparer_mode - 在“滑动”和“点击”之间选择。默认为“滑动”。

图像内嵌裁剪

该节点允许您通过像素值或百分比值来裁剪输入图像。

显示任意内容

在执行后显示来自后端的大多数任意文本数据。

Power Lora 加载器

一个超简单的 Lora 加载器节点，可以同时加载多个 Lora，并快速切换每个 Lora，全部集成在一个高度紧凑的节点中。

ℹ️ 更多信息

• 通过点击“+ 添加 Lora”按钮，您可以随意添加任意数量的 Lora。实际上没有限制！
• 右键点击 Lora 组件可获取特殊选项，用于将 Lora 上移或下移 （对图像无影响，仅影响展示效果），切换其启用/禁用状态，或直接删除整行。
• 在属性中，更改 Show Strengths 以选择显示单一的、简单的 强度值（该值将同时用于模型和剪辑），或显示更高级的视图，其中模型和剪辑的强度均可修改。

Lora 加载器堆栈

已弃用。请改用 Power Lora Loader。

一个简化的 Lora 加载器堆栈。与其他套件类似，但与标准输入/输出的互操作性更强。

Power Prompt

增强您的提示词，并获得用于添加嵌入、Lora 的下拉选项，甚至还可以保存提示词片段。

ℹ️ 更多信息

• 在核心层面，您几乎可以将 Power Prompt 用作字符串原始节点，并附带用于选择嵌入甚至 Lora 的下拉功能，无需进一步处理。这将仅输出原始的 TEXT 到另一个节点，用于任何 Lora 处理、CLIP 编码等。
• 将 CLIP 连接到输入以对文本进行编码，并直接从节点输出 CLIP 和 CONDITIONING。
• 将 MODEL 连接到输入以自动解析并加载文本中的任何 <lora:...> 标签，无需单独的 Lora 加载器。

Power Prompt - Simple

与上述 Power Prompt 相同，但不支持 LORA；专为更简洁的负面提示词而设计 （因为负面提示词不支持 loras）。

SDXL Power Prompt - Positive

上述 Power Prompt 的 SDXL 版本。它包含 text_g 和 text_l 作为独立的文本输入，以及更多必要的输入插槽，以确保正确的 clipe 编码。请与

SDXL Power Prompt - Simple

与非 SDXL 的 Power Prompt - Simple 节点类似，此节点本质上与 SDXL Power Prompt 相同，但不支持 lora，适用于非 lora 的正面提示词或 SDXL 负面提示词 （因为负面提示词不支持 loras）。

SDXL Config

仅为 SDXL 提示词提供一些配置字段。说实话，也可用于非 SDXL 场景。

Context Switch / Context Switch Big

一个强大的节点，用于分支你的工作流。其工作原理是选择第一个非 null/空 的 Context 输入。

ℹ️ 更多信息

• 传入多个上下文节点，Context Switch 将自动选择第一个非 null 的上下文继续执行。
• 想知道如何将上下文切换为 null？请与 Fast Muter 或 Fast Groups Muter 结合使用。

Any Switch

一个强大的节点，类似于上述 Context Switch，选择第一个非 null/空 的输入。

ℹ️ 更多信息

• 传入多个相同类型的输入，Any Switch 将自动选择第一个非空值继续执行。
• 想知道如何将上下文切换为 null？请与 Fast Muter 或 Fast Groups Muter 结合使用。

Power Primitive

一个单一节点，可以输出原始类型（STRING、INT、FLOAT、BOOLEAN）。如果连接输入，它会将原始输入转换/强制转换为所需的输出类型。

ℹ️ 更多信息

• 您可以从右键菜单或属性中隐藏类型选择器输入。
• 您也可以从右键菜单中快速切换输出类型。

Power Puter

一个强大且多功能的节点，通过提供多行代码解析输出来开启广泛的实用功能。此节点可用于简单的字符串拼接或数学运算；也可用于图像尺寸或节点小部件的高级列表推导。如果您想在 Workflow 中输出某些内容，这个节点就是您需要的。

更多文档可在 wiki 中查看。

ℹ️ 更多信息

• 评估几乎任何类型的输入及更多内容，并从 INT、FLOAT、STRING 或 BOOLEAN 中选择输出。
• 连接一些节点，执行简单的数学运算，如 a + b 或 ceil(1 / 2)。
• 或者进行更高级的操作，比如输入一张图像，获取宽度，如 a.shape[2]。
• 更强大的是，你可以针对发送到后端的提示中的节点。例如，如果你有一个 ID 为 #5 的 Power Lora Loader 节点，并希望获取已启用的 loras 的逗号分隔列表，你可以输入：

loras = [v.lora for v in node(5).inputs.values() if 'lora' in v and v.on]
', '.join(loras)
复制

快速组静音器

快速组静音器是一个无输入节点，它会自动收集当前工作流中的所有组，并允许你快速静音或取消静音组内的所有节点。

• ℹ️ 更多信息组会自动显示，但你可以在节点属性中进行筛选、排序等操作（右键点击节点，从菜单中选择“属性”或“属性面板”）。属性包括：
• matchColors - 仅添加匹配指定颜色的组。可以是 ComfyUI 颜色（如 red、pale_blue）或十六进制代码（如 #a4d399）。可添加多个，用逗号分隔。
• matchTitle - 按标题匹配（字符串匹配或正则表达式）筛选开关列表。
• showNav - 添加/移除快速导航箭头，用于跳转到组。（默认：true）
• showAllGraphs - 显示工作流中所有[子]图中的组。（默认：true）
• sort - 按“字母数字”、“图形位置”或“自定义字母表”对开关的顺序进行排序。（默认值：“位置”）
• customSortAlphabet - 当排序属性为“自定义字母表”时，您可以在此处定义要使用的字母表，该字母表将与每个组名称的开头匹配并据此排序。如果组标题与任何自定义字母表条目都不匹配，则它们将被放置在匹配的组之后，并按字母数字顺序排列。
• 这可以是单个字符的列表，例如“zyxw...”，也可以是逗号分隔的字符串，以便更精细地控制，例如“sdxl,pro,sd,n,p”。
• 请注意，当两个组标题匹配相同的自定义字母表条目时，常规的字母数字顺序将用于打破平局。例如，自定义字母表“e,s,d”将按“SDXL, SEGS, Detailer”的顺序排列组名称，尽管自定义字母表中“e”在“d”之前（有人可能期望“SE”在“SD”之前）。
• 要使“SEGS”出现在“SDXL”之前，您可以使用更长的字符串。例如，自定义字母表值“se,s,f”在这里可以起作用。
• toggleRestriction - 可选地，尝试将可启用的控件数量限制为最多一个，或始终为一个。
• 注意：如果使用“最多一个”或“始终一个”，则仅在此节点上点击开关时强制执行；如果组内的节点在初始开关点击之外被更改，则这些限制将不会强制执行，并可能导致启用多个开关的状态。如果节点与多个组重叠，也可能发生这种情况。

快速分组旁路器

与上述快速分组静音器相同，但将连接的节点设置为“旁路”而非“静音”

快速静音器

一个强大的“控制面板”节点，可快速切换连接的节点，使其能够快速被静音或启用

ℹ️ 更多信息

• 添加所有连接节点的集合，提供一个“仪表盘”式的单一位置，以便快速启用和禁用节点。有两个不同的节点：一个用于“静音”连接的节点，另一个用于“旁路”连接的节点。

快速旁路器

与快速静音器相同，但将连接的节点设置为“旁路”

快速操作按钮

哎呀，这个节点允许你对连接的节点和/或ConfyUI进行半自动化操作。

ℹ️ 更多信息

• 连接节点后，至少可以在按下按钮时将其静音、旁路或启用。
• 某些节点会暴露额外的操作。例如，Seed 节点可以在按下按钮时设置 Randomize Each Time 或 Use Last Queued Seed。
• 此外，在节点属性中，可以设置快捷键来触发按钮操作，无需点击！

节点收集器

用于清理面条状连接，此节点可接受任意数量的输入节点，并将其传递给另一个节点。

⚠️ 目前，此节点应仅连接到 快速静音器、快速旁路器 或 静音 / 旁路中继器。

静音 / 旁路中继器

一个功能强大的节点，会将自身的静音/旁路/激活模式分发给所有连接的输入节点；若处于无连接输入的组中，则会将自身的静音/旁路/激活模式分发给该组中的所有节点。

ℹ️ 更多信息

• 💡 专业提示 #1：将此节点的输出连接到 快速静音器 或 快速旁路器，即可在那里获得一个单一开关，一键静音/旁路/启用多个节点。
• 💡 专业提示 #2：将一个 静音 / 旁路中继器 节点连接到本节点的输入，中继器将自动向中继器分发静音/旁路/启用更改。

静音 / 旁路中继器

一个高级节点，与 静音 / 旁路中继器 配合使用时，会将其输入节点的模式（静音、旁路或激活）中继到所连接的中继器（该中继器随后会将此模式更改重复到其所有输入）。

ℹ️ 更多信息

• 当所有连接的输入节点被静音时，中继器将（默认）将连接的转发器设置为静音。
• 当所有连接的输入节点被旁路时，中继器将（默认）将连接的转发器设置为旁路。
• 当任意连接的输入节点处于活动状态时，中继器将（默认）将连接的转发器设置为活动状态。
• 注意： 如果没有连接输入，中继器将在其自身模式改变时将连接的转发器设置为其模式。注意，如果连接了任何输入，则上述条目将生效，中继器的模式无关紧要。
• 专业提示： 您可以在 Properties 中更改上述情况下发送的信号。例如，您可以配置一个反向中继器，当任何输入处于活动状态时发送静音信号（而不是发送活动信号），并在所有输入被静音时发送活动信号（而不是发送静音信号），等等。

随机取消静音器

一个高级节点，用于在图被排队时随机取消其一个输入的静音（并立即将其重新静音）。

ℹ️ 更多信息

• 注意： 所有输入节点必须一开始就处于静音状态；否则此节点不会随机取消另一个节点的静音。（这很强大，因为生成的图像可以被拖入，所选输入将已经取消静音并无需进一步操作即可工作。）
• 提示： 将转发器的输出连接到该节点的输入，并将该转发器放置在没有其他输入的组上，它将静音/取消静音整个组。

标签

这是一个纯视觉节点，允许你向工作流中添加一个浮动标签。

ℹ️ 更多信息

• 显示的文本是节点的“标题”，你可以从节点属性中调整字体大小、字体族、字体颜色、文本对齐方式，以及背景颜色、内边距、背景边框圆角和角度（以度为单位）。你可以双击节点以打开属性面板。
• 标题还支持字面序列“\n”，用于在绘制标签时插入换行。
• 专业提示 #1：你可以从属性面板添加多行文本 （因为 ComfyUI 只允许你在此处使用 Shift + Enter）。
• 专业提示 #2：你可以使用 ComfyUI 原生右键菜单中的“固定”选项，使标签固定在工作流上，并让点击“穿透”。你可以随时右键单击以取消固定。
• 专业提示 #3：颜色值是十六进制字符串，例如白色为“#FFFFFF”，深红色为“#660000”。你可以提供第 7 和第 8 个值（如果使用简写，则为第 5 个值）来创建半透明颜色。例如，“#FFFFFF88”是半透明白色。

高级技巧

首先，关于静音的一点说明

这些节点的许多强大功能来自于静音。静音是正确实现使用上下文切换节点的工作流多路径的基础。

虽然其他扩展可能提供开关，但它们常常出错，导致你的工作流执行不必要的额外工作。虽然其他开关可能有选择器来挑选要传递的输入，但它们不会停止其他输入的执行，从而造成浪费。相反，Context Switch 通过选择第一个非空上下文进行传递来工作，而正确设置 Muting 是使前一个节点为空的一种方式，并且在正确配置时不会产生额外工作。

要理解静音，就要理解图的流程

静音，以及使用开关，起初常常让人困惑，因为它感觉上静音一个节点或使用开关应该能够停止或引导图的前向流程。然而，事实并非如此，实际上图是从后往前开始工作的。

如果你有一个路径如 ... > Context > KSampler > VAE Decode > Save Image 的工作流，最初可能会感觉你应该能够静音第一个 Context 节点，然后图在向前移动时会停在那里，跳过该工作流的其余部分。

但你很快会发现这会导致错误，因为图实际上并不向前移动。当工作流被处理时，它首先从每个“输出节点”（如预览图像、保存图像，甚至“显示字符串”等）开始向后移动，然后向后遍历所有可能的路径到达那里。

因此，对于上面那个 ... > Context > KSampler > VAE Decode > Save Image 的例子，我们实际上想要静音 Save Image 节点来停止这条路径。一旦我们这样做，由于输出节点消失了，这些节点都不会被执行。

让我们来看一个例子。

强大的组合：使用 Context、Context Switch 和 Fast Muter

1. 使用 Context Switch（截图中水蓝色部分）按优先级顺序输入上下文。在上述工作流中，Upscale Out 上下文排在第一位，因此如果该上下文已启用，它将被选为输出。如果未启用，则会选择第二个输入槽，该输入槽来自上方（Upscaler 节点之前）重定向的上下文。
   • 请注意，Upscale Preview 位于 Upscale Out 上下文节点之后，使用的是该节点的图像，而不是放大 VAE Decoder 的图像。这是有意为之，这样当我们禁用 Upscale Out 上下文时，所有 Upscaler 节点都不会运行，从而节省宝贵的 GPU 周期。如果我们将预览直接连接到 VAE Decoder，即使 Upscale Out 上下文节点被禁用，放大器也会始终运行以生成预览。
2. 现在，我们可以通过静音来禁用 Upscale Out 上下文节点。选中它并按 ctrl + m 即可。这样做之后，它的输出将为 None，并且不会将任何内容传递给后续节点。在图中，您可以看到 Upscale Preview 是红色的，但这没关系；没有实际错误会阻止执行。
3. 现在，让我们将其连接到 Fast Muter 节点。The Fast Muter 节点通过为任何连接的节点（忽略重定向）添加快速切换开关来充当仪表板。在图中，我们同时连接了 Upscaler Out 上下文节点和 Save File 上下文节点。因此，我们可以快速启用和禁用它们。
   • 这里展示的工作流是一个常见的流程：我们可以用随机种子低成本地生成一批基础预览图，然后选择其中一张进行放大并保存到磁盘。
4. 最后，可选地，你可以看到 Node Collector。如果你想清理“面条”（noodles），可以使用它，并将其连接到静音器（muter）。你可以将任何东西连接到它，但这样做可能会破坏工作流的执行。

⚡ 改进与功能

rgthree-comfy 为 ComfyUI 添加了几项改进、功能和优化，这些并不直接与节点相关。

进度条

一个极简的进度条，沿着应用窗口顶部运行，显示队列大小、当前提示词执行（在同一窗口内）的进度，以及多步骤节点的进度。

你可以从 rgthree-comfy 设置中移除/启用它，并配置其高度/大小。

ComfyUI 递归优化

🎉 最新版本的 ComfyUI 不再存在执行递归性能问题！此功能已从 rgthree-comfy 中移除。

右键菜单中的“队列选中的输出节点”

有时你只想将一两个路径排队到特定的输出节点，而不执行整个工作流。现在，你可以通过右键点击输出节点并选择 Queue Selected Output Nodes (rgthree) 来实现这一点。

• ℹ️ 更多信息选择你想要执行的输出节点。
• 注意：仅捕获并遍历输出节点，而非所有选中的节点。因此，如果你同时选中了一个输出节点和另一条路径上的节点，则只会执行与该输出相连的路径，非输出节点即使被选中也不会执行。
• 注意：整个工作流会被序列化，然后我们会裁剪掉后端不需要的部分。因此，像所有种子随机/递增/递减之类的操作，即使该节点最终未被发送，也会照常运行。

长组合框中的自动嵌套子目录

（默认关闭，处于实验阶段，可在 rgthree-comfy 设置中开启）。

自动检测长组合列表（如“加载检查点”）中的顶级子目录，并将其拆分为子目录。

组标题中的快速静音/旁路切换

（默认关闭，处于实验阶段，可在 rgthree-comfy 设置中开启）。

在组标题的右上角添加静音和/或旁路切换图标，以便一键切换当前正在查看的组。

导入单个节点小部件（拖放）

（默认关闭，处于实验阶段，可在 rgthree-comfy 设置中开启）。

允许拖放先前生成中的图像/JSON 工作流，并覆盖相同节点的小部件（需匹配相同的 ID 和类型）。如果你有多次生成使用相同的一般工作流，并希望仅导入某些数据（如先前生成的种子或提示词等），这将非常有用。

右键菜单中的“复制图像”

右键点击带有图像的节点时，上下文菜单中应出现“复制图像”选项，允许您直接将图像复制到剪贴板。

🎓 我认为此功能已经成熟，ComfyUI 最近也添加了此设置。您不会看到两个菜单项；我的代码会检查是否已存在“复制图像”项，然后再添加。

其他/较小修复

• 修复了双击时超宽节点选择器的宽度问题。
• 修复了文本区域的 z-index，使其不会重叠在其他元素之上，例如属性面板或 @pythongosssss 的图像查看器。
• 默认情况下，加载工作流时检查错误链接并记录到控制台。 （请参阅下面的链接修复器）。

📄 链接修复器

如果您的 工作流 有时缺少连接，甚至在加载时出现错误，请启动 ComfyUI 并前往 http://127.0.0.1:8188/rgthree/link_fixer，该页面允许您拖入图像或 工作流 JSON 文件，并检查及修复任何错误链接。

您还可以在 rgthree-comfy 设置中启用链接修复检查，以便在加载带有错误链接数据的工作流时收到提醒。