Community影像github.com

ComfyUI 自動放大

透過 ComfyUI HTTP/WebSocket API,自動放大 ComfyUI 生成的圖片。可用於即時放大最新生成的圖片、批次放大資料夾內圖片,或啟動背景監聽器自動放大每一張新圖片。支援內建放大模型(如 4x-UltraSharp、RealESRGAN)與自訂 ComfyUI API 格式工作流程(如 Ultimate SD Upscale、Tiled Diffusion、SUPIR)。

ComfyUI 自動放大 是什麼?

這是一個專為 ComfyUI 設計的自動圖片放大技能,開發者與 AI 代理使用者可以透過純 Python 指令碼輕鬆整合。它提供兩種主要操作模式:**即時放大**模式讓使用者立即放大已產生的圖片,支援指定最新圖片數量、自訂放大模型與輸出目錄;**背景監聽**模式則像背景精靈一樣持續監聽 ComfyUI API 或本地輸出資料夾,自動將新生成的圖片放大,非常適合長時間生成作業。 該技能內建多層安全防護,包括無限循環預防(透過標記與追蹤 prompt_id 避免重複放大)、防止過度放大(當圖片最長邊超過 2048 像素時自動跳過),以及監聽器啟動時不會回溯處理既存圖片。支援透過 `--workflow` 參數匯入自訂 ComfyUI API 格式的放大工作流程,相容於 Ultimate SD Upscale、Tiled Diffusion 等進階放大技術,適合需要高品質放大或特殊處理流程的使用者。 該技能支援所有能執行 Python 3 的環境(建議 Python 3.10+),可搭配 Claude Code、Codex 等 AI 代理工具或直接從終端機執行,讓使用者無需手動操作 ComfyUI 節點即可自動完成圖片放大。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/HomlesRichard/comfyui-auto-upscale/tree/HEAD

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 節點以及故障排除。

內建安全防護

  1. 無限循環預防:
    • 每個提交的放大任務都會被標記為 extra_data.auto_upscale_generated = true,並透過 prompt_id 追蹤。
    • 輸出會儲存在 upscaled/ 下(預設 filename_prefix = "upscaled/upscaled"),兩個指令碼都會自動忽略 upscaled/ 中的圖片或符合 upscaled_ 前綴的圖片。
  2. 記憶體不足/過度放大防護:
    • 最長邊超過 --max-input-side(預設 2048 像素)的圖片會自動跳過。傳入 --max-input-side 0 可停用此功能。
  3. 監聽器啟動時不回溯處理:
    • watch_upscale.py 在啟動時會快照現有的 ComfyUI 歷史/資料夾內容,僅處理 之後 新產生的圖片。

驗證

  • 對於即時執行,請確認指令以代碼 0 結束並顯示 [UPSCALED] <來源> -> upscaled/...。
  • 對於監聽器執行,請進行一次快速的 --once --dry-run 測試,或檢查背景精靈日誌中是否有 正在等待新圖片...,並確認在 ComfyUI 中生成一張圖片只會觸發一次 [Upscaled OK] 條目,而不會重複觸發。

相關技能