# ComfyUI图片超分教程

用 UpscaleModelLoader 与 ImageUpscaleWithModel 放大输入，按原图对应区域检查新增细节和伪影。

本地结构与素材核验，未执行 ComfyUI 前端导入或扩散/ESRGAN 推理。图像与原 JSON 来源见 provenance.json。所有工作流为 UI 格式 0.4，与 prompt-api.json 分开。权重不打包。

## 使用

1. python check.py
2. 查看 models.csv，按模型出处准备文件。
3. 用本地 ComfyUI 打开 workflow.json，重新选择 Loader 下拉和输入。
4. 自己完成真实小样，填写 acceptance.csv。

## 1. 记录原图和目标用途

下载 input.png，查看原始宽高，选择边缘、纹理、细字三处作为裁切点。不要先以浏览器自动缩放的展示尺寸当文件分辨率；目标输出与版位要求单独记录。

## 2. 准备模型权重和 JSON

官方基础例使用 4x-ESRGAN.pth，放入 models/upscale_models。导入 workflow.json 后确认 Load Upscale Model 对应实际文件；本站包不含此权重。

## 3. 检查超分的核心连接

Load Image 的 IMAGE 接 ImageUpscaleWithModel.image，UpscaleModelLoader 输出接 upscale_model，输出 IMAGE 接 Save Image。此工作流没有扩散采样器，不要额外添加 denoise 以为所有放大都需要它。

## 4. 先单图运行并读取尺寸

点击 Queue 后获取实际文件，检查输出宽高相对原图是否符合模型倍率。4x 模型通常宽高各放大四倍，不是总像素只乘四；实际尺寸应由文件信息确认。

## 5. 对同一区域做两种裁切

按输入坐标裁切边缘与纹理，输出裁切坐标乘对应倍率，缩放到相同展示尺寸比较。记录过锐边、重复纹理与细字是否被虚构，不能把锐利感等同信息真实性。

## 6. 控制最终交付尺寸

如目标版位较小，再用 ImageScale 调整最终尺寸并重新检查。大图输入发生 OOM 时降低输入尺寸或按当前节点策略拆分，先保存原件，不连续重复未知队列任务。

## 7. 留存模型与验收记录

保存模型来源、倍率、输入与真实输出，填写 crops.csv 和 acceptance.csv。本页含官方运行界面示例及原图，当前机器仅核验材料和节点结构，没有执行 ESRGAN 推理。


queue_client.py 默认只查询；--submit 明确触发本地真实推理。batch_manifest.py 仅生成计划，未提交。故障日志、history 响应和空验收栏是教材，不是本站成功实测。

## 官方来源

- https://docs.comfy.org/tutorials/basic/upscale
- https://github.com/Comfy-Org/ComfyUI
- https://docs.comfy.org/troubleshooting/model-issues