# 几何问题排查清单

## 先问自己

1. 这是虚拟物体还是真实物体？
2. 路径类型是 `Ground / Hoisting / Rail` 哪一种？
3. 错的是：
   - 旋转轴
   - 起点位置
   - 逐帧位置
   - 通行空间
   - 终点诊断

## 日志优先看什么

### 平面路径

- `[移动到起点] 路径方向yaw`
- `[动画姿态入口] ... 目标姿态`
- `[模型增量姿态] ... 当前/目标/增量`

### Rail

- `[移动到起点] Rail旋转姿态`
- `RailPathPoseHelper` 相关诊断

### 虚拟物体

- `[虚拟物体姿态] 应用前`
- `[虚拟物体姿态] 应用后`
- 关注 `BoundingBox.Center` 是否符合资源原点预期

## 需要同步检查的链

出现几何问题时，至少对齐这几条：

1. 起点落位
2. 逐帧位置
3. 通行空间
4. 终点诊断

如果其中一条使用的是“原始高度”，另一条使用的是“旋转后法线尺寸”，就很容易出现看起来互相矛盾的问题。

## 测试建议

至少补一个最短链测试：

- `YUp` 或 `ZUp`
- 指定单一路径类型
- 指定单个旋转轴
- 验证尺寸或姿态的关键不变量

能测数学层，就不要先靠现场猜。
