子图蓝图

将可复用的节点组打包为 ComfyUI 自定义节点的子图蓝图，用户可以直接从子图菜单添加。

如果你的自定义节点包含可复用的子图组件，ComfyUI 可以将这些作为全局子图蓝图提供给用户。子图蓝图允许用户从子图菜单快速添加预构建的节点组。

作为节点开发者，你只需要在自定义节点目录中创建一个 subgraphs 文件夹并在其中放置 .json 文件即可。

在底层，ComfyUI 会扫描所有自定义节点目录中的子图文件，并通过 /global_subgraphs API 端点提供服务。

示例

在 ComfyUI-MyCustomNodeModule/subgraphs/ 目录下：

• My_upscale_subgraph.json
• My_effects_subgraph.json

在这个例子中，ComfyUI 的子图浏览器会显示来自 ComfyUI-MyCustomNodeModule 的蓝图，用户可以将其添加到工作流中。

创建子图 JSON 文件

子图 JSON 文件使用与工作流 JSON 文件相同的格式。创建子图的最简单方法：

1. 在 ComfyUI 中构建你的子图
2. 选择要包含的节点
3. 将它们转换为子图
4. 将子图导出为 JSON
5. 将 JSON 文件放入 subgraphs/ 文件夹

另请参阅

• 子图（用户指南） - 用户如何与子图交互
• 子图开发者指南 - 子图的前端扩展开发
• 工作流模板 - 为自定义节点添加示例工作流