故障诊断 & 修复
故障诊断页汇总 Zipoly 压缩/转换功能异常的标准排查路径：先用内置工具诊断定位引擎状态，再按症状对照下方方案处理，仍无法解决时按「技术支持」清单反馈。90% 的压缩失败由缺少 VC++ 运行库导致，建议优先检查第一项。
排查路线：系统设置 → 工具诊断 → 运行诊断 → 按结果对号入座。
症状速查
| 症状 | 最可能原因 | 跳转 |
|---|---|---|
✗ 无法执行 / 找不到 VCRUNTIME140.dll | 缺少 VC++ 运行库 | 缺运行库 |
✗ 未找到可执行文件 / ⚠ 无响应 | 工具文件丢失或损坏 | 工具文件异常 |
装了运行库仍 ✗ 无法执行 | 被杀毒软件拦截 | 被拦截 |
| Linux 启动失败 | webkit2gtk/gtk3 缺失 | Linux 依赖 |
| macOS 提示「无法验证开发者」 | Gatekeeper 拦截 | Gatekeeper |
| 提示「已经过 Draco 压缩」 | 对已压缩文件重复压缩 | 用原始未压缩文件，见 FAQ |
缺少 Visual C++ 运行库（最常见）
症状：诊断显示 ✗ 无法执行，或提示「找不到 VCRUNTIME140.dll」。
原因：Windows 缺少 Microsoft Visual C++ 2015-2022 Redistributable (x64)，这是压缩引擎的必需组件。90% 的压缩失败由此导致。
解决：
- 下载 VC++ 运行库
- 安装后重新打开 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 gtk3macOS Gatekeeper 拦截
症状：macOS 首次打开 Zipoly 提示「无法验证开发者」或「已损坏，无法打开」。
原因：macOS Gatekeeper 默认拦截未签名/未公证的应用。
解决：右键点击 Zipoly.app → 选择「打开」（或进入 系统设置 → 隐私与安全性 → 仍要打开）。签名及公证计划后续版本提供。
高级排查
查看详细日志
诊断结果窗口中点击「查看原始输出」→「复制结果」，将报告发送给技术支持。
手动验证工具
cd "C:\Program Files\Zipoly"
draco_transcoder.exe预期显示使用帮助信息（Usage: ...）。若报错 VCRUNTIME140.dll，说明缺少 VC++ 运行库。
技术支持
以上方法均无效时，联系 QQ 2162788746，提供以下信息加快定位：
- 诊断报告（点击「复制结果」获取）
- 系统版本（Win + R →
winver） - Zipoly 版本号（系统设置页底部）
常见问题
诊断全部 ✓ 正常，但压缩还是失败？
检查文件本身：Draco 压缩过的文件无法再次压缩（需原始未压缩文件）；极小模型（< 100KB）或极简模型（< 1000 面）压缩收益为负，可跳过压缩。仍失败时用「高级排查 → 查看详细日志」复制报告反馈。
压缩失败会损坏原文件吗？
不会。Zipoly 的输出是带 _optimized 后缀的新文件，原文件不会被覆盖；失败时删除输出文件重试即可。
Mac 也需要装 VC++ 运行库吗？
不需要。VC++ 运行库缺失是 Windows 独有的问题；macOS 常见问题是 Gatekeeper 拦截，Linux 常见问题是依赖缺失，分别见上文对应小节。
重装 Zipoly 后还是提示工具异常？
确认两件事：从官网或 Gitee Release 下载的是完整安装包（不要单独替换 draco_transcoder.exe 等工具文件）；安装后以管理员权限运行一次 Windows 版（右键 Zipoly 快捷方式 → 「以管理员身份运行」，确认权限后可再切回普通方式启动）。仍异常请附「诊断报告」联系技术支持。