社区里到底有什么
「去社区找资源」这句话太笼统。实际能拿到的东西分四类,可靠性差别很大。官方开放的不只是源码,还包括 7 个出厂策略可重训、可发布,官方策略集名称是 pollen-robotics/microduck-policies;玩家在 Discord 交换策略;另有独立的仿真与训练扩展仓库;再有国内几家把硬件资料整套开源的复刻方案。把它们混成「开源社区」一个词,最容易在许可证和版本上出问题。
| 类别 | 代表资源 | 能拿来做什么 | 是不是官方发布物 |
|---|---|---|---|
| 官方策略集 | 7 个出厂策略与官方策略仓库 | 建立步态基线、对比自己训练的结果、热切换 walk 与 recover | 是 |
| 官方仓库文档 | 运行时仓库的设计决策目录与项目踩坑目录 | 理解为什么这样设计、哪里已经出过错 | 是 |
| 社区训练与仿真扩展 | ROS 2 Jazzy 与 Isaac Sim 集成、跑步任务示例、策略操场 | 可视化关节、演练热切换、试验新任务 | 否,独立社区项目 |
| 国内复刻方案 | 完整开源硬件仓、简化教学路线、玩家自述的降本路线 | 拿到 BOM、结构件、镜像与中文排障记录 | 否,各自重建 |
拿到一条现成策略,五步装好并留回退
- 先记版本:当前固件与运行时版本、官方策略集版本或校验值、自己要装的第三方策略来源与日期。预期结果:出问题时能说清「装的是哪一版」。社区集成仓库明确写官方策略取自不可变策略集的 SHA-256 校验产物,而随附仿真资产仍是历史基线,两者不是同一时点。
- 从官方策略集建立基线:先跑出厂 walk,记录站姿、步态和默认姿态表现。预期结果:有一份「正常长什么样」的参照。没有基线,后面换策略变差了,都说不清是策略的问题还是这台机器标定的问题。
-
安装社区策略:用
sudo robotctl policy add装 episodic 策略、robotctl policy load换 gait 策略,再用robotctl robot do触发。预期结果:策略被加载且动作名可调用。加载失败就看robotctl health与robotctl monitor,运行时会点名不健康的原因。 - 留回退并分级验证:旧策略文件挪到目录外留一份;新策略先卸力预览、再固定中位开环、最后小范围行走。预期结果:随时能换回去,且每一步可复现。
- 把结论记成一条可核对的条目:策略名、来源、版本、适用硬件、观察到的差异。预期结果:下次换策略不用从头试。别把「某次走起来了」当成结论。
玩法扩展与配套阅读
鸭子本身只有运动和基础感知,想做更完整的项目,一般是往外接东西。下面这些站内页面可以按需要跳过去读,不是本项目的子页。
| 想做的事 | 先看站内哪一页 | 能补上什么 |
|---|---|---|
| 让机器人联网上报状态或远程控制 | 《ESP32 WiFi 联网实战》与《ESP32 Web Server 网页控制》 | STA 与 AP 两种形态、网页控制 GPIO 的路由模型 |
| 加一块屏幕或做环境感知小站 | 《行空板 K10 综合项目实战》与《行空板 K10 屏幕显示与交互》 | 采集、判断、上报、显示的完整流程 |
| 换一种「教会机器人动作」的思路 | 《SO-101 数据采集与模仿学习》 | 遥操作采数据、训练、推理这条与强化学习不同的路径 |
| 本项目内部继续深入 | 《Microduck 强化学习训练与真机部署》《Microduck 编程:Python 与 JavaScript 自定义动作》 | 自己训策略、自己写规则动作与遥控面板 |
怎么跟上官方持续更新
| 动作 | 用哪个入口 | 预期结果 |
|---|---|---|
| 看当前版本与健康状况 | robotctl version、robotctl health、robotctl monitor | 能确认在跑的二进制、策略路径与不健康原因 |
| 安装签名更新并保留回滚 | 官方 updaterd 的健康检查与自动回滚机制 | 更新失败能回到上一版,不用重刷整机 |
| 钉住某个策略版本 | 策略仓库的版本与校验产物 | 同一套结果可复现,不会被上游悄悄改动 |
| 确认新动作有没有进官方集 | 官方产品页与策略集发布说明 | 区分「官方新增」与「社区自制」,不把两者混写 |
有个现实落差要提前说清:量化导出的复刻策略冻结在导出当天,原版还在持续发布新动作。想跟上更新,只能按官方训练流程重训、重新导出、重新验证,没有「一键同步新动作」这种开关。
社区资源的现实边界
| 资源 | 边界事实 | 动手前要核什么 |
|---|---|---|
| ROS 2 与 Isaac 集成仓库 | 原文写明是独立社区项目、未获 Pollen Robotics 背书,不含物理机器人驱动或 ros2_control,Isaac 任务用近似 PD 且不是 sim-to-real 声明 | 别当官方训练路线;确认上游策略集与随附 USD 的版本差异 |
| 许可证 | 原创集成代码与文档可为 Apache-2.0,但上游 STL 与转换网格常为 CC BY-NC-SA 4.0,混合分发不再是纯 Apache | 逐仓看 NOTICE 与许可证,商用或再分发前尤其要核 |
| 简化复刻路线 | 只有单 IMU,去掉摄像头与 ToF,定位为纯运动平台 | 别按原版的感知能力规划项目 |
| 玩家自述热度与成本 | 播放量、点赞、订单量、「不到 2000 元」都是特定时点的社区口径 | 只作背景,不写进规格、结论或预算 |
下一步
资源与版本分清楚后,遇到问题按《Microduck 常见问题与故障排查》的组装、调试、策略、购买四类反查;想从零走一遍训练到发布,回《Microduck 强化学习训练与真机部署》;还没决定先读哪一页,去《Microduck 快速开始》看阅读顺序表。