Upscayl 批量放大手把手教程：一次配置，整文件夹图片自动放大
【免费下载链接】upscayl🆙 Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.项目地址: https://gitcode.com/GitHub_Trending/up/upscayl
Upscayl 是一款免费开源的 AI 图片放大工具，它的批量放大（Batch Upscayl）功能让你只需选一个文件夹，里面的图片就按统一参数逐个放大、自动归档。本文带你从零跑通第一次放大，再配置一个完整的批量任务。
场景开场：200 张待放大的截图
假设你手上有 200 张产品截图，需要放大 4 倍用于详情页。单张模式下，"选图→放大→等待→下一张"要重复 200 遍，中途换格式还得重设参数。批量模式把入口从"选一张图"换成"选一个文件夹"：参数只配置一次，程序自动处理每一张，输出统一放进一个自动命名的子文件夹。
30秒跑通：先启动，再跑第一张
安装：从系统软件源或官方 Release 下载对应系统的安装包，双击安装。想直接从源码启动也行，下面命令完成克隆、装依赖、启动开发版：
git clone https://gitcode.com/GitHub_Trending/up/upscayl cd upscayl npm install npm start启动后进入 Upscayl 标签，按界面四步操作：
- 顶部勾选 Batch mode，"Select file" 变成 "Select folder"
- 点按钮选择文件夹，目录里放 2~3 张 png/jpg 图片
- 模型保持默认 upscayl-standard-4x，点 "Select output path" 选输出目录（比如桌面）
- 点 Upscayl 按钮开始
看到什么：输出目录下自动出现 upscayl_png_upscayl-standard-4x_4x 子文件夹，进度条持续推进，完成后弹出系统通知。这个命名规则在 electron/commands/batch-upscayl.ts 中定义，格式是 upscayl_输出格式_模型_倍数。
功能拆解：批量放大四个核心场景
场景一：整文件夹一键放大
做什么：把文件夹内所有受支持图片按同一参数放大。 怎么做：勾选 Batch mode → 选择文件夹 → 设置输出路径 → 点 Upscayl。 看到什么：支持的格式是 png、jpg、jpeg、webp（见 common/image-formats.ts），其他扩展名会被跳过；图片逐张处理，设置页日志区实时滚动进度。
场景二：统一输出格式与压缩
做什么：控制输出文件类型和体积。 怎么做：设置页里在 "Image format" 选 jpg / png / webp，拖 "Compression" 滑块定压缩率。 看到什么：输出文件以选定格式保存；jpg/webp 压缩率越高文件越小、细节损失越多，png 是无损格式，压缩项对它基本无效。
场景三：保留拍摄信息（EXIF）
做什么：把原图的拍摄时间、设备等元数据带到放大后的文件里。 怎么做：设置页打开 "Copy metadata" 开关，再启动批量任务。 看到什么：任务结束后程序自动逐文件复制元数据，日志区出现 "Metadata copied to" 记录，放大图与原图信息一致。
场景四：中途叫停
做什么：批量跑到一半想停。 怎么做：点界面上的 Stop 按钮。 看到什么：进程立即结束，已写出的文件保留在原输出文件夹；剩下没跑的文件重新选一次即可续跑。
参数与调优：批量任务关键参数表
| 参数 | 影响 | 推荐值 | 适用场景 |
|---|---|---|---|
| Model | 决定细节生成风格 | upscayl-standard-4x | 日常通用；插画类可试 digital-art-4x |
| Scale | 放大倍数 | 4 | 内置模型均为 4x；要 x2/x3 需装对应自定义模型 |
| Compression | 有损格式压缩率 | jpg/webp 从 90 起试 | 想控制输出体积时 |
| Tile Size | 分块大小，影响显存占用 | 留空用默认；崩溃时改 512 | 处理高分辨率大图 |
| TTA Mode | 多次采样提升质量，耗时更长 | 默认关 | 不赶时间、追求最高质量 |
| GPU ID | 指定使用的 GPU | 留空默认；多显卡填编号 | 双显卡选错卡、速度异常慢 |
避坑速查：批量放大常见问题
- 输出里少了几张图→ 原因：该文件扩展名不在 png/jpg/jpeg/webp 支持列表 → 解法：先转成 webp 再放进文件夹。
- 处理大图时程序崩溃→ 原因：整图一次性载入，显存不够 → 解法：设置里把 Tile Size 降到 512 或 256 再重跑。
- 速度极慢，像在跑 CPU→ 原因：Vulkan 不可用或选错显卡 → 解法：设置页日志区会列出可用 GPU 编号（查找步骤见 docs/Guide.md 的 "GPU ID" 一节），在 GPU ID 框填入正确编号。
- 日志出现 Error，任务中断→ 原因：某张图损坏或文件名含特殊字符 → 解法：在 Log Area 找到具体报错，修复该文件后重跑，已完成的文件不受影响。
- 找不到输出文件夹→ 原因：输出不直接存进你选的目录，而是自动创建 upscayl_ 前缀的子文件夹 → 解法：在输出路径下找形如 upscayl_png_upscayl-standard-4x_4x 的目录。
进阶组合：自定义模型与指定宽度
- 自定义模型：把 NCNN 模型的 .bin 和 .param 文件放进一个名为 models 的文件夹，在设置页用 "Select Custom Models Folder" 指定它，模型下拉框里即可选用（步骤详见 docs/Guide.md 的 "Custom Models" 一节）。
- 指定宽度：勾选自定义宽度并设为 1920，输出即统一缩放到 1920px 宽，子文件夹名会相应显示 _1920px，适合做网页首图这类固定尺寸需求。
收尾
你现在会：30 秒启动并跑通第一次放大；配置并启动整文件夹批量任务；通过日志区定位参数与报错。 更多参数说明见官方文档 docs/Guide.md，遇到问题翻 docs/troubleshooting/ 里对应操作系统的章节。
【免费下载链接】upscayl🆙 Upscayl - #1 Free and Open Source AI Image Upscaler for Linux, MacOS and Windows.项目地址: https://gitcode.com/GitHub_Trending/up/upscayl
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
