装配轴向检查原型（2026-10-29）

目的
保持步骤顺序、零件最终位置/朝向、原始 GLB 材质和颜色，只为普通刚性零件推荐进入方向。
计算在本地 Node 程序完成，输出仍使用现有 installOffset；手机和社区播放器不加载 BVH、不实时找路。
本原型不是已完成的后台编辑器功能，也不是物理装配无碰撞的证明。

运行
npm run plan:assembly -- --manifest /绝对路径/步骤.json --assets /绝对路径/零件目录 --out /绝对路径/新的步骤.json
npm run test:assembly-planner
输出必须使用新文件名；不会覆盖输入 JSON、GLB 或已上传后台的绑定。
工具为 three-mesh-bvh 0.9.17（MIT）和 Three 0.160.1；仅作为开发依赖。
库资料：https://github.com/gkjohnson/three-mesh-bvh
API：https://github.com/gkjohnson/three-mesh-bvh/blob/master/API.md

处理规则
1. 使用实际 GLB 三角网格建立 BVH，包围盒仅用于粗筛。
2. 每一步只检查此前已安装的零件。当前步骤内多个普通零件以同一偏移整体移动，避免舵机/轴承子零件散开。
3. 检查场景 ±X/±Y/±Z 和当前零件局部 ±X/±Y/±Z。场景 Y 朝上；CAD 的 Z 朝上不一定等于显示坐标。写回前通过 displayQuaternion 换回 JSON 的坐标系。
4. 从已安装模型包围盒外出发，采用网格最短距离的保守推进；单次位移小于当前间距，不用固定几帧的采样跳过薄壁。
5. 对通过检查的路径写回 installOffset。原始步骤、position、quaternion、scale、installation、files 完全保留。
6. 螺钉保持原轴向，不为了绕开外壳而侧着穿进螺孔。当前未检查螺纹旋转和扳手扫掠。

结果语义
foundation：第一个基础件，直接显示。
clear-to-seating：到最终位置前 0.15 mm 的直线路径通过检查；最后 0.15 mm 为未认证的贴合区间，不能把这个结果称为“全过程绝对无碰撞”。
fixed-fastener-axis：保留螺丝原轴向，未做旋转/工具避障。
needs-review：候选方向受阻、接触、超时或无法确定。保留原来的偏移，所以输出中的这些步骤仍可能穿模；需要人工确认，不能自动发布为通过版本。
blocked-or-touching：候选方向接近或碰到其他网格。表面接触与实体交叠不能仅靠该状态区分。

当前范围与限制
支持平铺的静态刚性 GLB；有移动父子层级、骨骼、形变或非三角形图元时拒绝直接规划。
尚不支持先抬高再侧移的折线路径、旋转插入、柔性鞋底变形、重新排序、接触配合规则或工具碰撞。
几何本身在最终位置相交时，仅改变进入方向不能消除最终相交。
计算预算耗尽会返回待确认，不会默认认为安全。
所有几何碰撞计算使用副本，不改 GLB 原文件、材质或颜色。

本次左腿验证
输入：小鸭子-左腿-按编号装配-52步.json，72 个 GLB 实例。
结果：基础件 1 步；3 步普通组件找到候选方向；12 步普通零件待确认；36 步螺丝保留原轴向。
候选方向对应 1-19、1-28、1-44（舵机组件）。
1-2 脚板：最终位置 foot_left 与 sole_left 的三角面相交。向上偏移 10 mm 时无相交，偏移 9 mm、5 mm、1 mm、0.15 mm、0 mm 时均检测到相交。
这里的 9 mm 是动画位置距终点的位移，不是测得的穿透深度，也不是判断实物装不进去的结论。
需要确认鞋底是否设计为柔性接触、GLB 网格是否有余量、最终姿态是否准确，再明确该步骤允许的接触范围。
报告和候选 JSON：/Users/jerry/Downloads/小鸭子-左腿轴向避让-20261029/
旧的后台步骤绑定未修改。

接后台时的推荐流程
上传 GLB 和排序 → 点击“检查安装方向” → 后台任务/Worker 计算 → 标出通过候选和待确认步骤 → 3D 预览并允许人工选轴/距离 → 保存 JSON。
有 needs-review 的步骤不自动标成已检查通过。多段路线将来需扩展路径字段并让播放器支持，当前只写已有 installOffset。
界面可展示“自动推荐方向”，不能声称“所有零件自动不穿模”。
