正在连接信源…

Microduck 复刻全流程

Microduck 从采购、打印、组装到装软件、标定和训练的 93 个步骤,附物料表、购买链接与官方出处。

飞特 HD-1910 社区复刻约 2,443 元:物料表原表合计 2,426.88 元(含整套打印件 139 元、15 个舵机 1,425 元、Radxa Zero 3W 309 元),另加原表漏算的防滑垫 16 元;不含运费。官方整机预购 399 美元(不含税运)

物料 · 二、外购件(23 项)

零件数量CN
Radxa Zero 3W 主控板1CNY 309
64GB TF 卡1CNY 60
树莓派机器人HAT电路板1CNY 120
imu_to_dxl电路板1CNY 80
飞特HD1901M舵机15CNY 95
飞特舵机URT2调试板1CNY 45
NP-F550电池1CNY 17
AMP2.0双头转接线 microduck 舵机线1CNY 2
2.5mm香蕉插头PCB铜镀金2CNY 1.6
banana PCB1CNY 20
IMX219摄像头模块1CNY 46.8
VL53L8CX ToF 模块1CNY 49.5
扬声器1CNY 3.8
轴承 10×15×33CNY 2.8
轴承 16×22×411CNY 3.5
轴承 6×12×34CNY 0.88
自攻螺丝 平尾M2×51包CNY 3.05
自攻螺丝 平尾M2×61包CNY 4.05
自攻螺丝 平尾M2×81包CNY 4.05
自攻螺丝 平尾M2.5×61包CNY 3.93
自攻螺丝 平尾M2.5×81包CNY 2.08
乐泰螺纹胶2431CNY 9
鞋底防滑垫1CNY 16

物料 · 一、打印件(33 项)

零件数量
头部上壳 · top_head_shell_头部上壳.stp · PLA1
头部下壳 · bottom_head_shell_头部下壳.stp · PLA1
面部零件 · face_part_面部零件.stp · PLA1
下巴 · jaw_下巴.stp · PLA1
软下巴 · jaw_soft_软下巴.stp · PLA1
软嘴顶部 · soft_mouth_top_软嘴顶部.stp · PLA1
眼睛 · noenoeil_眼睛.stp · PLA1
颈部 · neck_颈部.stp · PLA2
颈部俯仰 · neck_pitch_颈部俯仰.stp · PLA1
躯干底座 · trunk_base_躯干底座.stp · PLA1
左壳 · left_shell_左壳.stp · PLA1
右壳 · right_shell_右壳.stp · PLA1
髋部左 · hip_l_髋部左.stp · PLA2
偏航转横滚 · yaw2roll_偏航转横滚.stp · PLA1
偏航横滚运动 · yaw_roll_motion_偏航横滚运动.stp · PLA1
腿部 · leg_腿部.stp · PLA2
左上腿 · left_upper_leg_左上腿.stp · PLA1
右上腿 · right_upper_leg_右上腿.stp · PLA1
上腿加固板 · upper_leg_rigidity_plate_上腿加固板.stp · PLA2
左脚 · foot_left_左脚.stp · PLA1
右脚 · foot_right_右脚.stp · PLA1
左脚底 · sole_left_左脚底.stp · PLA1
右脚底 · sole_right_右脚底.stp · PLA1
脚踝左 · ankle_left_脚踝左.stp · PLA1
脚踝右 · ankle_right_脚踝右.stp · PLA1
脚踝左(V1备选) · ankle_l_v1_脚踝左V1.stp · PLA1
脚踝右(V1备选) · ankle_r_v1_脚踝右V1.stp · PLA1
合体轮胎 · 合体轮胎.stp · PLA4
滚轮叶片 · roller_blade_滚轮叶片.stp · PLA2
电机支架 · motor_support_电机支架.stp · PLA1
电源支架 · power_support_电源支架.stp · PLA1
香蕉形PCB锁扣 · banana_pcb_locker_香蕉形PCB锁扣.stp · PLA1
轴承滚轮 · bearing_roll_轴承滚轮.stp · PLA2

采购

  • 确认飞特 HD-1910 采购版本

    本清单适用于飞特 HD-1910 方案,并包含飞特舵机和 URT2 调试板。

  • 下载完整装配采购表

    下载完整 Excel,核对 33 项打印件和 23 项外购件的数量、材料、备注、价格及采购链接。

  • 采购整套打印件

    整套打印件的价格记录为 139 元,对应 Excel 合并区域 I3:I35,可使用清单中的采购链接购买。

  • 按链接采购全部外购件

    按原表显示的价格采购 23 项外购件,金额单位为元。表内有网址的项目可直接点击购买,未填写网址的项目标为“原表未填”。

  • 核对采购总价和待确认项目

    原表合计为 2426.88 元,但公式 SUM(I3:I58) 未包含 I59 的“鞋底防滑垫”16 元。还需核对“NP-F550电池”数量为 1、单价为 17 元而总价为 47 元的不一致。

  • 查看并下载装配 BOM

    打开在线最新版清单或主仓库同版清单,检查每项的条目、数量、材料、备注、原表价格和采购链接;需要时下载完整 Excel。

  • 选择对应的 CAD 版本

    根据飞特或 XL330 舵机方案选择对应的 CAD 版本;两版舵盘配合件不能混用,XL330 的舵机及配套电控需另行核对。

  • 购买主控电子部件

    对照主仓电控采购清单核对主控配置;15 个舵机、HAT 板和 IMU 板可通过 GitHub 项目参与拼团,也可根据需求在嘉立创、淘宝等平台自行购买。

  • 核对并采购所需材料

    先核对舵机版本、所需零件与材料,再按主仓机械采购清单采购耗材、螺丝和热熔螺母。

  • 确认飞特 HD-1910 版鸭子硬件

    使用已装好的飞特 HD-1910 版鸭子,15 颗舵机 ID 已配好、HAT 已插好。原版 XL330 鸭子不要用此镜像;实测用的是 Radxa Zero 3W(无 eMMC)+ 32 GB microSD 卡、C1 版 HAT。

  • 二选一:躯干 IMU

    二选一:IMU 模块(BNO085 或 LSM6DSV16X)四根线直接接主板;或者舵机总线上的 IMU 小板(ID 200),认不到模块时主程序会去总线上找它。

  • 准备 microSD 卡、读卡器、电脑和手机

    需要 8 GB 以上 microSD 卡(推荐 32 GB)、一个读卡器、一台烧卡用电脑和一部配网用手机。

打印与加工

  • 准备 33 项打印件

    根据所选 CAD 版本准备飞特版清单中的 33 项打印件;BOM 还列出了 24 项外购件。

  • 使用 TPU 打印合体轮胎

    使用 TPU 打印飞特 v2.1 CAD 版本中的合体轮胎,尽管原表材料栏仍写着 PLA。合体轮胎、滚轮叶片和轮滑轴承用于轮滑变体。

  • 打开 Bambu Studio 工程

    在 Bambu Studio 中打开“打印/microduck-飞特版-BambuStudio2026-11-02.3mf”。这是机械行者Robo 排好盘的工程,版本为 2026-11-02。

  • 检查排盘并切片

    切片前检查工程中展示的各盘排盘。

  • 柔性件使用 TPU 打印

    软下巴、软嘴顶部与轮胎等柔性件应按 BOM 使用 TPU 切片,不能统一按默认 PLA 打印。

  • 配置其他打印机

    使用其他打印机时,确认切片软件支持导入该 3MF,并按所用机器重新设置打印参数。

  • 选择对应舵机版打印模型

    进入 CAD 仓库,选择与所用舵机版本对应的打印模型。同时核对该版本打印说明中的材料要求。

组装

  • 按编号完成整机装配

    先将躯干主体作为基准件固定,再依次装配左腿、颈部与头部、最后装配右腿。顺序为左髋、左髋 Roll、左大腿、左小腿、左踝脚;颈根、颈俯仰、头 Yaw/Roll、头部总成;右髋、右髋 Roll、右大腿、右小腿、右踝脚。

  • 准备并固定躯干主体

    将躯干主体平放于工作台,检查安装孔位、线缆出线孔和舵机安装位。确认无毛刺、异物且孔位螺纹完好后,将其作为装配基准固定;避免强力敲击,线缆从预留孔引出且不得压线、夹线,并确认孔位朝向。

  • 安装左髋

    确认左髋方向,注意其与右髋为镜像件;舵机装配前先通电归中位。将髋关节舵机装入安装槽,使输出轴与转动轴线重合;螺丝先对角预紧再均匀锁紧,并检查关节转动是否顺畅、无卡滞。

  • 安装左髋横滚关节

    将左髋 Roll 与髋关节同轴或相邻安装,并确认 Roll 轴方向。固定后转动测试横滚角度范围,检查极限位置是否与机身干涉,并在转动处保留适当间隙,避免摩擦发热或卡滞。

  • 安装左大腿

    将大腿上端连接髋关节输出端,下端连接小腿。确认上下两端轴孔对齐后锁紧,注意大腿与小腿的相对方向,走线沿腿节外侧固定并预留关节活动余量。

  • 安装左小腿

    将小腿上端连接大腿,下端连接踝关节。确认转动方向与行程后锁紧连接螺丝;与大腿连接处检查转动范围,防止极限位卡死,并保持锁紧力度适中以避免塑料件开裂。

  • 安装左踝脚

    将踝脚上端连接小腿下端,脚部作为末端支撑件。确认踝关节中位后锁紧并进行中位标定,检查脚底着地平面,确保左右脚对称、站立平稳。

  • 安装颈根

    将颈根固定于机身顶部安装位并确认垂直度。将颈部线缆从预留孔引出后锁紧,确保与机身垂直,并预留足够线缆长度,避免抬头或低头时拉扯。

  • 安装颈俯仰关节

    将颈俯仰上端连接头部关节,下端连接颈根。确认俯仰轴方向后锁紧,检查俯仰角度范围,避免与躯干或头部干涉,并进行俯仰中位标定以保证头部初始姿态正确。

  • 连接头部 Yaw/Roll 关节

    将颈部俯仰关节与头部总成连接。确认 Yaw 和 Roll 两轴方向正确后锁紧,并检查头部转动范围及线缆余量。

  • 装配头部总成

    按爆炸图依次装配头部内部结构,使外壳与内部支架对位并安装排线和传感器。闭合外壳并锁紧固定螺丝,传感器或摄像头窗口朝向前方,排线需预留活动余量。

  • 安装右髋关节

    确认右髋与左髋为镜像安装,装入髋关节舵机并使输出轴与转动轴对齐。舵机先归中位,再采用对角分步方式均匀锁紧。

  • 安装右髋 Roll 关节

    在右髋同轴或相邻位置安装右髋 Roll,并确认 Roll 轴方向。固定后转动测试横滚角度范围,检查极限位置是否与机身干涉。

  • 安装右大腿

    将右大腿上端连接右髋关节输出端,下端连接右小腿。确认上下轴孔对齐后锁紧,并将线缆沿腿节外侧固定。

  • 安装右小腿

    将右小腿上端连接右大腿,下端连接右踝关节。确认转动方向后锁紧,螺丝锁紧力度需适中,并与左小腿保持镜像对称。

  • 安装右踝脚

    将右踝脚上端连接右小腿下端,脚部作为末端支撑。确认踝关节处于中位后锁紧,并与左踝脚保持对称,确保双脚着地平稳。

  • 装配前清点零件

    装配前对照 BOM 清单清点零件数量与规格,并确认 M2 和 M2.5 螺丝及紧固件型号齐全。

  • 舵机关节先归中再锁紧

    舵机驱动的关节在锁紧前先通电并归中,避免行程偏移。舵机到达中位后再锁紧关节。

  • 分步均衡锁紧螺丝

    螺丝采用对角分步预紧,避免单边受力导致零件变形。塑料件上的螺丝不得过度锁紧。

  • 区分左右镜像零件

    必须区分髋、大腿、小腿和踝脚等左右对称零件的方向。切勿将镜像件装反。

  • 固定线缆并预留余量

    统一固定线缆,并为关节活动预留余量。严禁压线、夹线或缠绕。

  • 逐个测试活动关节

    每完成一个活动关节后,转动测试一次,检查是否存在干涉、卡滞或异响。

  • 按要求使用螺纹胶

    需要防松的连接处,按照 BOM 要求使用适量螺纹胶。

  • 首次通电前检查电气连接

    首次通电前检查所有电气连接、绝缘和极性。确认全部无误后再上电。

  • 准备推荐工具

    按照 BOM 准备十字和内六角螺丝刀、用于细小螺丝与排线卡扣的镊子,以及用于防松紧固件的螺纹胶。还需准备舵机中位调试工具或控制板。

  • IMU 接到 HAT J5 或 27/28 脚

    四根线接 HAT 的 J5 或 40 针的 27/28 脚。D1 版 HAT 自带地址 0x6A 的 LSM6DSV16X,躯干模块要设成 0x6B;模块 x 轴朝下、z 轴朝鸭子前方,这样 IMU 那一步可跳过。

  • 第一次开机前接好 IMU

    IMU 必须在第一次开机之前接好,第一次开机时鸭子会自己去认它。

软件与固件

  • 下载镜像与校验文件

    从 GitHub Releases 或网盘下载 microduck-replica-日期.img.xz 和同名的 .sha256。

  • 核对镜像校验值

    Windows 在下载目录用 PowerShell 运行 Get-FileHash 并与 .sha256 里的字符串对比(大小写不用管);Mac/Linux 运行 shasum -a 256 -c。该核对可跳过,但出了怪问题先查这个。

  • 用 balenaEtcher 烧卡

    用 balenaEtcher:选镜像文件(.img.xz 不用解压)→ 选 SD 卡 → Flash。树莓派官方 Raspberry Pi Imager 也行,在「操作系统」里选最下面的「使用自定义镜像」。

  • 取消 Windows 格式化提示

    烧完后 Windows 可能弹出「需要格式化」,点取消,不要格式化。

  • 连接鸭子热点

    鸭子连不上任何 WiFi 时,会创建热点 `Microduck-` 加同样的 4 位字符,例如 `Microduck-c51b`,密码是 `microduck`。

  • 加入鸭子热点

    在手机 WiFi 列表中找到 `Microduck-xxxx`,用密码 `microduck` 连接。若手机提示「此网络无法上网」,选择保持连接。

  • 打开 Microduck Studio

    在手机浏览器打开 `http://10.42.0.1:8000/`,查看 Microduck Studio;如果打不开,先关闭移动数据再试。

  • 选择家里的 WiFi

    在最上面的「连 WiFi」卡片中选择家里的 WiFi,填写密码并点「连接」;看清确认框后,再点「断开去连「你家 WiFi」」。

  • 填写 WiFi 密码

    每次连接都要填写密码,即使该网络已经保存也要重新填写。

  • 等待切换到家庭网络

    鸭子会关闭热点并连接家里的 WiFi,因此手机会断开热点,这是正常现象。

  • 按设备打开鸭子页面

    手机或电脑连上家里的 WiFi 后,Windows 使用 `http://duck-xxxx:8000/`,苹果手机或 Mac 使用 `http://duck-xxxx.local:8000/`;安卓手机或两者都无法打开时,在路由器设备列表中找到 `duck-xxxx`,用它的 IP 地址打开,例如 `http://192.168.1.23:8000/`。

  • 保存鸭子页面地址

    打开 Studio 后,「更多」页会列出这只鸭子当前的所有地址,可以把地址加入书签。

  • 连接失败后重试

    如果密码填错或鸭子没有连上,热点会自动回来,一般立即出现,最慢约 2 分钟。重新连接 `Microduck-xxxx`,卡片会用红字显示上次失败的原因,修改后再试。

  • 配置蓝牙手柄

    进入手柄页,按向导配对蓝牙手柄,也可以先使用网页上的手柄。雷神 G50 Pro 这类可切换平台的手柄,将背面拨到 X 档(Xbox);20261021b 镜像在 X 档下即可连接。

标定与测试

  • 插卡并首次开机

    把 SD 卡插进主板,给鸭子上电,并接上舵机电源。

  • 等待首次开机初始化

    等待约 3 分钟,系统会扩展 SD 卡剩余空间、给鸭子起一个由 `duck-` 加 4 位字符组成的名字,并识别 IMU 模块;以后开机就快了。

  • 按上手清单操作

    在总览页从上往下完成「上手清单」。「去做」会打开对应页面,已经完成的点「已完成」,暂时不做的点「跳过」;主程序可能会先提示后两项的后果,确认后即可继续。

  • 校准舵机零位

    进入舵机页,把鸭子摆成零位:腿伸直、头摆正、嘴闭上,然后点「一键校准」。

  • 进行 IMU 粗校

    在 IMU 页双手托住鸭子并摆正、保持静止,然后按页面提示往前低头。页面算出方向后,将鸭子摆正,并在 20 秒内往前低头 15~30°,交由主程序验证。

  • 进行 IMU 站立校准

    更准确的方法是在 IMU 页点「站姿使能」,15 颗舵机在 3 秒内一起转到站姿并锁住;标定模式也能站但不负责平衡,需要扶着。站好后完成静止、前、后、左、右的站着校准,再点「失能」或「卸力」并扶住鸭子。

  • 使用默认 IMU 安装方向

    如果以前校准过或选择跳过,第 3 步会写入默认安装方向:总线 IMU 小板用官方装法,BNO085 用 fork 的默认装法,LSM6DSV16X 用复刻推荐装法,即模块 x 轴朝下、z 轴朝前;安装不同时需重新进行站着校准。

  • 将标定写入主程序

    写入前让鸭子坐着或保持柔软;启用过站姿的先点「失能」,并保持舵机电源开启。把两步结果一次写入主程序;程序约 20 秒重启,慢时可能需要一分钟,期间扶好鸭子,并从标定模式切换到运动模式。

  • 使用手柄 Xbox 档

    手柄使用 Switch Pro 的 S 档时,配对可以成功,但主程序收不到按键,手柄等待一会儿会自行关机;原因仍在调查。

  • 测试手柄急停

    短按一次手柄的 Select,确认鸭子能马上卸力。按住 Select 2 秒会执行坐下、卸力和关机,因此测试急停时不要按住。

采数据与训练

  • 创建反向间隙训练任务

    在每个主任务 ID 的 `MicroDuck` 前插入 `-Backlash`,并使用具有 ±1° 齿轮间隙的模型训练。14 个伺服关节各串联 1° 的间隙,总计 2°。

  • 配置反向间隙关节模型

    使用 `src/mjlab_microduck/tasks/backlash.py` 中的实现,为每个伺服设置无驱动的 `passive_<joint>_backlash` 铰链。编码器仿真及 `joint_pos`、`joint_vel` 观测均穿过间隙读取,因此观测与动作维度不变。

  • 选择 BAM M6 执行器模型

    为所有任务使用适用于 Dynamixel XL330 的 BAM M6 执行器模型。该模型包含电压控制律、反电动势、库仑摩擦、Stribeck 摩擦和负载相关摩擦。

  • 配置执行器域随机化

    使用 `src/mjlab_microduck/actuator/` 中的 `FrictionDRBamActuator`。为每个环境随机化电池电压、负载下的电压下降、命令延迟和摩擦幅度。

  • 选择 MicroDuck MJCF 模型

    从 `src/mjlab_microduck/robot/microduck/` 中选择所需的 MJCF 机器人模型。该目录包含机器人的不同模型版本。

  • 导出 Onshape MJCF 配置

    使用 `onshape-to-robot` 从 Onshape 导出 MJCF 模型。为每个模型提供一个对应的 `config_mjcf_*.json` 配置文件。

  • 查看场景并运行策略推理

    使用 `scene*.xml` 文件加载机器人、地面及 STAND、SIT、FOLD 关键帧,以便快速查看模型。也可使用这些场景文件配合 `infer_policy.py` 运行策略。

  • 预览策略上传

    使用 `--dry-run` 查看将上传的内容,而不会触碰 Hub。

  • 添加并运行间歇式鞠躬策略

    在机器人上添加 `polite-bow` 策略,然后运行它。

  • 添加保持的火烈鸟姿势

    添加 `flamingo` 保持姿势,并通过 `--hold 5` 指定持续五秒。

  • 加载行走步态

    将策略加载到 `walk` 槽位,用于行走步态。

  • 配置间歇式策略

    Episodic 策略运行 `--duration-s` 指定的时长,然后自行回到站立姿势。按住按钮时应重复动作时,添加 `--chain`。

  • 配置永久式步态

    永久式步态持续运行,直到被告知停止。添加 `--slot walk` 或 `--slot stand`,不要添加其他选项;所有者使用 `robotctl policy load walk <repo>` 安装它。

  • 配置永久式保持姿势

    为永久式保持姿势提供 `--unwind-s`,指定 daemon 在交还步态之前驱动空闲扭转的时长。`--idle` 默认值为零,策略以 `--hold <seconds>` 作为一次性动作运行。

  • 在发布前验证策略

    发布前,`publish` 会检查图形是否为 `[1,61] -> [1,14]`,拒绝 51-D legacy 策略,并在合理输入上运行以拒绝 NaN 或恒定输出。

  • 填写策略训练元数据

    `publish` 从 git 和 wandb 填充 `training` 块,包括任务、提交、分支、dirty 标志、运行和检查点。

  • 设置仓库发布选项

    仓库默认以私有方式创建;使用 `--no-private` 创建公开仓库,使用 `--tag v1` 标记修订版本。

  • 控制已有 ONNX 文件的覆盖

    如果仓库中已经存在 `.onnx`,不带 `--force` 时发布会拒绝覆盖。

  • 使用官方相位驱动策略

    这种方法只能发布恒定命令策略。地面拾取等相位驱动动作以及 sit↔stand 姿势切换由 daemon 驱动,并包含在官方集合 `pollen-robotics/microduck-policies` 中。

用起来

  • 继续使用热点模式

    可以不连接家里的 WiFi;一直使用鸭子的热点连接 Studio,所有功能都能使用。

  • 设置 Studio 登录密码

    在外面演示前,在 Studio 的「更多」页设置登录密码;热点密码是公开的,而且 Studio 默认没有登录密码,否则附近的人连接热点就能控制鸭子。

  • 站起来并走几步

    把鸭子放在平整、防滑且有足够余量的地面上,点「站起来」,再点「开始走」并推动摇杆。

  • 立即让鸭子卸力

    任何时候都可以点页面右上角红色的「卸力」,或按空格键,让鸭子马上软下来。

常见问题

  • 零件采购受交期和跨境配送限制 #9 #21 #49
  • 原理图和PCB文件存在错误 #17 #56
  • 自定义模型被部署契约拒绝 #60
  • 在线查看结构不方便直观检查 #22
  • 群满及二维码过期导致无法入群 #14 #20 #24 #26 #45 #48

数据集

物料

  • 飞特 HD-1910 舵机 15 个(物料表单价 95 元,可在复刻项目拼团)
  • Radxa Zero 3W 主控、64 GB TF 卡、Pollen 开源的 RPI Robot HAT、总线 IMU 板
  • IMX219 摄像头、VL53L8CX ToF、扬声器、NP-F550 电池
  • 轴承、M2 / M2.5 自攻螺丝、乐泰 243 螺纹胶
  • 打印件 33 项(PLA;软下巴、软嘴建议改用 TPU)

工具

  • 3D 打印机(作者用拓竹 P2S、0.4 喷嘴、0.2 mm 层高,共 5 盘)
  • 十字 / 内六角螺丝刀、镊子、螺纹胶
  • 飞特 URT2 调试板(舵机设 ID 与归中)
  • 电脑、读卡器、手机(烧卡与网页配网)

技能

  • 3D 打印与小型机械装配
  • 烧录系统镜像、网页配网与标定
  • 可选:强化学习训练(需 CUDA 显卡或 Hugging Face Jobs)

软件

  • 复刻镜像与 Microduck Studio 网页中控(社区)
  • microduck_rl:MuJoCo 训练与 ONNX 导出(官方)

文档