3D预览 GLTF/GLB 纹理与材质引用完整性审计与修复打包 AI 提示词 (Prompts)

你将得到什么

这是一条可直接复用的 AI 提示词（Prompts）。把它丢给任意代码生成型 AI（如能写完整项目的模型），它会生成一个“在线 3D 预览审计工具”完整可运行项目：支持上传 GLTF/GLB，自动扫描纹理/材质/外部资源引用，输出问题清单，并提供一键修复与打包下载。

适用场景

用于上线前自检：上传到资产库/电商/AR 展示/Three.js 预览页之前，先检查贴图缺失、相对路径错误、大小写不一致、URI 编码问题、重复资源、异常采样器参数等；也适合团队内批量验收与交付。

交付物与验收标准

交付物必须包含：完整项目源码与文件树、安装与启动命令、Docker 部署说明、至少一套可执行测试（或最小化集成测试脚本）、以及可操作的 QA checklist。验收标准：在本地或容器中运行后，上传示例 glb/gltf 能生成审计报告（JSON + 人类可读页面），并能导出“修复后资源包”。

Prompt（直接复制给 AI）

你是一名资深全栈工程师 + 3D 资产管线工程师。请为我生成一个可运行的“GLTF/GLB 纹理与材质引用完整性审计与修复打包”在线工具，要求一次性交付完整项目代码，而不是伪代码。

【目标】
- 用户在浏览器上传 .gltf/.glb（以及 .gltf 可能引用的 bin、png/jpg/webp/ktx2 等）。
- 工具解析模型，扫描并列出所有外部资源引用与材质/纹理配置；输出审计报告。
- 提供“修复建议”与“自动修复（可选）”：
  1) 统一相对路径（去掉多余 ./、处理 URL 编码、规范分隔符）；
  2) 检测大小写不一致（Windows 可读但线上 404 的那种）并提示；
  3) 检测缺失贴图并标红；
  4) 检测重复贴图（按内容 hash）并提示可去重；
  5) 给出纹理尺寸/格式统计，提示是否需要压缩（但不要生成任何“渲染图/出图/海报/插画”内容）。
- 支持“导出修复包”：将模型与所有引用资源打包为 zip，保证解压后相对引用可用。

【硬性约束】
- 禁止任何“生成图片/出图/配图/渲染图/海报/插画”导向，不写 Midjourney/SD 等。
- 允许做预览、检查、抽帧（从已有视频/序列中提取现有帧不算生成），3D 预览只做模型检查与报告。
- 必须给出：
  - 完整文件树（tree）
  - 关键文件完整源码（不要省略）
  - 运行命令（npm/pnpm 任选其一，写清版本要求）
  - Dockerfile + 可选 docker-compose.yml
  - 测试用例（至少覆盖：上传文件、解析成功、报告结构校验）
  - QA checklist（手工测试步骤）

【技术选型建议（可调整但要自洽）】
- 前端：Vite + React + Type 
- 解析：three.js（GLTFLoader）或 @gltf-transform/core（如更适合审计与重写引用）
- 打包：JSZip
- 报告：前端页面 + 导出 report.json

【功能细节】
1) 上传
- 支持拖拽上传。
- gltf + 依赖文件：允许用户一次性选择多文件；也支持上传一个 zip。
- glb：单文件上传。

2) 解析与审计
- 输出资源清单：images、textures、materials、buffers、extensionsUsed。
- 生成问题列表：missing_files、path_normalization、case_mismatch（在浏览器侧可通过对比上传文件名集合进行近似检测）、duplicate_assets（hash）。
- 生成统计：贴图格式分布、尺寸分布、总资源体积。

3) 修复与导出
- 若输入为 .gltf + 资源：允许重写 URI 引用为规范相对路径，并把资源复制到 /assets 下；导出新的 gltf + assets。
- 若输入为 glb：允许导出“解包版”（gltf + 资源）并保持引用正确。
- 导出 zip：包含修复后的模型、资源、report.json，以及一份 README（说明修复做了什么）。

4) 项目工程化
- 代码要能直接跑起来。
- 给出最小可用 UI：上传区、报告区（表格/列表）、下载按钮、日志区。
- 加一个 sample 目录说明如何放测试样例（不需要真的提供二进制大文件）。

【输出格式】
- 先输出文件树
- 再逐文件输出源码（按文件树顺序）
- 最后输出：运行命令、Docker 命令、测试命令、QA checklist