「手搓 Microduck」可不只有一种模式
中文社区里「手搓一只 Microduck」常被讲成一条路线,实际上是好几条互不通用的路线被叠在一起说。混着看最直接的后果是:照 A 仓库的 BOM 买件、按 B 教程设舵机 ID、再拿 C 文章的量化参数去调策略,最后卡在一个怎么查都查不到的步态问题上。动手前花五分钟把路线分清楚,比后面调一周零位省时间。
有一处口径必须先纠正:官方原版的主控是 Rockchip RK3566,官方主仓库的运行时是一组 Rust 守护进程,以 50 Hz 控制回路驱动 15 个舵机并加载 ONNX 策略。中文技术文章里「Microduck 主控是 ESP32-S3」「状态空间 31 维」这类写法,说的是玩家把训练好的行走策略量化压缩后塞进微控制器的降本复刻路线,不是官方硬件规格。官方训练仓写明的策略契约是 61 维观测、14 维动作。本页标题沿用「ESP32-S3 手搓复刻实战」,是因为这条降本路线在中文圈传播最广,但正文会把它和另外几条路线并排摆清楚。
| 路线 | 主控与执行器 | 公开资料范围 | 适合谁 | 主要门槛 |
|---|---|---|---|---|
| 官方原版 | RK3566,15 个 Dynamixel 舵机,摄像头、ToF、双 IMU | 软件栈与训练栈、7 个出厂策略;BOM、3D 打印件、接线图未开放 | 想开箱即用或直接玩训练的人 | 预购排期长,硬件设计文件拿不到 |
| 国内完整开源方案 | Arduino UNO Q 双芯片加自研扩展板,15 个 Feetech HD1910M | 结构件、PCB、BOM、图解装配手册、固件、三个 ONNX 策略、网页控制端 | 有 3D 打印机与焊接基础、想一次复刻到能走的人 | 版本锁定严,Zephyr 与桥接组件版本固定,部署环节容易卡 |
| 简化教学路线 | Pi Zero 2 W 加 OpenRB-150,14 个策略舵机加 1 个嘴部舵机 | 镜像、BOM、打印件、中文教程与排障记录,MIT | 想先跑通 50 Hz 闭环、不追求原版感知的人 | 只有单 IMU,无摄像头与 ToF;社区方案个人非商业许可混杂 |
| ESP32-S3 降本路线 | 微控制器加 3D 打印外壳,策略量化后板载推理 | 玩家自述与零散教程,无统一仓库与版本 | 只想验证「策略能不能塞进 MCU」的人 | 资料碎片化,量化后策略冻结,动作幅度与关节映射要自己对齐 |
四条路线的共同点只有一个:策略接口沿用了官方那套形状。官方运行时热切换策略靠的是共享的 61 维观测契约,所以「复刻鸭能加载官方策略」这种说法在特定方案里成立,但换个主控、换个舵机型号,机械、电气与动力学就得重新对齐,不能当成官方标准硬件方案。
动手前先接受的五个边界
这几条不是劝退,是决定后面所有步骤怎么做的地基。中文资料最容易在「全开源」三个字上翻车,官方一手 README 与产品页写得很清楚:开放的软件栈、仿真与完整强化学习训练栈、出厂策略;没有开放 BOM、3D 打印件、接线图与 IMU 板设计。社区复刻是各自照公开外形和策略思路重建,每份 BOM 都属于那个仓库的作者,不属于 Pollen Robotics。
| 边界 | 可核实的事实 | 对动手的影响 |
|---|---|---|
| 硬件未开源 | 官方主仓库无 BOM、无 CAD,甚至未列舵机型号;复刻者逐仓复核长文写明机械设计与完整 BOM 未发布 | 不要拿社区 BOM 当官方规格去采购,也不要把仿制件称作原厂配件 |
| 许可证混合 | 官方代码 Apache-2.0,但训练仓里的 3D 网格文件为 CC BY-NC-SA 4.0;社区集成还有 MIT、个人非商业许可等不同口径 | 再分发或商用前逐仓看 NOTICE 与许可证,不能一句「开源」就默认可商用 |
| 策略冻结 | 量化导出的策略停在导出当天,原版仍在社区持续发布新动作 | 复刻机无法跟随官方后续更新,想要新动作得自己重训再导出 |
| 成本可能倒挂 | 社区报过舵机单只约 400 元、整份 BOM 数千元,也有玩家自述降本路线「不到 2000 元」 | 两种口径对应不同方案,先按自己选的路线核当期行情,不拿别人的总价当预算 |
| 版本强耦合 | 硬件扩展板、运行时、策略三者要同一版本;官方策略集还有不可变版本的 SHA-256 校验产物 | 记录三处 commit 或版本号,一半按新图一半按旧视频是典型翻车原因 |
四步选定自己的路线
- 先写下一句话的目标,是「想看它能走」「想复刻一套能改的硬件」还是「想自己训新动作」。预期结果:能从上面表里圈出唯一一行。如果圈出两行,说明目标还没收敛,别进采购环节。
- 盘点手头的硬件条件:有没有 3D 打印机、能不能做 PCB 打样或焊接、有没有可调限流电源和万用表。预期结果:能判断自己走「完整开源方案」还是「简化教学路线」。缺台架工具就先只买 1 到 3 颗舵机做单舵机台架,不直接做整机。
- 逐仓核对许可证与版本:打开打算跟的仓库,记录硬件版本、运行时版本、策略版本,看清楚结构件与代码的许可证。预期结果:三处版本能对上、许可证能回答「能不能商用」。对不上就停下,别混搭。
- 按《Microduck 复刻物料清单与外壳打印》出一份自己的清单,再决定要不要继续。预期结果:清单里每一项都写明规格与核对要点,且不含「按旧帖大概买」这种条目。这一步做完才谈动手。
选路时还有一个常被忽略的现实:完整开源方案去掉了摄像头与 ToF,定位是纯运动平台;简化教学路线同理。想做视觉、语音或导航扩展,得自己加主控算力,不能指望 50 Hz 控制闭环还能顺带跑目标检测。
三个子页各管什么
这一页是复刻板块的父页,只负责把路线、边界和顺序讲清楚;可照做的细节全部放在三个子页里,按下面顺序走,不要跳。
| 顺序 | 页面 | 解决什么 | 做完的标志 |
|---|---|---|---|
| 1 | 《Microduck 复刻物料清单与外壳打印》 | 锁版本、核 BOM、试打印、装配前三项检查 | 零件与同一版图纸一致,关节活动顺畅 |
| 2 | 《Microduck 舵机归零与 IMU 水平校准》 | 逐颗设 ID 与中位、整机零位、IMU 方向、首次上电分级验收 | 15 颗舵机与 IMU 在线,默认姿态无异常 |
| 3 | 《Microduck 行走策略量化与部署》 | 官方导出路径、精度选择、状态向量对齐、冻结局限与验证 | 卸力预览与 CPU 复演通过后才小范围行走 |
一条不能跳的验收链
复刻完成的标准不是「外壳像了」,也不是「某次站起来走了两步」,而是下面这条链能稳定重复。每一步没过就停在原地查,往后走只会把机械问题误判成策略问题。
| 阶段 | 通过标志 | 不通过时先查 |
|---|---|---|
| 版本与零件 | 图纸、BOM、固件、策略同一版本 | 归档目录里的旧板文件、旧接线说明是否被混用 |
| 机械 | 关节全程无卡滞,舵盘与结构件无干涉,线束不承拉 | 镜像件装反、支撑未清理、切片方向 |
| 电气 | 供电与逻辑共地,母线电压在负载下不掉出范围 | 电池放电能力、线阻、缓冲电容 |
| 通信 | 所有舵机在线且 ID 唯一,IMU 有连续变化的读数 | 撞 ID、波特率、串口被占用 |
| 零位与方向 | 默认姿态与机械中心一致,单关节小幅运动方向正确 | 中位值、offset、IMU 安装朝向 |
| 策略 | 卸力预览与 CPU 复演数值一致,推理前后量纲一致 | 导出路径、观测归一化、单位与坐标系 |
下一步
路线定下来后直接进《Microduck 复刻物料清单与外壳打印》。如果中途出现步态歪斜、一走就后摔或舵机通信异常,去《Microduck 常见问题与故障排查》按现象反查,不要在零位还没准时反复加大增益。想跳过硬件、只玩训练与策略交换,走《Microduck 强化学习训练与真机部署》和《Microduck 玩法扩展与社区资源》。