Files
wasm-bimanual-grasp/README.md
T

1.6 KiB

双臂操作沙盒

在浏览器中运行 MuJoCo WASM 双臂抓取仿真,支持物体拖动、可达性判断、末端手动控制、自动抓取与放置记录。

启动

克隆仓库后,在仓库目录运行:

python3 serve.py 8000
# 或 bash start.sh 8000
场景 地址
双 SO-101 http://127.0.0.1:8000/manip.html
P7 双臂与 SO-101 夹爪 http://127.0.0.1:8000/manip.html?scene=p7_bimanual

需要 Python 3、桌面 Chrome/Edge 和可访问 jsDelivr 的网络。服务器仅使用 Python 标准库。浏览器依赖固定为 three.js 0.170.0、MuJoCo WASM 3.12.0。

serve.py 提供 SharedArrayBuffer 所需的 COOP/COEP 响应头,不能直接替换为普通 python -m http.server。

操作

  • 拖动物体后,查看选臂、下爪方向与 IK 判定。
  • 自动抓取依次执行接近、预收爪口、下探、合爪与抬升,可随时中止。
  • 手动模式支持末端 XYZ 移动、朝向约束和夹爪开合。
  • 物体面板支持位置与重量调整;抓放记录显示抓取、放置和掉落结果。

验证与限制

历史场景检查中,可达性判定 6/6,抓取执行 3/5;立放易拉罐、罐子、玩偶成功,躺倒瓶子和玩具琴未成功。该记录不表示任意物体的成功率。浏览器后台标签会暂停或降低仿真刷新,执行中保持页面前台。

文件

manip.html 为页面入口,src/ 为 IK、自动抓取和渲染逻辑,scenes/ 为可直接加载的场景。

重新生成场景需要外部模型及额外 Python 依赖,见 场景导出。