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 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) 並重新開啟工作流程。
- 28 GB RAM 需使用 int8/FP8 建置:BF16 需要 40 GB。
- H3 需要:
--disable-pinned-memory --fp16-intermediates 旗標。
- 請勿混用模型類型:Z-Image 使用個別的 UNET/CLIP/VAE。SDXL checkpoint 使用 CheckpointLoaderSimple。
- extra_model_paths.yaml 使用正斜線:
D:/AI/models/。
- HF/Torch 快取必須位於 D 槽:在啟動批次檔中設定。
- 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 UNET + VAE + DINOv3 + BiRefNet + MoGe | 1024px, 布林值: off=Pixal3D, on=TRELLIS.2 |
| MiniMax H3 | 精簡 int8 + NVFP4 編碼器 + video/audio 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 基礎、FLUX、像素風格 LoRA、SDXL ControlNet、H3 FL2VA、放大模型 (ESRGAN/SeedVR2)、材質 LoRA、Kohya 訓練工具、Krita AI Diffusion、Aseprite/Pixelorama。