子图功能 - ComfyUI 中的工作流组织工具

讲解 ComfyUI 中子图（Subgraph）功能的使用方法，包括创建、导航和管理子图

[!NOTE] 子图功能需要 ComfyUI 前端版本 1.24.3 或更高版本。如果你没有看到此功能，请参考：如何更新 ComfyUI * 本文中的图像使用每夜版本前端制作，请以实际界面为准

[!TIP] 有关以编程方式使用子图的开发者文档，请参阅子图开发者指南。

ComfyUI Selection Toolbox New Features

子图是 ComfyUI 的一项强大功能，它允许你将复杂的工作流打包成一个可复用的子图节点，从而更易于管理和共享。

你可以把子图理解为工作流的一个“文件夹”：将相关的节点分组在一起，并把整个集合当作一个统一的子图节点来使用。

使用子图可以：

• 简化复杂的工作流
• 复用常见的节点组合
• 借助模块化组件构建更高效的工作流

如何创建子图？

1. 选中任意节点

在 ComfyUI 中选中任意节点

2. 点击选择工具项中的子图对应功能的图标

3. 完成子图创建

ComfyUI 会根据选中节点的输入输出，自动创建一个子图，并将其添加到画布中。

4. 编辑子图

经过编辑和整理，你可以将子图调整成一个具备完善功能的节点。

编辑子图

1. 子图有和普通节点一样的编辑功能

你可以像一般节点一样使用子图：

1. 修改外观节点颜色
2. 修改节点名称
3. 使用绕过（Bypass）来禁用
4. 等等

2. 子图的编辑

• 在子图非组件（widget） 空白处双击以进入子图编辑状态，
• 点击子图编辑按钮

下面为进入子图的编辑状态

1. 子图导航，你可以通过这里退出当前子图，并返回上级
2. 输入插槽（slot）: 会显示在子图外部的内部节点输入
3. 你可以像链接正常节点一样将输出连接到插槽中
4. 通过在连接点上点击鼠标右键，你可以重命名/删除 暴露在子图外部的插槽
5. 输出插槽（slot）: 暴露在子图外部的输出,和输入插槽功能类似

1. 图中数字为 1 的插槽为默认插槽： 用于新增 输出 / 输出 连接以暴露给上级的子图视图
2. 在已有插槽上点击鼠标右键，可以重命名、删除、取消已原有的节点的连接

插槽连接同样遵循数据类型验证

3. 子图的嵌套

在子图中你可以进一步嵌套的子图，来创建更复杂的工作流

同时在编辑嵌套的子图时也提供了多级的导航来方便你返回到上一级

4. 参数面板

从 ComfyUI v0.3.66 版本开始，你可以直接在新增的参数面板中编辑子图参数，无需进入子图内部进行编辑。

你可以选中任何子图，点击"编辑子图控件（Edit Subgraph Widgets）"按钮来打开参数面板。

打开后，可以直接在参数面板中调整子图控件的顺序和可见性。

1. 调整顺序：按住右键拖动控件，即可更改其排列位置
2. 控件可见性：点击眼睛图标可以设置控件是否显示

5. 退出子图

要退出子图并返回上一级：

• 使用画布顶部的导航栏(图中标记为 1)，或
• 按 Esc 键

点击导航栏或按 Esc 键即可退出当前子图，返回到父级工作流。

将子图转回普通节点

当子图编辑完成后，你可以将子图转回为普通节点，只需要选中子图后，再在选择工具箱上选择同样的按钮即可完成子图转回节点的操作，在右键菜单上也有对应的选项

发布子图

从 ComfyUI 前端版本 1.27.7 开始，你可以将子图发布到节点库中。

此功能允许你将子图转换为 子图蓝图(Blueprint)，也就是可复用的子图节点。

发布子图到节点库

目前有两种方式可以将子图发布到节点库，这两种方式都在选择工具箱中：

1. 点击选择工具箱上的 书本（发布） 图标
2. 打开选择工具箱菜单，选择 添加子图到库(Add Subgraph to Library) 菜单项来发布子图

点击 书本（发布） 图标或 添加子图到库(Add Subgraph to Library) 菜单后，你会看到如下对话框：

默认情况下，子图蓝图会使用子图节点的名称作为子图蓝图的名称，你可以在这一步进行修改

发布后，你将在节点库中看到子图蓝图节点。

现在，你可以像普通节点一样拖拽或搜索该子图。通过子图蓝图添加的新子图节点是相互独立的，也就是说，添加到工作流后可以单独编辑并不相互影响

编辑子图蓝图

如果你想编辑子图蓝图，可以点击下图所示的编辑按钮，也可以删除它。

这将进入子图编辑模式

编辑完子图蓝图后，你可以返回上一级预览子图。

如果你想保存更新后的子图蓝图，可以点击保存按钮， 或者使用 Ctrl + S 进行保存, 即可更新子图