维护与排查

目录组织

ComfyUI/
├── custom_nodes/       # 自定义节点
├── input/              # 输入素材
├── models/
│   ├── checkpoints/
│   ├── controlnet/
│   ├── diffusion_models/
│   ├── loras/
│   ├── text_encoders/
│   ├── upscale_models/
│   └── vae/
├── output/             # 默认输出
└── user/               # 工作流、设置和用户数据

模型可按家族建立子目录，例如 SD 1.5、SDXL、Flux 和 Z-Image，避免将不兼容的 LoRA 或 ControlNet 混用。

更新

• 关闭 ComfyUI 后再执行更新。
• 先保存当前可运行的工作流和环境状态。
• ComfyUI 核心与自定义节点分开更新。
• 更新后先运行最小工作流，再验证复杂项目。
• 不在重要项目交付前集中更新全部组件。

Portable 版本应使用随安装包提供的更新脚本；其他安装方式按照对应安装文档更新。

自定义节点

ComfyUI-Manager 可以：

• 搜索、安装、更新和禁用自定义节点。
• 检测共享工作流中的缺失节点。
• 保存或恢复环境快照。

自定义节点会执行本地代码，只应从可信项目安装。安装或更新后通常需要重启 ComfyUI。

工作流无法加载

1. 查看是否出现红色缺失节点。
2. 使用 Manager 检测缺失的自定义节点。
3. 检查 ComfyUI 核心版本是否满足工作流要求。
4. 检查工作流引用的模型和文件路径。
5. 查看启动日志中是否有节点导入失败。

模型未显示

1. 确认文件位于正确的 models 子目录。
2. 确认使用了匹配的加载节点。
3. 按 R 刷新节点定义。
4. 重启 ComfyUI。
5. 检查文件是否下载完整。

显存不足

按影响范围逐步调整：

1. 降低批量大小。
2. 降低宽高。
3. 移除暂时不需要的 ControlNet 或放大步骤。
4. 关闭占用 GPU 的其他程序。
5. 使用模型提供的 FP8 或 GGUF 版本。
6. 将高负载步骤改为 API 或云端执行。

输出异常

现象	优先检查
图片为空或未保存	KSampler、VAE Decode、Save Image 的连线
色彩异常	VAE 是否与模型匹配
不遵循提示词	提示词编码、CFG、模型提示方式
图生图变化过大	denoise 是否过高
LoRA 无效	模型家族、触发词和加载连线
ControlNet 无效	预处理器、模型兼容和 Conditioning 连线

复现问题

确认以下内容完全一致：

• 模型、VAE 和 LoRA 文件。
• 自定义节点及版本。
• 正向和负向提示词。
• seed、步数、CFG、采样器和调度器。
• 分辨率、批量和输入素材。

ComfyUI 图片元数据和 JSON 工作流可以保存节点图，但外部模型与节点仍需单独记录。

获取帮助

提供问题信息时应包括：

• 完整错误信息和日志。
• ComfyUI 与自定义节点版本。
• GPU、显存和操作系统。
• 可复现的最小工作流。
• 涉及的模型文件名和目录。
• 已尝试的排查步骤。