Skip to content
ComfyUI Wiki
帮助构建更好的 ComfyUI 知识库 成为赞助者

ComfyUI 工作流模板功能详解

工作流模板是 ComfyUI 中一个非常实用的功能,它为你提供了一个便捷的方式来浏览和使用各种预设的工作流。这些模板涵盖了官方支持的模型工作流以及社区开发者提供的示例工作流。

在 ComfyUI 的模板系统中,你可以发现:

  • 官方内置的模型工作流模板
  • 第三方自定义节点提供的示例工作流

Template

如何访问模板功能

要打开工作流模板,只需要在菜单栏中点击 工作流 —> 浏览工作流模板 即可进入模板浏览界面。 Template

模板使用指南

基本操作步骤

  1. 选择模板:在模板列表中点击你想要使用的任意模板,系统会自动加载对应的工作流
  2. 模型检查:加载模板时,ComfyUI 会自动检查所需的模型文件是否已安装
  3. 下载缺失模型:如果发现缺少必要的模型文件,系统会提示你进行下载
  4. 运行工作流:确保所有要素(模型、输入图片、提示词等)都已准备就绪后,点击运行按钮即可开始使用

模型文件管理

每个工作流模板都包含了相应的模型信息,首次使用时如果检测到缺少模型文件,系统会显示下载提示。

Missing Models

下载方式说明:

  • 桌面版用户:点击下载按钮后,程序会自动完成模型文件的下载和安装
  • 其他版本用户:通过浏览器下载模型文件,然后手动将文件放置到正确的目录中

模型存放位置:

以截图中的模型为例,需要将文件保存到以下位置:

📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── qwen_image_fp8_e4m3fn.safetensors
│   ├── 📂 vae/
│   │   └── qwen_image_vae.safetensors
│   └── 📂 text_encoders/
│       └── qwen_2.5_vl_7b_fp8_scaled.safetensors

重要提示: 当前版本的模板系统只能检测模型文件是否存在于对应的一级目录中。如果你已经将模型文件存放在子文件夹中(如 ComfyUI/models/diffusion_models/wan_video),可以忽略下载提示,只需在相应的模型加载节点中确保选择了正确的模型文件即可。

模板技术实现原理

模型信息嵌入机制

模板系统通过在节点的 properties 中添加 models 信息来实现模型链接的嵌入。以下是一个包含模型信息的 DualCLIPLoader 节点示例:

    {
      "id": 40,
      "type": "DualCLIPLoader",
      "pos": [
        -320,
        290
      ],
      "size": [
        270,
        130
      ],
      "flags": {},
      "order": 0,
      "mode": 0,
      "inputs": [],
      "outputs": [
        {
          "name": "CLIP",
          "type": "CLIP",
          "links": [
            64
          ]
        }
      ],
      "properties": {
        "Node name for S&R": "DualCLIPLoader",
        "cnr_id": "comfy-core",
        "ver": "0.3.40",
        "models": [
          {
            "name": "clip_l.safetensors",
            "url": "https://huggingface.co/comfyanonymous/flux_text_encoders/resolve/main/clip_l.safetensors",
            "directory": "text_encoders"
          },
          {
            "name": "t5xxl_fp16.safetensors",
            "url": "https://huggingface.co/comfyanonymous/flux_text_encoders/resolve/main/t5xxl_fp16.safetensors",
            "directory": "text_encoders"
          }
        ]
      },
      "widgets_values": [
        "clip_l.safetensors",
        "t5xxl_fp16.safetensors",
        "flux",
        "default"
      ]
    }

模型信息结构说明

properties 中新增的 models 字段包含以下信息:

  • name:模型文件的名称
  • url:模型文件的直接下载链接(必须是可直接下载的文件链接,而非仓库地址)
  • directory:模型文件在 ComfyUI/models 目录下的存储位置

支持的模型来源: 目前系统支持来自 Hugging Face 和 CivitAI 的模型链接,且要求模型格式为安全格式(如 .safetensors.sft 等)。不安全的格式(如 .gguf)在嵌入后会显示为不安全状态且不会显示下载链接。

编辑工具: 你可以使用这个工具来编辑工作流模板中的模型信息,但目前 @ComfyUI-Wiki 仅对原生节点提供了支持。

模板更新机制

依赖管理

模板系统通过独立的依赖包进行管理和更新,对应的包名为:comfyui-workflow-templates

如果你在更新 ComfyUI 后发现缺少新文档或更新说明中提到的模板,可能是因为没有同步更新相关依赖。你可以查看 ComfyUI/requirements.txt 来了解当前的依赖版本。

核心依赖包: 以下三个依赖通常在每次 ComfyUI 更新时也会同时升级:

comfyui-frontend-package==1.24.4
comfyui-workflow-templates==0.1.52
comfyui-embedded-docs==0.2.4

如果你不确定如何正确更新,请参考 更新 ComfyUI 章节了解详细的更新步骤。

社区贡献指南

官方模板贡献

所有官方模板都托管在 workflow_templates 仓库中,你可以通过提交 Pull Request 的方式来贡献模板。

官方模板要求:

  1. 纯原生支持:不使用任何第三方节点,避免用户因缺少节点而需要额外安装
  2. 避免重复:确保模板不与现有模板重复,且必须是已支持的相关模型功能
  3. 问题反馈:如有疑问,可以在对应仓库提交 issue 进行讨论

自定义节点模板

如果自定义节点开发者提供了模板和示例工作流,你也可以在模板浏览中找到它们。通常只需要找到对应节点名称的分类即可查看开发者提供的所有模板。

开发者注意事项: 目前系统仅支持模板文件夹下的一级目录结构,不支持多级目录,且仅支持 JSON 格式的模板文件。

自定义节点模板开发

如果你想要为自定义节点添加模板支持,可以参考 自定义节点模板 章节了解详细的开发流程。你也可以向自定义节点开发者提交 Pull Request 来贡献模板内容。