展开本页目录
开始前准备什么
- 可编辑作者网格与glTF JSON；使用目标查看器时记录版本及扩展支持。
- 作者网格不是TRELLIS.2或Magnific已经生成的结果；目标推理保持not_run。
- 列外部依赖
- 对齐目录结构
- 检查大小写与编码
- 排除外部缓存
- 生成文件清单
- 读取网络与模型
- 交付自包含资料
1. 列外部依赖
打开作者.gltf，逐项列buffers.uri与images.uri。记录相对路径和实际文件名，正常联网预览不代表资源已在本地。
2. 对齐目录结构
保持model.gltf、mesh.bin、textures/basecolor.png的相对层级。不要把图片扔到ZIP根目录却保留旧引用。
3. 检查大小写与编码
把纹理名固定为小写ASCII，比较BaseColor.png与basecolor.png。macOS本地偶尔可打开不证明Linux大小写敏感路径也可用。
4. 排除外部缓存
把作者资源包解到新目录，经本地HTTP独立加载并断开外部资源依赖。不要靠原工作目录缓存补齐漏图。
5. 生成文件清单
逐文件计算字节数与SHA256，把清单放到ZIP内。完整清单只是传输核验，不证明贴图本身符合商品事实。
6. 读取网络与模型
检查请求没有404，材质纹理在目标查看器真的出现；再核对JSON路径和zip条目。GLB如仍带外部资源也需同样检查。
7. 交付自包含资料
交付离线可用包和资源清单，删除主机绝对路径。作者包不是已经从云端下载的生成结果。
下载本课材料并开始操作
练习包包含本课的具体输入、可编辑数据、正反样例与七步说明。index.html 可离线查看原件和验收参考，actual-results.csv 用于记录你实际操作后的结果。
怎样确认已经完成
- 原始参数、正确设置与错误对照来源一致，实际文件重新读取。
- 作者源和目标云端结果明确标记，未执行不填写生成ID或成功效果。
- 按本课具体数值或字段核对，不用通用流程图代替操作图。
常见问题
glTF 打包 丢贴图 相对路径怎么检查？
从 buffers.uri 和 images.uri 列出依赖，保持 .gltf、.bin、textures 的相对层级并核对大小写。清缓存离线重载再压 ZIP，附文件清单；macOS 能打开不能证明 Linux 路径大小写正确。
AI模型离线交付丢贴图，直接重新生成有用吗？
把作者资源包解到新目录，经本地HTTP独立加载并断开外部资源依赖。不要靠原工作目录缓存补齐漏图。 先隔离参数与输入，再决定是否需要目标模型重新生成，不能把显示链路错误都归为AI生成失败。