zijunchiang/opendance-android
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 4 Wiki Activity

chore(contracts): 同步契约 skeleton-topology 0.2.0（内部动作标准与骨骼重绑定）

Browse Source
This commit is contained in:
opendance
2026-09-17 00:10:07 +08:00
parent 3f9c4c7658
commit 30883508a8
4 changed files with 73 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
contracts/model-formats.md
+8 -8
View File
@@ -2,7 +2,7 @@
## 1. 角色模型(models)
**v0.5.0 起模型主力格式为 VRM**：**所有上传的模型都转换为 VRM**（`MODEL_CONVERT_FORMAT`
**v0.5.0 起模型主力格式为 VRM**: **所有上传的模型都转换为 VRM**(`MODEL_CONVERT_FORMAT`
默认 `vrm`）；GLB 退为**转换中间产物**与 **humanoid 不达标时的回退交付**。
两个客户端（Godot `godot-vrm` / 管理端 `@pixiv/three-vrm`）都原生加载 VRM。
@@ -17,23 +17,23 @@
### 1.1 上传与转换策略
**v0.5.0 起的一律转换链路**：
**v0.5.0 起的一律转换链路**:
```
.vrm -> 直接导入（已是 VRM）
.glb / .gltf -> 包装为 VRM 1.0（写 VRMC_vrm）
.vrm -> 直接导入(已是 VRM)
.glb / .gltf -> 包装为 VRM 1.0(写 VRMC_vrm)
.pmx / .fbx -> assimp -> GLB -> 包装为 VRM 1.0
.zip -> 自动搜索包内模型，按上面三种处理
```
**humanoid 门槛（硬性）**：VRM 1.0 要求 humanoid 必需骨骼齐全。服务端判定规则：
**humanoid 门槛（硬性）**: VRM 1.0 要求 humanoid 必需骨骼齐全。服务端判定规则：
| 情况 | 交付 | `models.usable` | 是否进入客户端目录 |
|--|--|--|--|
| humanoid 必需骨齐全 | **VRM**（`format=vrm`，`vrmVersion=1.0`） | `true` | ✅ 可发布、可选用 |
| humanoid 不齐（如 MMD 日文骨名未重绑定） | 回退交付 **GLB**，`vrmVersion=null`，`conversionNote` 注明原因 | `false` | ❌ 不进入 `catalog/export` |
| humanoid 必需骨齐全 | **VRM**(`format=vrm`, `vrmVersion=1.0`) | `true` | ✅ 可发布、可选用 |
| humanoid 不齐（如 MMD 日文骨名未重绑定） | 回退交付 **GLB**, `vrmVersion=null`, `conversionNote` 注明原因 | `false` | ❌ 不进入 `catalog/export` |
即：**不达标模型仍可入库与审核，但标记为不可用、不进入已发布目录**；
即：**不达标模型仍可入库与审核，但标记为不可用、不进入已发布目录**;
待骨骼按 `skeleton-topology.md` 的标准重绑定成功后重新转换即变为可用。
**`.glb` / `.vrm` / `.gltf` 直接导入**（不重编码，零损失）；**`.pmx` / `.fbx` 由服务端转换**: