docs(win): 任务说明、DSH 约束与交付文档

tasks/005-vrm-loader.md

@@ -0,0 +1,41 @@
+# 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 不误判