故障诊断 & 修复

压缩或转换功能异常时，先在系统设置 → 工具诊断中点击「运行诊断」，根据检测结果对照下方方案处理。

缺少 Visual C++ 运行库（最常见）

症状：诊断显示 ✗ 无法执行，或提示「找不到 VCRUNTIME140.dll」。

原因：Windows 缺少 Microsoft Visual C++ 2015-2022 Redistributable (x64)，这是压缩引擎的必需组件。90% 的压缩失败由此导致。

解决：

1. 下载 VC++ 运行库
2. 安装后重新打开 Zipoly 即可（无需重启系统）

工具文件丢失或损坏

症状：✗ 未找到可执行文件 或 ⚠ 无响应。

解决：重新安装 Zipoly。不要单独下载 draco_transcoder.exe 或 gltfpack.exe 替换，可能导致版本不兼容。

被杀毒软件拦截

症状：诊断显示 ✗ 无法执行，但 VC++ 运行库已安装。

解决：将 Zipoly 安装目录（C:\Program Files\Zipoly\）添加到杀毒软件白名单/排除列表。

Linux 依赖缺失

症状：Linux 下启动失败或功能不可用。

解决：

# Ubuntu / Debian
sudo apt-get install libwebkit2gtk-4.1-0 libgtk-3-0

# Fedora / RedHat
sudo dnf install webkit2gtk4.1 gtk3

macOS Gatekeeper 拦截

症状：macOS 首次打开 Zipoly 提示「无法验证开发者」或「已损坏，无法打开」。

原因：macOS Gatekeeper 默认拦截未签名/未公证的应用。

解决：右键点击 Zipoly.app → 选择「打开」（或进入 系统设置 → 隐私与安全性 → 仍要打开）。签名及公证计划后续版本提供。

高级排查

查看详细日志

诊断结果窗口中点击「查看原始输出」→「复制结果」，将报告发送给技术支持。

手动验证工具

cd "C:\Program Files\Zipoly"
draco_transcoder.exe

预期显示使用帮助信息（Usage: ...）。若报错 VCRUNTIME140.dll，说明缺少 VC++ 运行库。

技术支持

以上方法均无效时，联系 QQ 2162788746，提供以下信息加快定位：

1. 诊断报告（点击「复制结果」获取）
2. 系统版本（Win + R → winver）
3. Zipoly 版本号（系统设置页顶部）