展开本页目录
开始前准备什么
- 已有本地 ComfyUI 环境；按所用模型官方说明准备硬件和权重。
- 下载本页材料，检查模型家族、目录与来源；模型权重未打包。
- 保留原文件与实际版本，UI workflow 与 API prompt 分开。
- 先读取工作流的 Loader 类型
- 按职责放置模型
- 核对文件完整性
- 配置共享模型根目录
- 重启后检查 Loader 下拉
- 用材料检查目录而不加载权重
- 形成可维护的模型清单
含 UI/单独 API JSON、原输入、模型清单、校验脚本和真实负例；无权重及本次推理输出。
按官方 0.4 格式整理；仅结构核验，需在你的目标版本实际导入。
从本页工作流 Loader 字段读取；按官方来源准备兼容权重。
空结果栏，供你填写实际输出与故障；不预填虚构成功结果。
1. 先读取工作流的 Loader 类型
导入 workflow.json 后列出 CheckpointLoaderSimple、LoraLoader、VAELoader 等实际类型。models.csv 记录原文件名、家族、源地址和目标目录；不要只看扩展名，因为 safetensors 也有不同职责。
2. 按职责放置模型
完整 checkpoint 放 models/checkpoints，LoRA 放 models/loras，独立 VAE 放 models/vae，ControlNet 放 models/controlnet，超分权重放 models/upscale_models。以对应模型官方安装说明覆盖通用规则。
3. 核对文件完整性
检查文件大小与发布方可用哈希，curl 下载后若是 HTML 错误页或几 KB 小文件不能使用。保留原名和版本；改名只能改变显示名，不能把 SDXL 权重变成 SD1.5。
4. 配置共享模型根目录
需要复用其他磁盘时，从官方 extra_model_paths.yaml.example 创建自己的 YAML，填写实际 base_path 和类别目录。先用一个 checkpoints 路径试验，空格缩进正确，不放 Token 或密码。
5. 重启后检查 Loader 下拉
保存配置并重启 ComfyUI，查看启动日志是否加载你的自定义目录。工作流中的旧值须重新选择实际存在文件；只复制到目录但不确认程序读取，不能算完成。
6. 用材料检查目录而不加载权重
运行 python file_inventory.py 指向自己的模型目录，输出相对路径和字节大小。这个命令只读目录，不读取权重、不下载；本页教材中的目录快照是人工样本，并不是当前机器已装模型。
7. 形成可维护的模型清单
把需要的 Loader、原文件、家族、路径、哈希和许可证登记一起。删除或迁移前查哪些工作流使用它，避免把占空间问题变成新的缺模型故障。
8. 下载工作流、输入和结构检查
完整包包含官方来源 JSON、按本页整理的 UI workflow、单独的 API prompt、真实输入 PNG、模型与参数清单、空验收表、故障负样本和离线脚本。先执行 python check.py，再在自己的 ComfyUI 安装中导入与实际运行。包内权重未下载，结构检查不能替代前端兼容与推理验收。
怎样确认已经完成
- 每个 Loader 需要的文件与目录有明确对应，不混放模型家族。
- extra_model_paths 指向实际存在的目录，启动日志确认被读取。
- 文件清单来自真实目录扫描，未将人工教材当模型安装完成。
常见问题
所有 safetensors 都能放 checkpoints 吗？
不能。检查权重的职责和模型家族，LoRA、VAE、ControlNet 或扩散模型应按官方说明放到对应目录并使用正确 Loader。
能把已有模型目录共享给 ComfyUI 吗？
可以用 extra_model_paths.yaml 配置类别路径，重启后核对下拉与日志；共享路径不会自动解决不同架构或缺编码器。