ComfyUI项目：解决模型检查点文件夹缺失问题

在ComfyUI项目使用过程中，部分用户可能会遇到"Checkpoints Folder not found"的错误提示。这个问题的核心在于模型文件缺失或路径配置不正确，导致系统无法加载必要的模型资源。

问题本质分析

检查点(Checkpoints)是深度学习模型训练过程中保存的中间状态文件，包含了模型权重和优化器状态等重要信息。在ComfyUI这类基于Stable Diffusion的UI框架中，检查点文件是系统运行的基础依赖。

典型解决方案

1. 模型文件下载与放置 用户需要获取正确的模型文件（如v1-5-pruned-emaonly-fp16.safetensors），并将其放置在ComfyUI目录下的特定路径中：

   ComfyUI/models/checkpoints/
   

2. 系统刷新操作 放置文件后，用户需要执行刷新操作。在ComfyUI界面中，可以通过快捷键"R"来刷新节点定义，使系统重新加载模型资源。

技术细节说明

• 模型文件格式：现代Stable Diffusion模型通常采用.safetensors格式，这是一种更安全的权重存储格式，相比传统的.pth或.ckpt文件，它提供了更好的安全性和加载效率。

• 目录结构规范：ComfyUI遵循特定的目录结构约定，模型文件必须放置在预定义的checkpoints目录下才能被正确识别。这种设计有助于保持项目结构的清晰性和可维护性。

预防性建议

1. 项目初始化检查：首次使用ComfyUI时，建议先确认models/checkpoints目录是否存在，若不存在可手动创建。

2. 版本兼容性：确保下载的模型版本与当前使用的ComfyUI版本兼容，避免因版本不匹配导致加载失败。

3. 权限设置：检查系统是否有足够的权限访问模型文件，特别是在Linux/macOS系统中需要注意文件权限设置。

扩展知识

对于更复杂的部署场景，ComfyUI还支持通过配置文件指定自定义模型路径。高级用户可以通过修改配置文件来灵活管理多个模型资源，实现多版本模型的快速切换。

理解并正确处理模型文件的管理问题，是使用ComfyUI这类AI工具的基础技能。掌握这些知识不仅能解决当前问题，也为后续更复杂的项目部署打下良好基础。