# ComfyUI模型放哪里

把不同类型模型放入正确目录，建立文件清单与 extra_model_paths 配置，避免重命名掩盖架构差异。

本地结构与素材核验，未执行 ComfyUI 前端导入或扩散/ESRGAN 推理。图像与原 JSON 来源见 provenance.json。所有工作流为 UI 格式 0.4，与 prompt-api.json 分开。权重不打包。

## 使用

1. python check.py
2. 查看 models.csv，按模型出处准备文件。
3. 用本地 ComfyUI 打开 workflow.json，重新选择 Loader 下拉和输入。
4. 自己完成真实小样，填写 acceptance.csv。

## 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、原文件、家族、路径、哈希和许可证登记一起。删除或迁移前查哪些工作流使用它，避免把占空间问题变成新的缺模型故障。


queue_client.py 默认只查询；--submit 明确触发本地真实推理。batch_manifest.py 仅生成计划，未提交。故障日志、history 响应和空验收栏是教材，不是本站成功实测。

## 官方来源

- https://docs.comfy.org/tutorials/basic/text-to-image
- https://github.com/Comfy-Org/ComfyUI
- https://docs.comfy.org/troubleshooting/model-issues
- https://www.douyin.com/video/7691594447310244330