3D 世界里的角色来源很杂：有人用 Mixamo 烘的动画，有人用 Ready Player Me 捏的头像，有人从 VRoid 导出模型，还有人做带 RootMotion 的位移动画。每一条来源单独跑都正常，放进同一个世界就开始出事——T-pose 站桩、四肢扭曲、原地飘移、方向不对。问题集中爆在骨骼上，因为每条工具链的骨架命名、坐标轴、动画约定都不一样。这篇讲一个"翻译层"的做法：不做逐模型人工修，在加载管线里自动归一，每一层带安全门——出了问题宁可拒绝并告警，不做静默的破坏性"修复"。

一、问题为什么集中在骨骼

角色模型进世界能不能动，取决于动画数据能不能对上骨架。四条来源的差异恰好都落在这里：

• 骨架命名不同。同一条手臂骨骼，各家工具链叫法不一样，动画轨道找不到目标就落空。
• 坐标轴约定不同。Blender 是 Z-up，导出 GLB 转成 Y-up 后，层级里常留下容器旋转残留——模型看起来歪着，或者动画方向不对。
• 动画烘焙约定不同。补偿量写进动画还是写在骨架 rest pose 里，各家的选择不一样，直接混用就出现"姿势差一点"到"整个人拧着"之间各种程度的错位。
• 导出工具复制骨骼链。有些导出流程会生成带 _N 后缀的副本骨骼链，主链和副本同时存在，动画绑到副本上、蒙皮挂在主链上，动起来就是两张皮。

二、翻译层的四层处理

1. 坐标轴与容器旋转归一

animUpAxisFixer 处理轴向声明，容器旋转下沉归一处理 Blender Z-up 导出残留——模型落地时不再歪着，不需要作者回去改源文件重新导出。

2. 动画约定补偿

animConventionCompensator 对动画约定差异做自动补偿：把该下沉进骨架 rest pose 的旋转量归位，让不同烘焙约定的动画在同一个世界里姿势一致。验收里有一组 51 骨的模型（Kipfel 类），逐模型补偿 10/10 通过。

3. 重复骨骼链换绑

duplicateBoneChainFixer 找出带 _N 后缀的副本链，把动画轨道换绑回主链，并同步逆绑定矩阵（IBM）。这一步带世界矩阵门控——只有确认主副链的世界矩阵关系成立时才执行换绑，避免在层级关系不明的模型上越修越歪。

4. 骨骼命名识别用词边界匹配

识别骨骼命名时用词边界正则，避免子串误匹配——名字里恰好包含相似字样的对象不会被误当成骨骼处理。

三、每层都有安全门

自动归一的风险是"好心修坏"。所以每一层都允许说"不"：

• 补偿之后 rest pose 仍然异常 → 拒绝补偿并告警，模型按原始状态加载；
• 换绑之后 IBM 反而变差 → 立即回滚，保持换绑前的状态。

原则是：宁可保持原样、把诊断报告递出去，也不做静默的破坏性"修复"。修不好的模型至少还能站对地方，被修坏的模型什么都干不了。

四、_diag：把判断交给脚本

每一层都有 _diag 诊断接口，既能在加载后自检，也能接进自动化验收——模型过了哪层、哪层拒绝了补偿、为什么拒绝，报告里都有。人不用打开建模软件逐个排查，跑一遍诊断就知道哪个模型、坏在哪一层。

五、指标

轨道命中的含义：动画数据里的轨道能在目标骨架上找到对应骨骼。312/318 那一批里没命中的 6 条，属于个别模型自带的非标准轨道——按安全门原则，报出来、不硬凑。

六、边界

• 翻译层处理的是约定差异，不是内容错误。骨骼真的缺、动画数据真的坏，它只能报出来，修不了——源文件的问题要回源头解决。
• 它依赖建模正确的源文件：蒙皮本来就不对、权重本来就崩的模型，归一管线不负责重建。
• 跨世界联邦场景下，用户角色带着骨骼映射与动画重定向迁移，走的是同一条管线的延伸——世界搬走，角色不散架。

常见问题

Q：玩家自己上传的角色也能走这条管线吗？

A：能。上传即进入同一条加载管线，归一与诊断自动执行，不需要上传者懂骨骼。

Q：会不会把作者做好的模型修坏？

A：每一层都有安全门：补偿后异常就拒绝，换绑后变差就回滚，还有 _diag 报告可查。"修复"是可拒绝、可回滚、可审计的，不是静默改写。

Q：四条来源之外的工具链呢？

A：其他工具链导出的模型落在同一条归一管线上处理；未覆盖的约定差异会被诊断接口报出来，而不是带病上岗。适配面按实际遇到的来源逐步扩展。

源码与仓库

三个地址内容一致，国内访问用前两个更快。仓库里有部署说明与验收脚本。

• Gitee（国内访问更快）：https://gitee.com/miduoxinxijeji/miduo.git
• GitCode（国内镜像）：https://gitcode.com/qq_35054471/virtual-world
• GitHub：https://github.com/miduo100/3d-virtual-world

关于创世Genesis

创世Genesis是一套基于Three.js+WebGL构建的自部署3D虚拟世界系统，帮助个人与企业搭建属于自己的3D空间。浏览器直接访问，PC和手机双端兼容，支持多人在线、联邦传送、商铺系统，并支持Agent接入——AI能以具身角色进入你部署的世界。数据运行在你自己的服务器上，不经过第三方平台——让每个世界都真正属于它的主人。

想让各种来源的角色模型进你的世界就能动？ 创世Genesis（创世虚拟世界CRM系统）是一套部署在你自己服务器上的 Three.js 3D 虚拟世界基底——骨骼与动画兼容这套"翻译层"已经铺在资产管线里，你写上面那一层就行。官网（搜「创世虚拟世界CRM」即可找到）有可以走一圈的演示世界。

关于名字：本文说的创世Genesis，即创世虚拟世界CRM系统，两者是同一个自部署 3D 虚拟世界产品。若你通过「创世Genesis」没搜到我们，直接搜「创世虚拟世界CRM」即可。