comfyui文档 里最常被翻的就是这张表——界面下拉框读不到模型,九成是放错了目录。
| 路径 | 放什么 | 备注 |
|---|---|---|
models/checkpoints | 主模型(.safetensors / .ckpt) | 最大,优先放 SSD |
models/loras | LoRA 风格权重 | 按风格分文件夹更易管理 |
models/vae | VAE 编解码器 | 部分模型需外挂 VAE |
models/controlnet | ControlNet 控制模型 | 姿态、线稿、深度图 |
models/clip | 文本编码器 | FLUX / SD3 常用独立 CLIP |
models/upscale_models | 放大模型 | ESRGAN 等 |
custom_nodes | 第三方节点包 | ComfyUI-Manager 安装位置 |
user/default/workflows | 保存的工作流 JSON | 升级前建议备份 |
output | 生成图片与中间产物 | 按日期或项目归档 |
input | 图生图 / 局部重绘的上传素材 | 拖入画布的图片也在此 |
ComfyUI_windows_portable/ComfyUI/ 下面,
源码部署则在仓库根目录。改完文件后回到界面点刷新按钮,或重启服务让下拉列表重建。官方还支持用 extra_model_paths.yaml 把模型库指到别的硬盘,
适合与其他 AI 工具共用一份权重,避免同一个几 GB 的文件存三份。改完配置需重启。
| 节点 | 作用 |
|---|---|
Load Checkpoint | 加载主模型,一次性带出 MODEL / CLIP / VAE 三个输出 |
CLIP Text Encode | 把正向、反向提示词编码成条件向量 |
Empty Latent Image | 设定分辨率与批量张数,生成空潜空间 |
KSampler | 采样核心:步数、CFG、采样器、调度器、种子都在这里 |
VAE Decode | 把潜空间结果解码成像素图像 |
Save Image | 输出到 output 目录,同时可在界面预览 |
Load Image / VAE Encode | 图生图入口,把图片编码回潜空间 |
Load LoRA | 挂接风格权重,可串联多个并分别设强度 |
ControlNetApply | 接入姿态 / 线稿 / 深度等控制条件 |
Upscale Model Loader | 调用放大模型做高清修复 |
理解节点的关键是数据类型的颜色与形状:MODEL、CLIP、VAE、CONDITIONING、LATENT、IMAGE 各有固定接口,只有同类型才能连。比如 CLIP Text Encode 输出的是 CONDITIONING, 接到 KSampler 的 positive / negative 输入;VAE Decode 输出 IMAGE,才能接 Save Image。 连不上时先看接口类型,而不是找参数。
| 名称 | 含义 |
|---|---|
| Workflow JSON | 界面保存格式,含节点位置、连线、参数与界面状态,用于人工编辑 |
| API Format JSON | 接口格式,节点按编号索引,供 /prompt 提交 |
| Prompt / Queue | 一次生成任务;Queue Prompt 把当前流程压入队列 |
| Seed / CFG / Steps | 随机种子、提示词遵循强度、采样步数,都在 KSampler 里 |
| Sampler / Scheduler | 采样器与调度器,决定去噪路径,常见的有 euler、dpmpp_2m 等 |
| Denoise | 图生图重绘幅度,越低越贴近原图,一般 0.4–0.7 |
| Custom Nodes | 社区扩展节点,装在 custom_nodes,缺了会显示红框 |
把流程当接口用是 comfyui 的一大优势:在界面里把参数调好,
用「Save (API Format)」导出 JSON,脚本里 POST 到 /prompt 就能批量出图,
配合 /history、/view 取回结果。注意接口格式与界面格式不通用,
别把 API JSON 拿去菜单里 Open。具体场景链路见工作流页。
社区节点生态是 comfyui 可扩展性的来源。推荐先装 ComfyUI-Manager:
它提供节点列表管理、一键更新、以及导入工作流时最实用的「Install Missing Custom Nodes」——
遇到红色节点时不用再逐个去 GitHub 搜仓库。手动安装则是把仓库 clone 进 custom_nodes,
装好依赖后重启服务。
| 操作 | 位置 / 命令 |
|---|---|
| 安装 Manager | clone 到 custom_nodes/ComfyUI-Manager 后重启 |
| 补齐缺失节点 | Manager → Install Missing Custom Nodes |
| 手动装节点 | git clone <repo> custom_nodes/<name> |
| 装节点依赖 | 用便携版内置的 python 跑该节点的 requirements.txt |
| 禁用某节点 | 把目录改名加 .disabled 后缀后重启 |
完整官方手册在 docs.comfy.org, 源码与 Issue 在 GitHub; 中文速查与常见问题可继续看FAQ和从零教程。