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。
内置安全防护
- 无限循环预防:
- 每个提交的放大任务都标记有
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] <source> -> upscaled/...。 - 对于监控器运行,执行快速的一次性
--once --dry-run测试,或检查守护进程日志中是否有Waiting for new images...,并确认在 ComfyUI 中生成一张图像恰好触发一条[Upscaled OK]条目而不重复触发。