Game Asset Vroid Body

---
name: game-asset-vroid-body
description: 通过参数化身体模板保留骨架与权重，并装配独立头部和已有发型，验证身体滑块、头发跟随和蒙皮，适用于 VRoid 风格角色的基础装配。
---

# 参数身体与头发装配

先确认允许使用的模板/发型、目标比例、独立头部和需保留的控制能力。优先使用插件原生 load_pack/load_preset/evaluate 与既有权重，避免重新生成人体后再猜骨架。

## 执行

1. 读模板 pack 的单位、骨名、rest pose 和参数范围，通过插件生成身体、手、脚及骨架；保存完整 preset。示例参数只是测试角色的设定，不能解释为现实人物测量。
2. 独立拟合头转回模板原生坐标，明确缩放、偏移和连接方式。头部滑块通常不会再影响该独立头，需在交付中说明可调边界。
3. 已有 VRM 按材质面/语义分离发片、头皮和旧身体，不只按对象名选取；Body 对象可能混有后脑头皮。读取默认变体，防止多表情叠画。
4. 被头发覆盖的头骨可限定区域 Shrinkwrap 到发壳内，保护脸和耳。先检查穿出的额角，再检查过度缩进、发根和耳宽。
5. 头和发型挂到目标头骨，先用 Child Of/现成约束证明刚性跟随；若需物理，重新映射发骨链、权重和碰撞组，不能把整件跟随说成发梢弹性已迁移。
6. 使用复制场景或独立后台进程做功能验证：改变肩宽滑块、转上臂与头骨，量身体变形、发型跟随和顶点权重和。测试姿势不覆盖交付静止姿势。

## 配套代码

包内 `assets/workspace/scripts/vroid-body-assemble.py` 保存了源项目的研究实现，配套 `config/vroid-body-preset.json` 是示例。先按 [implementation.md](references/implementation.md) 准备模板、授权模型、拟合 mesh/preset 与输入场景；脚本内的层名、对象名及装配坐标需按新角色适配。

模板与用户模型不附带。公开参数插件源码和研究模板模型是不同资源；原项目使用的 pack 标注个人学习研究，不视为可自由商用的模型来源。

## 验收与边界

交付四视图、头部各角度、变换记录、preset 和功能检查。顶点权重和接近 1 只是必要条件，仍需看肩、肘和颈部变形。大幅头尺寸变化后重新贴合发型。

源项目证明过身体滑块、骨骼变形和头发刚性跟随；并未完成普通服装、头发弹簧、面部表情迁移或引擎交付。后续衣物应经过独立的换装与碰撞流程，不把研究装配视为完成角色。

资源获取见 [sources.md](references/sources.md)，附带代码及适配边界见 [implementation.md](references/implementation.md)。