ComfyUI 自動放大 是做什麼的?
在 ComfyUI 完成圖片生成後,使用僅依賴標準庫的 Python 指令碼自動放大圖片,並內建無限循環預防與解析度防護。
先決條件與預先檢查
務必先檢查 ComfyUI 連線狀態並探索已安裝的放大模型:
python scripts/upscale_image.py --check --server http://127.0.0.1:8188
- 若 ComfyUI 執行於其他主機或連接埠,請傳入
--server http://<host>:<port>。 - 請注意
已安裝的放大模型列表。若使用者未指定模型,指令碼會自動選取最佳安裝模型(優先選用4x-UltraSharp.pth、RealESRGAN_x4plus.pth等)。 - 若列表為空白且使用者希望使用內建模型放大,請指示他們將
.pth/.safetensors放大模型放入ComfyUI/models/upscale_models/中(或提供自訂的--workflow)。
模式 1:即時放大
當使用者想要立即放大已生成的圖片時,請使用 upscale_image.py。
放大 ComfyUI 歷史上最新的生成圖片
# 放大最近一張未經放大的圖片
python scripts/upscale_image.py --latest
# 放大最近 4 張生成圖片,並將 4 倍輸出縮小 0.5 倍以獲得清晰的 2 倍結果
python scripts/upscale_image.py --latest 4 --scale-by 0.5
# 使用特定的已安裝模型,並同時儲存本地副本
python scripts/upscale_image.py --latest 1 --model 4x-UltraSharp.pth --save-dir ./upscaled_out
放大特定本地圖片或資料夾
# 單一或多個檔案
python scripts/upscale_image.py --image path/to/gen_0001.png
# 批次放大目錄中所有未經放大的圖片
python scripts/upscale_image.py --dir path/to/ComfyUI/output
執行前預覽(驗證)
使用 --dry-run(並可選用 --json 取得結構化輸出)來驗證目標圖片、尺寸與模型選擇,而不會將任何任務排入 ComfyUI:
python scripts/upscale_image.py --latest --dry-run --json
模式 2:自動生成後監聽
使用 watch_upscale.py 來執行背景精靈,該精靈會在 ComfyUI 完成生成時自動放大每一張新圖片。
當透過
run_command啟動監聽器時,請設定IsDaemon: true,讓它在使用者於 ComfyUI 中生成圖片時持續在背景執行。
選項 A:監聽 ComfyUI API(建議 — 適用於本地與遠端)
# 若已安裝 websocket-client 則自動使用 WebSocket,否則會回退到輕量級 /history 輪詢
python scripts/watch_upscale.py --mode comfyui --server http://127.0.0.1:8188
# 強制使用純標準庫 HTTP 輪詢,間隔 1.5 秒,自訂前綴並設定 2 倍目標輸出
python scripts/watch_upscale.py --mode comfyui --transport poll --interval 1.5 --scale-by 0.5 --prefix "upscaled/{stem}_hd"
選項 B:監聽本地輸出目錄
python scripts/watch_upscale.py --mode folder --watch-dir "D:/ComfyUI/output" --server http://127.0.0.1:8188
可重複使用設定
將 config.example.json 複製到本地設定檔(例如 my_upscale_config.json),然後向任一指令碼傳入 --config my_upscale_config.json。命令列標誌永遠會覆蓋設定檔中的值。
自訂工作流程(Ultimate SD Upscale、Tiled Diffusion、SUPIR 等)
若要使用自訂的 ComfyUI 放大/高清修復工作流程,而非內建模型放大:
python scripts/watch_upscale.py --workflow path/to/upscale_api.json --input-node-id 1
請參閱 references/custom-workflows.md 了解如何匯出 API 格式 JSON、處理多個 LoadImage 節點以及故障排除。
內建安全防護
- 無限循環預防:
- 每個提交的放大任務都會被標記為
extra_data.auto_upscale_generated = true,並透過prompt_id追蹤。 - 輸出會儲存在
upscaled/下(預設filename_prefix = "upscaled/upscaled"),兩個指令碼都會自動忽略upscaled/中的圖片或符合upscaled_前綴的圖片。
- 每個提交的放大任務都會被標記為
- 記憶體不足/過度放大防護:
- 最長邊超過
--max-input-side(預設2048像素)的圖片會自動跳過。傳入--max-input-side 0可停用此功能。
- 最長邊超過
- 監聽器啟動時不回溯處理:
watch_upscale.py在啟動時會快照現有的 ComfyUI 歷史/資料夾內容,僅處理 之後 新產生的圖片。
驗證
- 對於即時執行,請確認指令以代碼
0結束並顯示[UPSCALED] <來源> -> upscaled/...。 - 對於監聽器執行,請進行一次快速的
--once --dry-run測試,或檢查背景精靈日誌中是否有正在等待新圖片...,並確認在 ComfyUI 中生成一張圖片只會觸發一次[Upscaled OK]條目,而不會重複觸發。