ComfyUI 设置 — 本地 AI 生成
机器
- Windows 10 Pro,RTX 3090 24 GB(安培架构),28 GB 内存(→40 GB),Xeon E5-2696 v4
- 驱动器:C:(系统盘,35 GB 剩余),D: SSD 207 GB,E: HDD 9.3 TB
- ComfyUI 0.44.0 便携版(CUDA 13,Python 3.13)位于
D:\AI\ComfyUI
- 服务器:
http://127.0.0.1:8188
文件夹结构
D:\AI\ComfyUI — 应用程序 + python_embeded
D:\AI\models\ — 所有模型(通过 extra_model_paths.yaml 配置)
D:\AI\workflows\ — 2d/、3d/、video/ 工作流 JSON 文件
D:\AI\outputs\staging\<project>\ — 按项目临时输出
D:\AI\cache\ — HF/Torch 下载缓存(HF_HOME、TORCH_HOME)
D:\AI\README.txt、SETUP_DOCUMENTATION.md、HANDOFF.md、PROJECTS.md
模型文件夹
| 类型 | 文件夹 | 加载器 |
|---|
| SDXL checkpoint | D:\AI\models\checkpoints\ | CheckpointLoaderSimple |
| 扩散模型 (UNET) | D:\AI\models\diffusion_models\ | UNETLoader |
| 文本编码器 | D:\AI\models\text_encoders\ | CLIPLoader |
| VAE | D:\AI\models\vae\ | VAELoader |
| ControlNet/补丁 | D:\AI\models\model_patches\ | ModelPatchLoader |
| LoRA | D:\AI\models\loras\ | LoraLoader |
| CLIP vision | D:\AI\models\clip_vision\ | CLIPVisionLoader |
| 放大模型 | D:\AI\models\upscale_models\ | UpscaleModelLoader |
| 背景去除 | D:\AI\models\background_removal\ | LoadBackgroundRemovalModel |
| 3D | D:\AI\models\diffusion_models\ + vae\ | 原生 3D 节点 |
关键规则
- 必须同时更新
widgets_values 和 widgets_values_named:在工作流中更改模型名称时。ComfyUI 0.44.0 使用 widgets_values_named 作为实际值。
- 添加模型后重启 ComfyUI(模型列表在启动时缓存)。
- 浏览器缓存: 如果出现“缺少模型”提示,请刷新页面 (F5) 并重新打开工作流。
- 需要 int8/FP8 构建以适应 28 GB 内存。BF16 需要 40 GB。
- H3 需要:
--disable-pinned-memory --fp16-intermediates 标志。
- 不要混合模型类型。 Z-Image 使用 UNET/CLIP/VAE(单独)。SDXL checkpoints 使用 CheckpointLoaderSimple。
- extra_model_paths.yaml 使用正斜杠:
D:/AI/models/。
- HF/Torch 缓存必须位于 D 盘(在启动 bat 中设置)。
- MarkdownNote 节点可以在文本中引用模型名称;清理它们以避免虚假的“缺少模型”警告。
安装新模型
- 使用 curl 下载到
D:\AI\downloads\。
- 移动到
D:\AI\models\ 下的正确文件夹。
- 验证 safetensors 头部:
D:\AI\ComfyUI\python_embeded\python.exe -c "import struct,json,sys; sys.stdout.reconfigure(encoding='utf-8'); f=open(r'<path>','rb'); n=struct.unpack('<Q',f.read(8))[0]; h=json.loads(f.read(n)); print('OK', len(h), 'tensors')"
- 重启 ComfyUI。
- 通过
http://127.0.0.1:8188/object_info/<LoaderNode> 验证加载器能看到该模型。
- 基于现有模板创建工作流,同时更新
widgets_values 和 widgets_values_named。
- 通过 API 测试(参见
test_zimage.py 模式)。
- 更新 README 和文档。
启动命令
:: 正常模式(图像、3D、通用)
D:\AI\ComfyUI\run_nvidia_gpu.bat
:: --enable-manager
:: 视频模式(MiniMax H3)
D:\AI\ComfyUI\run_nvidia_gpu_video.bat
:: --enable-manager --disable-pinned-memory --fp16-intermediates
关键模型和设置
| 模型 | 文件 | 设置 |
|---|
| Z-Image Turbo | int8 UNET + FP8 编码器 + ae.safetensors | 8-9 步,CFG 1.0,res_multistep,simple,1024-1344px |
| Nova Anime XL v19 | NovaAnimeILV190.safetensors (SDXL) | 28 步,CFG 5,euler_ancestral,normal,CLIP skip 2 |
| Prefect Pony XL v6 | PrefectPonyXLV6.safetensors (Pony/SDXL) | 28 步,CFG 6,euler_ancestral,normal,CLIP skip 2 |
| Pixal3D/TRELLIS.2 | int8 UNETs + VAEs + DINOv3 + BiRefNet + MoGe | 1024px,布尔值:off=Pixal3D,on=TRELLIS.2 |
| MiniMax H3 | 精简 int8 + NVFP4 编码器 + 视频/音频 VAE | 5s 864x480,4 步 turbo LoRA;15s 1344x768 ~23 分钟 |
常见问题
| 问题 | 修复 |
|---|
hostbuf_file_reader_read failed | --disable-dynamic-vram 或使用 int8/FP8 构建 |
Fault failed: 2 (H3) | --disable-pinned-memory --fp16-intermediates + 降低分辨率 |
| 屏幕变黑 (TDR) | 降低分辨率/步数;在注册表中增加 TDR 延迟 |
| “缺少模型”对话框 | 修复两个 widgets 字段;重启 ComfyUI;重新加载页面 |
| 模型不在下拉列表中 | 重启 ComfyUI(模型列表在启动时缓存) |
| H3 I2V 失败 | FL2VA 未安装;使用安全的 R2V 工作流 |
文档文件
D:\AI\README.txt — 用户快速参考
D:\AI\SETUP_DOCUMENTATION.md — 完整 13 节参考
D:\AI\HANDOFF.md — 智能体快速参考(安装程序)
D:\AI\PROJECTS.md — 项目跟踪器
D:\AI\projects\<slug>\README.md — 项目文档
未安装(可按需提供)
SDXL base、FLUX、像素艺术 LoRA、SDXL ControlNet、H3 FL2VA、放大模型 (ESRGAN/SeedVR2)、纹理 LoRA、Kohya 训练工具、Krita AI Diffusion、Aseprite/Pixelorama。