> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 工作流模板 - ComfyUI 内置工作流模板

> 浏览 ComfyUI 工作流模板：原生支持的模型工作流与自定义节点示例工作流，以及打开、加载模板和下载所需模型的方法。

工作流模板是 ComfyUI 中原生支持的模型工作流及自定义节点提供的模型工作流的浏览窗口。

在 ComfyUI 的工作流模板功能中，你可以找到以下内容：

* 原生支持的模型工作流
* 自定义节点提供的示例工作流

![Template](https://mintcdn.com/dripart/EeFKEryMLH5667kk/images/interface/features/template/template_library.png?fit=max\&auto=format\&n=EeFKEryMLH5667kk\&q=85\&s=666049389fbe24cda29d1231ae6e4510)

## 如何打开 ComfyUI 的模板

在侧边栏点击 **Templates** 图标即可打开工作流模板。你也可以通过菜单 **工作流** → **浏览工作流模板** 打开。

![Template](https://mintcdn.com/dripart/7m9lukFrTCZs7Mhj/images/interface/features/template/template.png?fit=max\&auto=format\&n=7m9lukFrTCZs7Mhj\&q=85\&s=36d5b46c782c6235ec56bfba9d1ff346)

## 如何使用模板

1. 加载模板： 点击你需要使用的任意模板以加载对应的模板工作流
2. 下载模型： 在加载模板时，ComfyUI 会自动检查模型文件是否存在，如果模型文件不完整，则会提示你下载模型
3. 使用工作流： 确定工作流的需要的各种要素如模型、输入图片、提示词等是完整的，即可点击运行按钮开始使用工作流

### 模型保存位置

每个工作流模板都嵌入了所需模型的链接。首次使用时如果本地没有这些文件，ComfyUI **不会**再弹一个单独的「Missing Models」旧对话框，而是：

1. 在画布上把相关加载节点标红。
2. 显示类似 **N errors found** 的提示，并提供 **View details**。
3. 在 [右侧面板](https://docs.comfy.org/zh/interface/right-side-panel.md) 的 **错误** 标签页里展开 **Setup required**（设置待完成）下的 **Missing Models**（缺失模型）列表。

![模板缺少的模型：Setup required 列出每个文件的文件夹与大小，每行 Download，底部 Download all](https://mintcdn.com/dripart/cWths51SAUr51YVL/images/interface/features/template/missing_models.jpg?fit=max\&auto=format\&n=cWths51SAUr51YVL\&q=85\&s=f10eb949eacf08ae5b6c08307df3c8b0)

在这个列表里可以按文件 **Download**、**Download all**、**Refresh**，或用定位按钮跳到需要该模型的节点。工作过程中，右侧面板错误页里的 **Missing models** 分组会一直可用。

1. **桌面版**：点 **Download** / **Download all** 会写入对应的 `ComfyUI/models/…` 目录。
2. **自托管浏览器版**：同样操作在有 URL 时走浏览器下载。请把文件放到对应文件夹。截图中的 Qwen Image 模板示例：

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 loras/
│   │   └── Qwen-Image-Lightning-8steps-V1.0.safetensors
│   ├── 📂 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`）。
如果模型已经放在子目录（如 `ComfyUI/models/diffusion_models/wan_video`），可以关掉提示，在加载节点里手动选中该文件即可。

如果你好奇我们是如何做到嵌入模型链接的，我们在对应节点的 `properties` 中添加了 `models` 信息， 下面是嵌入了模型信息的 `DualCLIPLoader` 节点的完整片段：

```json theme={null}
    {
      "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` 信息。

* `name` 对应了模型文件的名称
* `url` 对应了模型文件的下载链接(可直接下载的文件链接，而不是仓库地址)
* `directory` 对应了模型文件的下载后应存储到的 ComfyUI/models 目录下的哪个子目录， 如 `vae` 则对应 `ComfyUI/models/vae` 目录

目前模型链接仅支持 huggingface 和 civitai 来源的链接，并且要求模型格式为安全的模型格式如 `.safetensors`, `.sft` 格式等，类似  `.gguf`, 不安全格式在嵌入后会提示不安全并不显示链接

你可以使用[这个工具](https://comfyui-wiki.github.io/ComfyUI-Workflow-JSON-Editor/)来编辑工作流模板中的模型信息，但目前 [@ComfyUI-Wiki](https://github.com/ComfyUI-Wiki) 仅对原生的节点增加了支持。

## 如何更新模板？

目前模板是通过一个单独依赖的形式进行管理和更新的，对应的地址为：[comfyui-workflow-templates](https://pypi.org/project/comfyui-workflow-templates/)

如果你在更新 ComfyUI 后发现没有文档或者我们的更新说明中新增的模板，那么可能是你没有在更新 ComfyUI 之后更新对应的依赖, 你可以访问 [ComfyUI/requirements.txt](https://github.com/Comfy-Org/ComfyUI/blob/master/requirements.txt) 来查看对应的依赖版本

通常下面的三个依赖是每次更新 ComfyUI 时我们也可能会同时升级的

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

如果你不了解如何正确更新，请参考 [更新 ComfyUI](https://docs.comfy.org/zh/installation/update_comfyui.md) 章节了解如何更新 ComfyUI 和对应的依赖

## 如何向 ComfyUI 官方贡献模板？

目前所有的模板都托管在 [workflow\_templates](https://github.com/Comfy-Org/workflow_templates/) 仓库中，你可以通过提交 PR 的方式来贡献模板，对于官方模板我们要求如下：

1. 不使用任何的第三方节点（避免用户因为缺失节点导致需要额外的安装）
2. 对应的模板不与已有模板重复， 需要是已支持的相关模型功能
3. 你可以在对应的仓库提交 issue 进行提问

## 自定义节点模板

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

如果你是自定义节点作者，请注意目前我们仅支持模板文件夹下的一级目录，并不支持多级目录，且仅支持 JSON 格式的模板

## 如何为自定义节点添加模板？

[自定义节点模板](https://docs.comfy.org/zh/custom-nodes/workflow_templates.md) 中介绍了如何为你开发的自定义节点添加工作流模板，你也可以向自定义节点作者提交 PR 来贡献自定义节点模板


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.