Community图像github.com

ComfyUI 自动放大

自动放大 ComfyUI 生成的图像,支持按需放大、批量放大文件夹或自动监控新图像。集成内置无限循环预防和分辨率防护。

ComfyUI 自动放大 是什么?

此技能提供一组纯 Python 标准库脚本(`upscale_image.py` 和 `watch_upscale.py`),用于自动放大 ComfyUI 生成的图像。它可无缝集成到 ComfyUI 的工作流中:按需放大最新或指定图像,批量放大输出文件夹,或作为后台守护进程监控 ComfyUI API 或本地目录,自动处理每张新生成的图像。内置安全机制包括无限循环预防(通过标记和忽略已放大的图像)、内存溢出防护(超过最大输入边长的图像被跳过)以及启动时自动快照以避免重复处理历史文件。用户可选用内置放大模型(如 4x-UltraSharp 或 RealESRGAN)或自定义 ComfyUI API 格式的工作流(如 Ultimate SD Upscale、Tiled Diffusion)。它兼容任何运行 ComfyUI HTTP/WebSocket API 的环境,尤其适合自动化流水线和图像批量处理场景。

兼容平台~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 给任一脚本。CLI 标志始终覆盖配置文件中的值。

自定义工作流(Ultimate SD Upscale、Tiled Diffusion、SUPIR 等)

要使用自定义 ComfyUI 放大/高清修复工作流代替内置模型放大器:

python scripts/watch_upscale.py --workflow path/to/upscale_api.json --input-node-id 1

有关导出 API 格式 JSON、处理多个 LoadImage 节点以及故障排除,请参阅 references/custom-workflows.md。

内置安全防护

  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] <source> -> upscaled/...。
  • 对于监控器运行,执行快速的一次性 --once --dry-run 测试,或检查守护进程日志中是否有 Waiting for new images...,并确认在 ComfyUI 中生成一张图像恰好触发一条 [Upscaled OK] 条目而不重复触发。

相关技能