Community影像github.com

ComfyUI 設定

在 Windows 系統上搭配 RTX 3090 進行本機 ComfyUI 安裝、模型管理、工作流程與疑難排解,支援 AI 圖像、影片與 3D 生成。

ComfyUI 設定 是什麼?

此技能提供完整的 ComfyUI 本機開發環境設定,目標系統為 Windows 10 Pro、RTX 3090 24 GB、28 GB RAM 及 Xeon E5-2696 v4 處理器。技能涵蓋可攜式 ComfyUI 0.44.0 安裝、模型資料夾架構(包括 checkpoint、diffusion_models、text_encoders、vae、ControlNet、LoRA、CLIP vision、upscale 與背景移除模型)、工作流程管理(2D、3D、影片)以及產出檔案分段儲存。關鍵規則強調:必須同時更新 `widgets_values` 與 `widgets_values_named`、新增模型後需重新啟動 ComfyUI、清理瀏覽器快取、在 28 GB RAM 環境下使用 int8/FP8 建置、明確區分模型類型。支援 Z-Image Turbo、Nova Anime XL、Prefect Pony XL、Pixal3D/TRELLIS.2 以及 MiniMax H3 等已知模型,並提供完整疑難排解表,涵蓋常見錯誤如 `hostbuf_file_reader_read failed`、`Fault failed: 2` 及「遺失模型」對話框等。

相容平台~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 (Ampere), 28 GB RAM (→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. 28 GB RAM 需使用 int8/FP8 建置:BF16 需要 40 GB。
  5. H3 需要:--disable-pinned-memory --fp16-intermediates 旗標。
  6. 請勿混用模型類型:Z-Image 使用個別的 UNET/CLIP/VAE。SDXL checkpoint 使用 CheckpointLoaderSimple。
  7. extra_model_paths.yaml 使用正斜線:D:/AI/models/。
  8. HF/Torch 快取必須位於 D 槽:在啟動批次檔中設定。
  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 UNET + VAE + DINOv3 + BiRefNet + MoGe1024px, 布林值: off=Pixal3D, on=TRELLIS.2
MiniMax H3精簡 int8 + NVFP4 編碼器 + video/audio 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 基礎、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.

相關技能