1c837766cd
Add backend-driven assembly and simulation experiences, MAKE branding, mobile rendering budgets and desktop-only CAD/PCB routes. Improve logo loading progress, document image recovery and URDF request handling; include dev packaging and regression coverage.
52 lines
4.1 KiB
Plaintext
52 lines
4.1 KiB
Plaintext
装配轴向检查原型(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。
|
||
界面可展示“自动推荐方向”,不能声称“所有零件自动不穿模”。
|