Files
vibemake/docs/assembly-axis-planning.txt
Jerry 1c837766cd feat: integrate robot assembly and simulation with resilient loading
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.
2026-10-30 18:38:39 +08:00

52 lines
4.1 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
装配轴向检查原型(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。
界面可展示“自动推荐方向”,不能声称“所有零件自动不穿模”。