ComfyUI-BrushNet模型路径配置指南

ComfyUI-BrushNet作为一款强大的图像修复工具，其模型文件的正确存放位置对于功能实现至关重要。本文将详细介绍如何合理配置BrushNet模型路径，帮助用户避免常见的加载问题。

模型存放位置解析

ComfyUI-BrushNet默认会从models/inpaint目录及其子目录中查找模型文件。虽然项目支持自定义路径配置，但经过实践验证，最可靠的存放位置是ComfyUI主目录下的models/inpaint文件夹。

标准路径结构

推荐的标准存放路径为：

ComfyUI根目录/
└── models/
    └── inpaint/
        ├── diffusion_pytorch_model.safetensors
        ├── config.json
        ├── model_index.json
        ├── scheduler/
        └── unet/

模型文件命名规范

BrushNet加载器对模型文件名没有严格要求，但必须满足以下条件：

1. 文件扩展名必须是.safetensors
2. 文件名可以自由定义，不需要特定格式
3. 系统会自动识别目录下所有符合条件的文件

文件大小验证

为确保模型完整性，用户应检查下载文件的大小：

• BrushNet SD15模型：约2.47GB (2,475,354,520字节)
• BrushNet SDXL模型：约1.49GB (1,493,356,392字节)

自定义路径配置说明

虽然支持通过extra_model_paths.yaml文件配置自定义路径，但实际使用中发现可能存在兼容性问题。建议优先使用标准路径，若必须使用自定义路径，需注意：

1. 确保路径配置准确无误
2. 检查文件权限设置
3. 确认路径中不包含特殊字符
4. 路径层级不宜过深

最佳实践建议

1. 优先使用ComfyUI默认的models/inpaint目录
2. 保持原始文件名不变，避免修改
3. 将模型相关文件（包括配置文件）统一存放在同一目录下
4. 定期检查模型文件完整性
5. 不同版本的模型建议存放在不同子目录中

通过遵循以上指南，用户可以确保BrushNet模型能够被正确加载和使用，充分发挥其图像修复的强大功能。