遇到问题时

找到原因。
尝试下一步。

请保留源文件。大多数问题可通过回到保守优化预设、每次只改一个选项来定位。

“请选择单个资源完整的 .glb 文件”

将 .gltf 重命名为 .glb 并不能完成格式转换。请导出内嵌缓冲区与图片的二进制 glTF。本服务拒绝外部引用，包括 data URI，并会在处理前校验 GLB 结构。

Draco 或不支持的必需扩展

请从原始制作工具重新导出，关闭 Draco 压缩。如果某个必需扩展不受支持，请选择不依赖该扩展且能保留外观的导出方式。仅从扩展列表中删除其名称，并不能让数据变得兼容。

结果文件变大

已经很紧凑的输入不一定还能缩小。如果目标应用支持 Meshopt，可尝试更小文件预设。如果纹理占主要体积，可测试 KTX2、WebP 及更低的纹理尺寸。请同时比较画质、兼容性和体积；不值得取舍时，保留原始文件。

纹理缺失或输出无法加载

先尝试保留原始纹理格式。如果可用，请检查目标应用对 KTX2 或 WebP 的支持。对于 Meshopt 输出，请确认解码器已配置。浏览器预览错误也可能源于设备限制；请在目标应用中测试原始模型，并参阅 兼容性指南.

模型外观发生变化

将三角面目标恢复为 100%，保留原始纹理并启用保留选项。分别检查几何、透明度、材质和动画。即使使用这些设置，优化仍可能改变模型。如果应用依赖不支持的元数据或精确结构，请保留原文件，或评估更细致的本地引擎选项。

处理停止或队列不可用

当前每次上传上限为 50 MB，输出上限为 100 MB，单次处理时限为 120 秒。声明的解码缓冲区限制为 256 MiB，压缩后的文件大小并不能直接代表内存需求。可减少或缩小纹理、关闭纹理转换，或在本地运行原生引擎。

队列满或处理进程不可用通常是暂时的，请稍后重试。遇到频率限制时，请等待后再上传。

下载已过期

结果在上传后 60 分钟过期，其中包括排队与处理时间。请及时从原任务页面下载。如果任务过期或访问令牌丢失，需要重新上传原始文件。本服务仅提供临时处理，不提供文件存储。