模型交付规范

车间危险工序仿真培训系统 · 面向建模方

最后更新：2026-06-01

本系统需要的不是"能看的整机模型"，而是 可拆解、可爆炸、可动画 的结构化模型。 请严格按本规范导出，否则核心培训功能（设备分解 / 爆炸图 / 工艺动画）无法实现。

1. 当前交付的问题（必须修正）

已收到的 7 个 GLB（02 / 06 / 09 / 10 / 11 / 12 / 3821）经核验，全部是整机合并成单个 mesh：

检查项	现状	要求
部件拆分	✗ 整机 1 个 mesh / 1 个 primitive	每个可拆部件独立节点
节点命名	✗ 名称是 02 / 03 等	part_<语义>（见 §3）
爆炸方向	✗ 无	节点 extras.explodeDir（见 §4）
工作动画	✗ 0 个 AnimationClip	内置 AnimationClip（见 §5）
轻量化	✗ 无压缩（单文件最大 152MB / 509 万面）	Draco + 减面（见 §6）
UV / 贴图	✗ 无 UV	如需贴图则提供 UV + KTX2

2. 坐标 / 单位 / 朝向

• 单位：米（meter）。1 个单位 = 1 米。
• Y 轴向上（glTF 标准）。
• 模型原点：置于设备底面几何中心（模型"站"在原点平面上，落地 y=0）。
• 设备正面朝 +Z。

3. 节点结构与命名

层级示意（一台设备一个 GLB）：

device_<设备语义名>            // 顶层根节点，整机根
├── part_base                 // 底座
├── part_hydraulic_cylinder   // 液压缸
├── part_slider               // 滑块
├── part_die_upper            // 上模
├── part_die_lower            // 下模
└── part_guard                // 安全防护罩

• 可拆部件节点：part_ + 小写英文语义名，下划线分词。例：part_hydraulic_cylinder。
• 顶层根节点：device_ + 设备语义名。例：device_hydraulic_press。
• 一个部件 = 一个节点 = 一份独立几何，禁止把多个部件 weld / merge 成一个 mesh。
• 同名部件多份时加序号：part_bolt_01、part_bolt_02。
• 名称只用 [a-z0-9_]，不要中文、空格、特殊字符。

4. 爆炸图元数据（每个 part 节点的 extras）

在每个 part_* 节点的 glTF extras 写入爆炸参数：

"extras": {
  "explodeDir":  [0, 1, 0],   // 必填：爆炸方向单位向量（设备本地坐标）
  "explodeDist": 0.5,         // 选填：建议爆炸距离（米）；缺省由系统按包围盒推算
  "partLabel":   "液压缸",     // 选填：中文显示名（拆解面板用）
  "partDesc":    "提供冲压动力" // 选填：部件说明
}

• explodeDir：该部件爆炸时沿哪个方向移开（如顶盖 [0,1,0]、侧门 [1,0,0]）。必填。
• Blender 导出：物体 → Object Properties → Custom Properties 添加，键名与上表一致， 导出 glTF 时勾选 "Include → Custom Properties"。

5. 工作动画（内置 AnimationClip）

如该设备有工作过程动画（如冲压下行、机械臂装卸），请在模型内置 AnimationClip：

• 命名：anim_step<N>_<语义>，N 从 1 起。例：anim_step1_approach、anim_step2_press、anim_step3_return。
• 每个 clip 对应一个工步，时间轴以秒为单位，从 0 开始。
• 动画驱动部件的 TRS（位移 / 旋转），不要烘焙成形变顶点动画。
• 若不便内置动画，可只交付分件模型 + 在交付说明里用文字描述各部件运动方式，由系统侧程序化驱动。

6. 轻量化（必做）

• 几何：Draco 压缩（glTF 导出时启用）。
• 减面：单设备总面数建议 < 50 万三角面；CAD 转网格请去除冗余细分。
• 纹理（如有）：KTX2（Basis）压缩，单张 ≤ 2K。
• 参考：本项目已能把 152MB / 509 万面的整机压到 5MB / 200 万面；分件 + 合理减面后单设备应远小于此。

7. 文件交付

• 格式：.glb（二进制单文件），每台设备一个文件。
• 命名：device_<设备语义名>.glb，例 device_hydraulic_press.glb。
• 随附一份《交付说明》：设备中文名、各 part_ 对应的中文部件名、危险点位置说明、工步顺序。

8. 验收清单（交付前自检）

• 每个可拆部件是独立 part_* 节点，未被合并
• 顶层根节点 device_*
• 每个 part_* 有 extras.explodeDir
• 命名只含 [a-z0-9_]
• 单位为米、Y 向上、原点在底面中心、落地 y=0
• 已启用 Draco，单设备 < 50 万面
• （如有动画）AnimationClip 命名 anim_step<N>_<语义>，单位秒
• 导出已勾选 Include Custom Properties（extras 不丢）