这篇内容提供什么
本文提供一组可直接复制给 AI 的“在线工具生成型”提示词（Prompts），目标是让 AI 产出一个可运行、可构建、可部署的在线工具：上传 USDZ 文件后，自动完成结构检查、资源清单导出、异常提示，并生成可下载的报告（JSON/Markdown）。
适用场景
- 3D 资源交付前：快速核对 USDZ 包内文件结构是否规范、贴图/材质资源是否缺失。
- 团队协作：把检查结果固化为报告，便于提交到工单/评审。
- 合规与安全：对可疑文件（超大纹理、异常后缀、重复命名、路径穿越风险）给出告警。
Prompt 01：生成 USDZ 结构检查与资源清单导出在线工具（完整项目）
你是一名资深全栈工程师。请从零生成一个“USDZ 模型结构检查与资源清单导出”的在线工具项目（必须可运行/可构建/可部署），并一次性给出：
【交付物（必须全部输出）】
1) 完整项目源码：逐文件给出代码（不要省略关键文件），并在开头提供文件树。
2) 本地运行命令：npm/pnpm/yarn 任意一种，包含安装与启动。
3) Docker 部署：提供 Dockerfile + 可选 docker-compose.yml，并说明如何构建与运行。
4) 使用说明：页面如何操作、报告如何下载、每个告警含义。
5) 测试用例或 QA checklist：至少 15 条，覆盖正常/异常/边界。
【产品形态】
- Web 端单页应用（推荐 Vite + React + Type ；也可 Next.js，但必须说明 SSR/静态部署策略）。
- 支持拖拽上传或选择文件上传（仅本地解析，不上传到服务器；如你设计为后端解析，必须提供隐私提示与开关）。
- 解析结果以“检查面板 + 资源表格 + 报告预览”三块展示。
- 报告支持导出：report.json 与 report.md。
【核心功能（必须实现）】
A. USDZ 解包与清单
- 将 .usdz 视为 zip 容器，用 JSZip（或等价库）解析。
- 输出文件列表（路径、大小、后缀、hash 可选）、总大小、文件数、最大单文件大小。
B. 结构与命名检查（给出可配置规则）
- 检测是否存在重复文件名（不含路径/含路径两种维度）。
- 检测是否存在可疑路径（..、绝对路径、反斜杠）。
- 检测是否存在非常规后缀或可执行内容（.exe/.bat/.js 等）并标红告警。
- 检测是否存在超大纹理（例如 > 4096x4096 或单文件 > 20MB；若无法读尺寸，至少按大小阈值告警）。
C. 依赖扫描（尽力而为，但必须稳定可用）
- 对 .usda/.usd/.mtl/.obj 等“可文本解析”的文件，扫描可能的贴图引用（例如 .png/.jpg/.jpeg/.tga/.exr）。
- 输出：引用到的贴图路径列表、是否存在于包内、缺失列表。
- 对二进制 .usdc 可提示“未做深度解析”，但仍要完成清单与基础检查。
D. 结果与可视化
- 告警分级：info/warn/error。
- 表格可筛选：只看缺失资源/只看告警文件/按后缀过滤。
- 支持复制一键摘要（适合贴到工单）：包括总览、错误数、缺失资源数、建议。
【工程与质量要求】
- 代码需要可读、模块化：parser、rules、ui、report 四个目录（或等价）。
- 必须提供类型定义（Type interface/type）。
- 不能使用任何“生成图片/出图/渲染图/海报/插画”相关能力；重点是检查与报告导出。
【输出格式】
- 先给文件树（tree）。
- 再按文件路径逐个输出代码块。
- 最后给运行命令、部署说明、测试/QA。
Prompt 02：加强版（可选）— 加入后端 API 与任务队列（仍可本地解析）
在 Prompt 01 的基础上，新增一个可选的 Node.js 后端（Express/Fastify 任选）：
- 提供 /api/report/validate：接收 report.json，做二次校验与规则版本标注。
- 提供 /api/report/export：把 report.md 转成可下载文件（设置正确的 Content-Type）。
- 前端必须可以在“纯前端模式 / 前后端模式”间切换（用环境变量控制），并写清楚隐私与数据流。
落地建议
- 先用 Prompt 01 生成 MVP 并跑通“上传 - 解析 - 告警 - 导出”闭环，再逐步补规则。
- 把规则阈值（大小、后缀黑名单等）抽到 config，方便不同团队复用。
- 报告字段尽量稳定（schema 固化），便于后续接入 CI 或工单系统。
