Upscayl 是一款面向 Linux 优先设计的开源 AI 图像超分工具，其核心推理引擎基于 NCNN + Vulkan 架构。在 Arch Linux 中，若启动失败、报错"Vulkan not available"或 AI 放大功能灰显，通常并非程序本身缺陷，而是底层图形驱动链未就绪。本文提供一套可验证、分硬件路径的 Vulkan 环境构建方案，聚焦于实际生效的配置步骤与诊断逻辑。

关键前提：Upscayl 对 GPU 的硬性依赖

不同于纯 CPU 模式（性能极低且官方不支持），Upscayl 默认启用 Vulkan 后端执行张量计算。项目源码中 src/renderer/utils/gpu-detect.ts 显示，它通过 VkPhysicalDeviceProperties 查询设备能力，并仅接受满足以下条件的 GPU：

• 支持 Vulkan 1.2+ API
• 具备 shaderFloat64 和 vertexPipelineStoresAndAtomics 扩展
• 显存 ≥ 2GB（推荐）

这意味着多数 Intel HD/UHD 集成显卡（如 Kaby Lake 及更早）、AMD GCN 1.0/2.0 架构（Radeon R7/R9 系列）及老旧 NVIDIA Kepler 架构均无法启用加速——非配置错误，而是硬件不兼容。

环境确认：三步定位瓶颈

1. 识别 GPU 型号与代际：
   lspci -k | grep -A 3 -E "(VGA|3D)"
   关注 Kernel driver in use: 字段，判断当前加载的是开源（i915, amdgpu, radeon）还是闭源驱动（nvidia）。
2. 检查 Vulkan ICD 注册状态：
   ls /usr/share/vulkan/icd.d/
   正常应列出对应驱动的 JSON 文件（如 nvidia_icd.json, radeon_icd.x86_64.json, intel_icd.x86_64.json）。缺失即代表 Vulkan 层未被驱动注册。
3. 验证 Vulkan 运行时能力：
   vulkaninfo --summary 2>/dev/null | grep -E "(deviceCount|GPU)"
   输出应显示至少 1 个可用 GPU 设备；若为空或报错 VK_ERROR_INITIALIZATION_FAILED，说明 ICD 加载失败。

按 GPU 厂商部署 Vulkan 运行时

NVIDIA（Turing 及更新架构，如 RTX 20/30/40 系列）

使用 nvidia 专有驱动（非 nouveau）：

sudo pacman -S nvidia nvidia-utils vulkan-icd-loader lib32-vulkan-icd-loader
# 若需 OpenCL 互操作（部分模型预处理可能用到）
sudo pacman -S opencl-nvidia lib32-opencl-nvidia

注意：RTX 40 系列需内核 ≥ 6.2，且必须安装 nvidia 而非 nvidia-lts 包（后者缺少最新 GPU 固件支持）。

AMD（RDNA1 及更新，如 RX 5700、6600XT、7800XT）

启用开源 amdgpu 驱动并加载 Vulkan ICD：

sudo pacman -S mesa vulkan-radeon lib32-mesa lib32-vulkan-radeon
# 启用 AMDGPU PRO 内核参数（可选，提升 RDNA3 稳定性）
echo 'options amdgpu ppfeaturemask=0xffffffff' | sudo tee /etc/modprobe.d/amdgpu.conf

Intel（Xe-HPG/Arc A-Series，如 Arc A380/A750/A770）

需启用 mesa 的 iris 驱动与专用 Vulkan ICD：

sudo pacman -S mesa vulkan-intel lib32-mesa lib32-vulkan-intel
# 安装媒体处理加速组件（提升视频帧超分体验）
sudo pacman -S intel-media-driver intel-gmmlib

重要：Arc 显卡需内核 ≥ 6.1 + firmware-linux ≥ 20230515，否则 vulkaninfo 将无法枚举设备。

验证与调试：从命令行到 Upscayl UI

完成安装后执行：

1. 运行 vkcube --c 300 —— 观察是否渲染出持续旋转立方体（300 帧后自动退出）；
2. 启动 Upscayl，打开 Settings → About → System Info，确认 "GPU Vendor"、"Vulkan Version"、"Compute Queue Count" 字段非空；
3. 在图像放大界面选择任意 AI 模型，点击 "Preview" —— 若进度条流动且无报错弹窗，即 Vulkan 推理通路已激活。

典型故障与修复策略

• "vkcube: symbol lookup error"：通常因 libvulkan.so.1 版本冲突。执行 sudo ldconfig 并重启会话；
• Upscayl 显示 GPU 但放大失败：检查是否启用了 Wayland 会话。Upscayl 当前（v3.6+）在 X11 下 Vulkan 兼容性更稳定，可临时切换：export GDK_BACKEND=x11 && upscayl；
• 多 GPU 系统识别错误设备：通过环境变量强制指定，例如仅使用独显：VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/nvidia_icd.json upscayl。