ComfyPilotComfyPilot
文档 / 自定义节点 / 工作流模板

工作流模板

了解如何使用 example_workflows 目录,为 ComfyUI 自定义节点添加示例工作流 JSON 文件和缩略图,使其显示在 Template Browser 中。

自定义节点 workflow_templates 更新于 2026-10-11

查看官方原文

工作流模板

了解如何使用 example_workflows 目录,为 ComfyUI 自定义节点添加示例工作流 JSON 文件和缩略图,使其显示在 Template Browser 中。

如果你的自定义节点包含示例工作流文件,ComfyUI 可以在模板浏览器(工作流/浏览模板菜单)中向用户展示这些文件。工作流模板是帮助用户快速上手你的节点的好方法。

作为节点开发者,你只需要创建一个 example_workflows 文件夹并在其中放置 json 文件即可。你还可以选择性地放置同名的 jpg 文件作为模板缩略图。

在底层,ComfyUI 会静态提供这些文件,并通过一个端点(/api/workflow_templates)返回工作流模板集合。

[!NOTE] 目前以下文件夹名称也可以被接受,但我们仍旧建议使用example_workflows workflow workflows example examples

示例

在 ComfyUI-MyCustomNodeModule/example_workflows/ 目录下:

  • My_example_workflow_1.json
  • My_example_workflow_1.jpg
  • My_example_workflow_2.json

在这个例子中,ComfyUI 的模板浏览器会显示一个名为 ComfyUI-MyCustomNodeModule 的类别,其中包含两个项目,其中一个带有缩略图。

如需参考实际案例,请查看 ComfyUI-Impact-Pack 的 example\_workflows 文件夹。