42 lines
1.4 KiB
Markdown
42 lines
1.4 KiB
Markdown
# T-WIN-005 VRM 模型加载
|
||
|
||
- **状态**：done
|
||
- **依赖**：T-WIN-001
|
||
|
||
## 目标
|
||
|
||
加载 VRM 模型，识别 VRM 版本，定位 Skeleton3D 并映射 humanoid 骨骼。
|
||
|
||
## load
|
||
|
||
```
|
||
DSH.md
|
||
contracts/model-formats.md # 锚点：§1 角色模型
|
||
contracts/data-models.md # 锚点：§4.1 VRM 优先规则
|
||
src/model/vrm_loader.gd
|
||
src/model/humanoid_map.gd
|
||
```
|
||
|
||
## 选型变更
|
||
|
||
文档原选型 `godot-vrm`（V-Sekai）GDExtension **不发布任何预编译产物**，
|
||
需用 godot-cpp 本地编译原生库，会破坏「Linux 导出 Windows exe」的验收路径。
|
||
改用 **Godot 内置 GLTFDocument**：VRM 即 glTF 2.0 容器，实测可完整解析
|
||
154 骨骼的 VRoid 模型，且 `GLTFState.json` 可直接读取 VRM 扩展判定版本。
|
||
|
||
## 骨骼名映射
|
||
|
||
`HumanoidMap` 覆盖 VRoid / VRM 0.x / Mixamo 三类命名，归一化后精确比较：
|
||
|
||
- 剥离前缀 `jbip` / `mixamorig` / `bip01`（**归一化之后**的形态）
|
||
- 生成 compact（left→l）与 expanded（l→left）两种变体比较
|
||
- **故意不剥离 `J_Aim_` / `J_Roll_` / `J_Sec_`**：VRoid 用它们标记扭转辅助骨，
|
||
剥离后 `J_Aim_L_UpperLeg` 会与真正的 `J_Bip_L_UpperLeg` 撞名
|
||
|
||
## 验收
|
||
|
||
`tests/test_vrm_loader.gd`：
|
||
- 三类命名规范的识别（含辅助骨不遮蔽真骨的回归用例）
|
||
- 真实 VRM：154 骨骼 / 3 网格 / VRM 1.0，**humanoid 覆盖率 100%**
|
||
- 缺失文件、普通 glTF 不误判
|