Microduck 快速开始

更新于 2026-11-10

摘要：按三条目标给出 13 个内容页的阅读顺序表，说明快速开始为什么不作为规划依据、每阶段读完能验收什么，以及从哪里进复刻实操线或训练线。

先选一条路线，再按表读

Microduck 的内容分三条线：认识线讲这是什么、能做什么、开源到哪一层；实操线讲怎么自己复刻一只并让它走起来；进阶线讲训练策略、写自定义行为、找社区资源和排障。三条线不必全读，按下面这张表挑自己要走的。

你的目标	建议路线	读完能做什么
只想弄明白这只鸭子是什么、值不值得关注	10 → 20 → 30 → 40 → 50 → 130	能说清官方开源边界、社区复刻与仿冒渠道的区别
想自己动手复刻一只并让它走起来	60 → 70 → 80 → 90 → 130	能按同一版图纸核 BOM、完成零位与 IMU 校准、把策略导出上机
已经能跑，想训新动作或写自己的行为	100 → 110 → 120 → 130	能走通训练到发布、写规则动作、加载社区策略并按四类反查故障

这一页在全部页面结构定型之后才写，所以它只是导航，不作为规划依据，也不替代任何一页里的具体步骤。表里顺序按页面展示顺序排，与侧栏和上下篇一致。

顺序	页面	解决什么问题
10	《Microduck 是什么：能做什么，不能做什么》	能做什么、不能做什么，软件开源而硬件未开源
20	《Microduck 硬件规格与传感器》	尺寸、舵机、主控、感知与版本差异边界
30	《Microduck 开箱上手：先跑一遍出厂动作》	先跑一遍出厂动作，以及交付与购买边界
40	《Microduck 开源生态与策略训练》	两份仓库、官方策略集、策略怎么练出来与许可证边界
50	《Microduck 复刻版与官方渠道怎么分》	六步渠道核对、国内复刻盘点与防仿冒
60	《Microduck 复刻实战：用 ESP32-S3 手搓一只》	四条复刻路线对照、五个硬边界与选路顺序
70	《Microduck 复刻物料清单与外壳打印》	锁版本、核 BOM 规格与外壳打印、成本复核
80	《Microduck 舵机归零与 IMU 水平校准》	逐颗设编号与中位、IMU 方向核对、后摔排障
90	《Microduck 行走策略量化与部署》	官方导出路径、精度选择、状态对齐与策略冻结局限
100	《Microduck 强化学习训练与真机部署》	环境准备、冒烟测试、训练、导出、发布与装机
110	《Microduck 编程：Python 与 JavaScript 自定义动作》	命令组合、Python 自定义动作、遥控面板三条路
120	《Microduck 玩法扩展与社区资源》	策略集、社区仓库、配套阅读与跟踪官方更新
130	《Microduck 常见问题与故障排查》	组装、调试、策略、购买四类的现象原因解法

先分清官方与社区：官方只开源软件栈、仿真、训练栈与出厂策略，BOM、3D 打印件、接线图与 IMU 板设计未开放；社区复刻是各自重建，不能当官方标准硬件方案。
先记版本再动手：硬件、运行时、策略三处版本要能对上同一版，一半按新图一半按旧视频是典型翻车原因。
先验收再往下走：机械活动顺畅、供电共地、所有舵机与 IMU 在线、默认姿态正常、策略复演数值一致，每一步过了才进下一步。

能回答三个问题就算读明白了：官方到底开源了什么、这条路线要跟哪份仓库的哪套编号表、策略出问题按哪一层反查。答不上来就回对应页面再看一遍，不要靠加大增益或反复上电碰运气。想直接找资源去《Microduck 玩法扩展与社区资源》，遇到具体故障直接跳《Microduck 常见问题与故障排查》。