╔══════════════════════════════════════════════════════════════╗
║                    魔壶 MagicPot - 重要说明                    ║
╚══════════════════════════════════════════════════════════════╝

═══════════════════════════════
  一、如何启动 ComfyUI
═══════════════════════════════

如果你有 NVIDIA 显卡（推荐）：
  → 双击运行 run_nvidia_gpu.bat

如果你想启用快速 FP16 模式（速度更快，画质略有损失）：
  → 双击运行 run_nvidia_gpu_fast_fp16_accumulation.bat

如果你只有 CPU（速度非常慢，不推荐）：
  → 双击运行 run_cpu.bat


═══════════════════════════════
  二、模型下载与安装
═══════════════════════════════

首次安装后，你需要下载快应用所需的 AI 模型。
所有模型放在 ComfyUI\models\ 目录下对应的子文件夹中。



────────────────────────────────
  Flux 套餐（文生图/风格转绘/线稿上色）约 20 GB
────────────────────────────────

1. flux1-dev-unet-fp8-e4m3fn.safetensors (11 GB)
   放到: ComfyUI\models\unet\
   抱脸: https://huggingface.co/Kijai/flux-fp8/blob/main/flux1-dev-fp8-e4m3fn.safetensors

2. t5xxl_fp8_e4m3fn.safetensors (4.6 GB)
   放到: ComfyUI\models\clip\
   抱脸: https://huggingface.co/comfyanonymous/flux_text_encoders/blob/main/t5xxl_fp8_e4m3fn.safetensors

3. clip_l.safetensors (0.2 GB)
   放到: ComfyUI\models\clip\
   抱脸: https://huggingface.co/comfyanonymous/flux_text_encoders/blob/main/clip_l.safetensors

4. ae.safetensors (0.3 GB)
   放到: ComfyUI\models\vae\
   抱脸: https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/main/ae.safetensors

5. FLUX.1-dev-ControlNet-Union-Pro-2.0.safetensors (4 GB)
   放到: ComfyUI\models\controlnet\
   抱脸: https://huggingface.co/Shakker-Labs/FLUX.1-dev-ControlNet-Union-Pro-2.0


────────────────────────────────
  Qwen 套餐（文生图/风格转绘/线稿上色）约 31 GB
────────────────────────────────

1. qwen_image_fp8_e4m3fn.safetensors (19 GB)
   放到: ComfyUI\models\unet\
   抱脸: https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/blob/main/split_files/diffusion_models/qwen_image_fp8_e4m3fn.safetensors

2. qwen_2.5_vl_7b_fp8_scaled.safetensors (8.7 GB)
   放到: ComfyUI\models\clip\
   抱脸: https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/blob/main/split_files/text_encoders/qwen_2.5_vl_7b_fp8_scaled.safetensors

3. qwen_image_vae.safetensors (0.2 GB)
   放到: ComfyUI\models\vae\
   抱脸: https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/blob/main/split_files/vae/qwen_image_vae.safetensors

4. Qwen-Image-InstantX-ControlNet-Union.safetensors (3.3 GB)
   放到: ComfyUI\models\controlnet\
   抱脸: https://huggingface.co/Comfy-Org/Qwen-Image-InstantX-ControlNets/blob/main/split_files/controlnet/Qwen-Image-InstantX-ControlNet-Union.safetensors


────────────────────────────────
  illustriousXL 套餐（风格转绘/线稿上色）约 9 GB
────────────────────────────────

1. illustriousXLDepth_v20.safetensors (4.7 GB)
   放到: ComfyUI\models\controlnet\
   下载: https://civitai.com/models/1023507/illustrious-xl-depth-midas

2. illustriousXLLineart_v10.safetensors (4.7 GB)
   放到: ComfyUI\models\controlnet\
   下载: https://civitai.com/models/1020431/illustrious-xl-lineart-anime

  注意: illustriousXL 系列还需要一个 SDXL checkpoint 模型。
  请在 Civitai 搜索 "illustriousXL" 下载你喜欢的 checkpoint，
  放到 ComfyUI\models\checkpoints\ 目录下。


────────────────────────────────
  SeedVR2 套餐（高清放大/超分辨率）约 31 GB
────────────────────────────────

1. seedvr2_ema_7b_sharp_fp16.safetensors (15.4 GB) — 锐利版，细节更丰富
   放到: ComfyUI\models\SEEDVR2\
   抱脸: https://huggingface.co/numz/SeedVR2_comfyUI/tree/main

2. seedvr2_ema_7b_fp16.safetensors (15.4 GB) — 柔和版，更自然平滑
   放到: ComfyUI\models\SEEDVR2\
   抱脸: https://huggingface.co/numz/SeedVR2_comfyUI/tree/main

3. ema_vae_fp16.safetensors (0.5 GB)
   放到: ComfyUI\models\SEEDVR2\
   抱脸: https://huggingface.co/numz/SeedVR2_comfyUI/tree/main


═══════════════════════════════
  三、目录结构说明
═══════════════════════════════

下载完成后，你的 models 目录应该类似这样：

ComfyUI\models\
  ├── unet\
  │   ├── flux1-dev-unet-fp8-e4m3fn.safetensors
  │   └── qwen_image_fp8_e4m3fn.safetensors
  ├── clip\
  │   ├── t5xxl_fp8_e4m3fn.safetensors
  │   ├── clip_l.safetensors
  │   └── qwen_2.5_vl_7b_fp8_scaled.safetensors
  ├── vae\
  │   ├── ae.safetensors
  │   └── qwen_image_vae.safetensors
  ├── controlnet\
  │   ├── FLUX.1-dev-ControlNet-Union-Pro-2.0.safetensors
  │   ├── Qwen-Image-InstantX-ControlNet-Union.safetensors
  │   ├── illustriousXLDepth_v20.safetensors
  │   └── illustriousXLLineart_v10.safetensors
  ├── checkpoints\
  │   └── (你的 illustriousXL checkpoint)
  └── SEEDVR2\
      ├── seedvr2_ema_7b_sharp_fp16.safetensors
      └── ema_vae_fp16.safetensors


═══════════════════════════════
  四、更新
═══════════════════════════════

更新 ComfyUI 代码：运行 update\update_comfyui.bat
更新 ComfyUI + Python 依赖：运行 update\update_comfyui_and_python_dependencies.bat
（仅在遇到 Python 依赖问题时才需要运行后者）


═══════════════════════════════
  五、常见问题
═══════════════════════════════

Q: 界面上出现红色错误？
A: 确保你已经下载了对应快应用所需的全部模型，并放在正确的目录下。

Q: 下载速度慢？
A: 翻墙或使用 IDM 下载。

Q: 显存不足？
A: 推荐使用 3080 20G 以上显卡。