Community图像github.com

ComfyUI 设置

在配备 RTX 3090 的 Windows 系统上进行本地 ComfyUI 安装、模型管理、工作流搭建和故障排除,适用于 AI 图像/视频/3D 生成。

ComfyUI 设置 是什么?

ComfyUI Setup 技能为 AI 生成开发者提供了在 Windows 10 Pro 和 RTX 3090 24GB 显存环境下搭建和维护 ComfyUI 的完整指南。该技能详细说明了从便携版 0.44.0 的安装、模型文件夹结构(包括 checkpoint、UNET、VAE、LoRA 等)到关键模型配置(如 Z-Image Turbo、MiniMax H3 视频生成)的每一步。它强调了更新工作流时必须同时修改 `widgets_values` 和 `widgets_values_named` 两个字段,以及安装新模型后需重启 ComfyUI 并清除浏览器缓存等核心规则。此外,技能还提供了常见错误(如显存不足、黑屏)的解决方案和启动参数(如 `--disable-pinned-memory`),并支持多个工作流目录(2D/3D/视频)和项目管理文档,适合希望高效利用 RTX 3090 进行本地 AI 图像、视频和 3D 内容创作的开发者和高级用户。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/konqiDAM/void-skills/tree/main/comfyui-setup

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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 checkpointD:\AI\models\checkpoints\CheckpointLoaderSimple
扩散模型 (UNET)D:\AI\models\diffusion_models\UNETLoader
文本编码器D:\AI\models\text_encoders\CLIPLoader
VAED:\AI\models\vae\VAELoader
ControlNet/补丁D:\AI\models\model_patches\ModelPatchLoader
LoRAD:\AI\models\loras\LoraLoader
CLIP visionD:\AI\models\clip_vision\CLIPVisionLoader
放大模型D:\AI\models\upscale_models\UpscaleModelLoader
背景去除D:\AI\models\background_removal\LoadBackgroundRemovalModel
3DD:\AI\models\diffusion_models\ + vae\原生 3D 节点

关键规则

  1. 必须同时更新 widgets_values 和 widgets_values_named:在工作流中更改模型名称时。ComfyUI 0.44.0 使用 widgets_values_named 作为实际值。
  2. 添加模型后重启 ComfyUI(模型列表在启动时缓存)。
  3. 浏览器缓存: 如果出现“缺少模型”提示,请刷新页面 (F5) 并重新打开工作流。
  4. 需要 int8/FP8 构建以适应 28 GB 内存。BF16 需要 40 GB。
  5. H3 需要: --disable-pinned-memory --fp16-intermediates 标志。
  6. 不要混合模型类型。 Z-Image 使用 UNET/CLIP/VAE(单独)。SDXL checkpoints 使用 CheckpointLoaderSimple。
  7. extra_model_paths.yaml 使用正斜杠: D:/AI/models/。
  8. HF/Torch 缓存必须位于 D 盘(在启动 bat 中设置)。
  9. MarkdownNote 节点可以在文本中引用模型名称;清理它们以避免虚假的“缺少模型”警告。

安装新模型

  1. 使用 curl 下载到 D:\AI\downloads\。
  2. 移动到 D:\AI\models\ 下的正确文件夹。
  3. 验证 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')"
    
  4. 重启 ComfyUI。
  5. 通过 http://127.0.0.1:8188/object_info/<LoaderNode> 验证加载器能看到该模型。
  6. 基于现有模板创建工作流,同时更新 widgets_values 和 widgets_values_named。
  7. 通过 API 测试(参见 test_zimage.py 模式)。
  8. 更新 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 Turboint8 UNET + FP8 编码器 + ae.safetensors8-9 步,CFG 1.0,res_multistep,simple,1024-1344px
Nova Anime XL v19NovaAnimeILV190.safetensors (SDXL)28 步,CFG 5,euler_ancestral,normal,CLIP skip 2
Prefect Pony XL v6PrefectPonyXLV6.safetensors (Pony/SDXL)28 步,CFG 6,euler_ancestral,normal,CLIP skip 2
Pixal3D/TRELLIS.2int8 UNETs + VAEs + DINOv3 + BiRefNet + MoGe1024px,布尔值:off=Pixal3D,on=TRELLIS.2
MiniMax H3精简 int8 + NVFP4 编码器 + 视频/音频 VAE5s 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。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能