这是一个面向 Pollen Robotics Microduck 双足机器鸭的第三方复刻/逆向研究仓库。项目基于官方公开的 MJCF 仿真模型、STL 网格与 Rust 源码，反推出 Microduck 的装配关系、爆炸图、CAD 装配体、关节参数、质量惯量、电控方案、紧固件与部分硬件规格。仓库重点不是提供可直接量产的完整开源硬件，而是提供一套较系统的“从仿真模型到机械复刻”的分析资料与生成脚本，帮助开发者理解 Microduck 的机械结构和复刻可行性。
适用领域
双足机器人 / 仿生机器人 / 机器人机械设计 / 机器人逆向工程 / CAD/装配建模 / MJCF/MuJoCo 仿真 / 强化学习机器人 / 嵌入式电控 / Dynamixel 舵机系统 / 3D 打印与硬件复刻
配置难度
高。仅查看装配图和 CAD 文件难度较低，但如果要完成实物复刻，需要掌握 3D 打印、CAD 修模、舵机总线、电源设计、传感器集成、嵌入式 Linux/Rust 运行时、MuJoCo 仿真和强化学习策略训练。项目更适合有机器人硬件经验的开发者或团队，不太适合零基础用户直接照做。
商业价值
该仓库的直接商业化价值受限，因为衍生 CAD/图纸包含非商业许可限制，并且复刻成本可能高于官方整机售价。它更适合作为研发参考、教学案例、机器人逆向工程方法论、小型双足机器人设计资料和内部技术验证材料。对机器人公司或实验室而言，价值主要体现在缩短竞品结构分析时间、理解 Microduck 的设计取舍、辅助自研小型双足平台、电控替代方案评估以及 sim-to-real 研究；不适合作为可直接商用生产的开源硬件方案。
01
技术亮点
- 中文文档非常完整，适合中文开发者阅读和复现。
- 从官方 MJCF 和 STL 中还原出完整装配关系，解决了原始 STL 直接导入会堆在原点的问题。
- 提供已应用世界变换的 CAD STL，能够直接导入 CAD 软件查看整机装配状态。
- 包含 7 张装配/爆炸图，便于理解 15 个刚体部件和左右腿镜像关系。
- 明确列出整机质量、外形尺寸、关节行程、运动链和质量分布。
- 对紧固件、执行器、硬件方案、电池、传感器和主控进行了较深入的逆向分析。
- 指出仿真 STL 与可打印工程件之间的差异，风险提示较诚实。
- 包含构建日志，记录实际打印和装配验证过程，而不只是纸面推导。
- 对成本、许可、商用限制和策略重训问题有明确说明。
- 项目将机械复刻、电控自建、官方软件/策略复用之间的边界讲得比较清楚。
02
目标用户
- 希望研究 Microduck 机械结构的机器人开发者
- 关注双足机器人硬件设计的学生、创客和研究人员
- 需要从 MJCF/STL 还原 CAD 装配关系的工程师
- 想复刻或改造小型双足机器人的硬件爱好者
- 从事 MuJoCo 仿真、机器人强化学习和 sim-to-real 的开发者
- 希望了解 Microduck 电控架构、舵机选择和传感器配置的嵌入式开发者
03
配置要求
- Python 运行环境。
- Python 依赖：mujoco、numpy、pillow、scipy。
- 可用的 OpenGL 渲染环境，用于重新生成装配图。
- 需要拉取上游 microduck_rl 仓库以获得官方 MJCF 和 STL 资源。
- CAD 查看或编辑建议安装 FreeCAD、Fusion 360、SolidWorks、Blender 或其他支持 STL 的软件。
- 如果进行实物复刻，需要 3D 打印能力、M2 紧固件、轴承、Dynamixel XL330 舵机、电池、主控、IMU/传感器板和自制或替代电控板。
- 如果使用官方 Rust 运行时，需要关注其与 RK3566/Radxa Zero 3W 等硬件平台的绑定关系。
- 如果更换电控或结构，需要考虑重新训练 Microduck 强化学习策略。
04
适用场景
- 查看 Microduck 的装配爆炸图、运动链结构和刚体分组
- 将已对齐的 STL 装配体导入 FreeCAD、Fusion 360、SolidWorks、Blender 或切片软件
- 基于官方 MJCF 模型重新生成装配图和 CAD STL
- 分析 Microduck 的 14 个受控关节、行程、质量分布和惯量信息
- 评估 Dynamixel XL330 舵机在小型双足机器人上的使用方式
- 参考紧固件、轴承、电池、传感器和主控方案进行机械复刻
- 学习如何从仿真 STL 和源码反推出硬件装配与电控架构
- 作为 Microduck RL 策略重训、硬件替换或自建电控方案的前期资料
05
部署与配置
- 克隆本仓库到本地。
- 安装 Python 环境，建议使用虚拟环境。
- 安装依赖：mujoco、numpy、pillow、scipy。
- 执行 `bash scripts/fetch_upstream.sh` 拉取上游 microduck_rl 仓库，本仓库不重复托管官方资源。
- 执行 `python scripts/render_assembly.py upstream/microduck_rl assembly-drawings` 重新生成装配图。
- 执行 `python scripts/export_assembly_stl.py upstream/microduck_rl cad` 重新导出 CAD 装配体。
- 执行 `python scripts/analyze_holes.py upstream/microduck_rl/src/mjlab_microduck/robot/microduck/assets` 重新扫描孔特征。
- 如果需要渲染图片，需要本机具备可用的 OpenGL 上下文；在无显示服务器的 Linux 环境中可能需要配置 EGL、OSMesa 或虚拟显示。
06
风险与注意事项
- 许可证存在明显商用限制：assembly-drawings 和 cad 受 CC BY-SA-NC 4.0 约束，不得商用；整体仓库 license 显示为 NOASSERTION，需要使用者仔细核对 NOTICE。
- 仿真 STL 不是可打印工程件，可能缺少公差、螺纹孔、热熔螺母座、走线空间和真实装配细节。
- 虽然机械装配关系较完整，但实际复刻仍需要大量工程修正和试错。
- 官方硬件并未完全开源，PCB 原理图、BOM、走线方案仍存在缺口或需要自行设计替代。
- Dynamixel XL330 数量多，个人采购成本可能高于购买整机，商业上不一定划算。
- 官方 ONNX 策略主要适配原始硬件，电控、质量、摩擦、舵机或结构变化后可能需要重新训练。
- Rust 运行时和底层硬件平台存在绑定关系，移植到非官方硬件可能有兼容性问题。
- 项目属于逆向研究，与 Pollen Robotics 无隶属关系，也未获官方背书，长期维护和法律/社区风险需自行评估。
- 实物复刻需要机械、电控、嵌入式、机器人控制和强化学习等多领域能力，门槛较高。
2026-09-03
第26名
新收录 · github_search
