Upscayl图片放大失败需依次检查GPU兼容性、图像选择、模型匹配、输出路径及GPU调用：确保Vulkan支持独立显卡，正确选择本地JPG/PNG/WEBP/BMP图，按图像类型选对应AI模型，设置合法输出路径并避免16x直放，最后验证状态栏显示GPU ID及日志中Vulkan设备信息。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装Upscayl但无法正确执行图片放大操作，则可能是由于图像选择、模型配置或GPU支持未就绪。以下是解决此问题的步骤：
一、确认系统与硬件兼容性
Upscayl依赖Vulkan API进行GPU加速，多数集成显卡（如Intel UHD Graphics、AMD Radeon Vega iGPU）及纯CPU环境无法正常运行。必须确保设备搭载兼容Vulkan的独立显卡（如NVIDIA GTX 10系列及以上、AMD RX 500系列及以上），且已安装对应驱动。
1、在Windows中按Win+R，输入dxdiag，切换至“显示”选项卡，查看“驱动程序模型”是否为WDDM 2.x或更高版本，并确认“功能级别”支持Direct3D 12。
2、在Linux终端执行vulkaninfo --summary，检查输出中是否存在有效GPU设备及“VK_KHR_get_physical_device_properties2”等关键扩展。
3、macOS用户需确认系统为macOS 12或更新版本，并在“系统设置→隐私与安全性→完全磁盘访问”中为Upscayl授予权限。
二、正确选择并加载图像
Upscayl仅处理本地文件系统中的图像，不支持URL直链或剪贴板粘贴。若点击“SELECT IMAGE”无响应或提示格式错误，说明文件路径异常或格式不受支持。
1、点击主界面中央的SELECT IMAGE按钮（非“添加文件”或拖拽区）。
2、在弹出的文件选择对话框中，手动导航至目标图片所在目录，**不可双击进入子文件夹后再回退**，否则部分Linux桌面环境可能触发路径缓存失效。
3、确认所选文件扩展名为JPG、PNG、WEBP或BMP之一；TIFF、GIF、HEIC等格式将被静默忽略。
三、匹配图像类型与AI模型
不同模型针对特定图像特征优化，错误选择会导致边缘伪影、色彩失真或处理中断。Upscayl v2.5+默认启用模型校验机制，若检测到输入内容与模型不匹配，将自动终止处理并显示警告。
1、普通数码照片（含人像、风景、截图）：在“Upscaling Type”下拉菜单中选择GENERAL PHOTO。
在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。
2、动漫、插画、二次元风格图像：选择RealESRGAN AnimeVideoV3或DigitalArt。
3、需要强化纹理与边缘锐度的工程图、文字截图：启用Ultrasharp模式（需在设置中勾选“Enable Ultrasharp”）。
四、设置输出路径与尺寸参数
Upscayl默认将输出文件保存至原图所在目录下的upscayled子文件夹。若该路径被系统策略锁定（如OneDrive同步目录、受限沙盒环境），则处理会失败且不报错。
1、点击SET OUTPUT FOLDER按钮，手动指定一个**本地非同步、非只读、无中文空格路径**（例如：C:\upscayl_output 或 /home/user/upscayl_out）。
2、在“Scale Factor”区域选择放大倍数：推荐从2x起步测试；4x适用于高质量输出；**避免直接选择16x**（需分步执行：2x→2x→2x→2x）。
3、如需自定义分辨率而非固定倍率，切换至“Custom Size”选项卡，输入精确像素值（宽度×高度），并勾选“Maintain Aspect Ratio”防止形变。
五、启动处理并验证GPU调用
点击“UPSCAYL”按钮后，界面右下角状态栏应立即显示GPU ID编号（如“GPU: 0”）及Vulkan初始化成功提示。若显示“CPU fallback”或长时间无响应，说明GPU未被识别。
1、观察进度条下方日志区域是否出现类似"Loaded Vulkan device: NVIDIA GeForce RTX 4070"字样。
2、若仅显示“Using CPU backend”，请前往“Settings → GPU Settings”，在GPU ID字段手动输入0并重启软件。
3、处理开始后，可打开系统任务管理器（Windows）或htop + nvidia-smi（Linux），确认GPU使用率跃升至30%以上，证明AI推理正在GPU上运行。
