跳到正文
已核查原始资料

MicroDuck 本地整机仿真:没有实体也能运行真实 robotd

把官方 robotd、robotctl 和 50 Hz 控制循环接到 MuJoCo 机体,完成启动、健康检查、短距离驱动与实时率排查,并说明哪些硬件问题无法验证。

官方 duck-sim 不是网页动作演示,而是让真实守护进程控制 MuJoCo 机体。策略、IPC、健康检查和控制循环可在电脑上联调;电机总线、蓝牙、相机 ISP、NPU、硬件编码器和供电仍必须回到实体检查。

先判断是否需要这套仿真

只想体验动作,用浏览器仿真最快;要改 robotd、robotctl、策略加载或客户端通信,再使用本页的守护进程仿真。它运行真实控制程序,只把实体电机和传感器接口替换为 MuJoCo 通道。

固定两个仓库再开始

把 microduck 与 microduck_rl 放在相邻目录,或者用 DUCK_SIM_RL 指定后者的绝对路径。RL 仓库需要先生成包含 duck-body 与 ONNX Runtime 的虚拟环境。

可复制示例
git clone https://github.com/pollen-robotics/microduck.git
git -C microduck checkout --detach e90389492bd4da42f60da343983e50cecd43b54b
git clone https://github.com/pollen-robotics/microduck_rl.git
git -C microduck_rl checkout --detach cb70b792312d559a4da09064d92009079671815f
cd microduck_rl
uv sync

上述版本是本站 2026-09-23 核查快照。不要在已有改动的目录里强行切换提交;为复现新建独立目录更容易保留证据。

启动一只鸭并做短检查

可复制示例
cd /absolute/path/to/microduck
DUCK_SIM_RL=/absolute/path/to/microduck_rl scripts/duck-sim
scripts/duck-sim status
scripts/duck-sim drive
scripts/duck-sim ctl health
scripts/duck-sim realtime
scripts/duck-sim down

drive 只发送约八秒的前进请求,适合确认控制链路,不是速度或稳定性成绩。把 status、health、realtime、robotd 日志和 MuJoCo 日志放在同一份记录中。实时率低于 1.0 时,策略看到的时序已经改变;先减少鸭子和相机数量,再考虑无窗口运行。

plain 与 boot 回答不同问题

普通启动适合策略、IPC、控制循环和客户端。boot 模式把每只鸭放进真实 systemd 容器,适合验证服务账户、目录权限、更新健康门和重启顺序,但需要 sudo、systemd-nspawn 与 mmdebstrap。不是排查系统服务时,不必先承担这层复杂度。

明确写出验证边界

通过本地仿真,可以写“在指定提交的守护进程仿真中复现”。不能据此写成电机总线、蓝牙、相机、NPU、打印结构或实地接触已经验证。跨过这个边界时,另建实体测试清单。

继续之前先确认

duck-sim 能验证实机接线和校准吗?

不能。它在仿真机身上检查守护进程行为;硬件连接、传感器和实际运动需要另外验证。

适用范围: Pollen Robotics MicroDuck. 把模型、镜像、软件和驱动版本一起记录。各日期段落保留原有验证范围。

资料核查于:

来源与核查 (4)
  1. github.com/pollen-robotics/microduck/blob/e90389492bd4da42f60da343983e50cecd43b54b/docs/robot/simulation.md
  2. github.com/pollen-robotics/microduck/blob/e90389492bd4da42f60da343983e50cecd43b54b/scripts/duck-sim
  3. github.com/pollen-robotics/microduck_rl/blob/cb70b792312d559a4da09064d92009079671815f/README.md
  4. github.com/pollen-robotics/microduck_rl/blob/b02fdea4902c2b93b7d34a83a6f05da4ececb7d3/docs/velstand_policy.md

接下来读这些教程

MicroDuck 浏览器仿真:试走、导入公开动作与恢复原版

无需实体机器鸭,先用方向键试走,再用 URL 导入官方公开策略;看懂 PLAYING 标签、manifest 适配条件和卸载、加载失败后的恢复方式。

MicroDuck 第一次连接:先找机,再配 Wi-Fi 和打开控制台

官方实体机初次连接时,用电脑端 duckctl 分清蓝牙已找到、暂无 IP、Wi-Fi 入网,以及网页 8080 与信令 8443 两种故障。

MicroDuck 排障:升级配对、摄像头与策略

MicroDuck 0.20.1:先分清访问方式再恢复. Wi-Fi SSH 需要本地决定。先核对 daemon/API 和 Setup Code,不把连接被拒直接当成升级失败。