模型下载

模型下载不是只选择一个 .safetensors 文件，还需要同时确认模型类型、基础模型、组织形式、精度和硬件需求。

下载前确认

项目	需要确认的内容
模型类型	Checkpoint、LoRA、ControlNet、VAE、文本编码器或扩散模型
基础模型	SD 1.5、SDXL、Flux、Z-Image 等
组织形式	AIO Checkpoint 或拆分组件
文件版本	FP32、FP16、BF16、FP8 或 GGUF
使用条件	许可证、地区限制、登录或条款确认
硬件需求	文件大小、显存、内存和推荐分辨率

文件扩展名不能说明模型的实际用途。相同的 .safetensors 可能是 Checkpoint、LoRA、ControlNet 或文本编码器，应以发布页标注和配套工作流为准。

Hugging Face

Hugging Face Models 同时包含图像、视频、音频和语言模型，并非所有仓库都能直接用于 ComfyUI。

查找时可先使用 Text-to-Image 任务筛选，再检查：

• 模型卡中的架构、许可证、限制和推荐用法。
• Files and versions 中的目录结构、具体文件名和文件大小。
• 仓库是否要求登录并接受许可证。
• 发布者是否提供 ComfyUI 工作流或明确的加载节点。
• AIO 文件与 text encoder、diffusion model、VAE 等拆分文件的区别。

仓库中的子目录通常能提示文件用途，但最终仍应以模型卡和工作流说明为准。

Civitai

Civitai Models 更侧重 Stable Diffusion 生态，通常会直接展示模型类型、基础模型、版本和生成图片。

筛选模型时重点使用：

• Model type：Checkpoint、LoRA、ControlNet 等。
• Base model：SD 1.5、SDXL、Flux 等兼容范围。
• 模型版本：同一模型名称可能同时提供多个基础模型版本。
• 发布时间、推荐参数、触发词和图片生成信息。

Juggernaut 等模型的页面可能出现 Checkpoint、Checkpoint Merge 等类型。Checkpoint Merge 表示由同一基础模型家族的多个模型合并而成，不代表可以跨架构使用。

Civitai 的可访问性和可见内容可能受地区或账户设置影响。

文件存放位置

模型类型	默认目录
Checkpoint / AIO	ComfyUI/models/checkpoints/
LoRA	ComfyUI/models/loras/
ControlNet	ComfyUI/models/controlnet/
Diffusion model	ComfyUI/models/diffusion_models/
Text encoder	ComfyUI/models/text_encoders/
VAE	ComfyUI/models/vae/
Model patch	ComfyUI/models/model_patches/
Upscale model	ComfyUI/models/upscale_models/

可以在类型目录下继续建立模型家族子目录。例如 Z-Image Turbo AIO 可放入：

ComfyUI/models/checkpoints/Z image/

下载完成后按 R 刷新节点定义和模型列表；仍未出现时重启 ComfyUI，并检查文件是否下载完整、目录是否正确。

文件名

模型文件名通常同时描述模型家族、精度、量化方式和发布者。例如：

z-image-turbo / FP8 / scaled / E5M2 / KJ / .safetensors

• Z-Image Turbo：模型家族和变体。
• FP8：权重精度。
• scaled：经过缩放校准的 FP8 版本。
• E5M2：FP8 编码变体。
• KJ：导出者或构建版本标识。
• .safetensors：文件容器格式。

这些名称不是统一标准。下载前仍需阅读发布页，不能只依靠文件名推断加载方式。

兼容性

• Checkpoint、LoRA 和 ControlNet 应属于兼容的基础模型家族。
• SD 1.5、SDXL、Flux 和 Z-Image 的组件不能仅因接口名称相似而互换。
• 模型发布页的推荐采样器、步数、分辨率和提示词写法通常与训练方式有关。
• 首次使用时保留原始文件名和版本号，便于排查缺失模型和复现工作流。
• 下载前核对许可证，尤其是在公开发布图片或商业使用时。