工具定位
这是一条用于生成“在线 3D 模型检查与修复报告工具”的 AI 提示词（Prompts）。用户上传 STL/OBJ 后，系统会进行网格质量诊断（如非流形、法线问题、重复面、孔洞、面片退化等），并输出可下载的诊断报告；在可控范围内提供一键修复（不追求艺术级重拓扑，重点是工程可用与可解释的修复结果）。
交付物与覆盖场景（硬要求）
交付物：完整可运行项目源码（前端+后端）+清晰文件树+本地运行命令+生产构建命令+部署说明（Docker/Render/Vercel 任一可选）+最少 6 条测试用例或 QA checklist。
覆盖场景：3D 打印前检查 STL；游戏/AR 资产导入前检查 OBJ；供应链交付资产验收（输出统一报告）；批量模型质检（多文件队列处理）。
Prompt（直接复制给 AI）
角色：你是资深全栈工程师（Type /React + Node.js），擅长 3D 数据处理与可视化。
目标：生成一个可部署的在线工具：上传 STL/OBJ -> 自动诊断网格缺陷 -> 生成 HTML/JSON/PDF(可选) 报告 -> 提供“安全的一键修复”并可下载修复后的模型（STL/OBJ）。禁止任何“生成渲染图/海报/插画/出图”导向；只处理用户上传的现有模型数据。
技术栈约束：
- 前端：Vite + React + Type ；使用 three.js 进行预览与基本测量（包围盒尺寸、三角面数、顶点数）。
- 后端：Node.js + Type （Express/Fastify 任一）；提供文件上传接口、分析接口、修复接口；输出报告接口。
- 3D 处理：优先使用 JS/TS 可用库（three.js 解析 STL/OBJ）；允许引入轻量 WASM/CLI（需在 Dockerfile 内安装并在 README 说明），但必须提供纯 JS 的兜底分析路径。
- 数据存储：默认本地临时目录；提供开关支持 S3 兼容存储（可选）。
功能清单（必须全部实现）：
- 上传：单文件与批量上传（队列）
- 诊断项：非流形边/顶点计数、法线翻转比例、重复面/重复顶点估计、退化三角形计数、孔洞/开边界估计、尺寸与单位提示
- 预览：模型旋转缩放、线框切换、法线可视化开关、缺陷高亮（至少实现“退化面高亮”或“边界边高亮”一种）
- 报告：生成一份可下载报告（HTML + JSON 两种格式必须有），包含诊断摘要、阈值解释、修复建议、修复前后对比指标
- 修复：提供一键修复（做以下至少三项）：合并近似重复顶点（阈值可调）、移除退化面、重新计算法线、尝试封闭小孔洞（若实现不了则必须在 UI 明示原因并给出替代建议）
- 安全：限制文件大小与并发；对上传文件做类型与结构校验；错误信息可读
输出要求（必须按此顺序给出）：
- 项目总览（架构图用文字描述即可）
- 完整文件树（逐层列出）
- 逐文件给出完整代码（不要省略）
- 本地运行：安装、启动、访问地址、示例操作步骤
- 部署：提供 Dockerfile 与 docker-compose.yml，并给出一键部署命令
- 测试：提供最少 6 条可执行测试（Jest/Vitest 任一）或 QA checklist（必须覆盖：上传失败、异常模型、批量队列、报告下载、修复前后指标、XSS/文件名注入）
- 验收标准：列出“通过/失败”判定
提示：不要使用任何需要付费 API 的服务；不要引导生成图片；不要写与本工具无关的通用教程；所有文案与按钮均使用中文。
建议的验收口径
1) 任意 STL/OBJ 上传后 5 秒内得到诊断摘要（大模型生成代码不在此限制内，指工具运行时性能）；2) 报告可下载且内容含关键指标；3) 修复后模型可再次被工具打开并生成对比报告；4) 出错时页面给出明确原因与可执行的解决建议。
常见问题与边界说明
网格“完美修复/自动重拓扑”通常需要专业 DCC 工具与复杂算法。本工具的定位是在线质检与可解释的轻量修复：提升可用性、减少明显缺陷、把问题可视化并形成报告，便于在 Blender/MeshLab/打印切片软件中进一步处理。
