保姆级入门指南 | 从零开始，完成你的第一次M-Robots贡献

你是否有过这样的困惑：想参与开源社区，但不知道从哪里下手？看到几百个代码仓库，却不知道怎么找到适合自己的那一块？
M-Robots社区已经汇聚12家产学研共建单位，开源600+个仓库，覆盖中间件、可视化调试、AI智能体等全套工具。但对于刚接触社区的开发者来说，第一步往往最难—— 环境怎么搭？代码怎么编？板子怎么烧？贡献从哪里开始？
这篇文章，就是为你准备的。
我们将以一块开鸿开发板KHD-3588A开发板为例，带你走完从环境搭建到首次贡献的完整流程。

一、先了解：M-Robots社区是什么？

M-Robots是由开放原子开源基金会孵化及运营的开源机器人操作系统项目，依托开源鸿蒙底座，聚焦机器人全域操作系统，致力于简化机器人开发流程、降低研发成本。
社区为开发者规划了清晰的成长路径，从G1新手参与者到G5社区领袖，每一步都有对应的贡献方式和激励回报。

二、环境准备：你的第一台“工作台”

2.1 硬件准备

必备硬件：

• 调试电脑：一台Windows PC（用于执行烧录操作的PC）
• 一块开鸿开发板KHD-3588A（含12V/3A电源适配器）
• 一根Type-C数据线
• 一块HDMI屏和连接线（可选）

如果没有开发板怎么办？
先不急着买板子。社区提供了完整的系统文档和固件下载，你可以完成基础贡献：

基础贡献
【参与社区讨论】
M-Robots 社区提供讨论区功能，开发者可以在此进行技术讨论、求助答疑、分享经验、提出创意等。社区讨论区分为以下分类：

• 公告：社区官方公告、重要通知
• 开放讨论：自由发起的技术话题讨论
• 问答求助：遇到问题提交Issue寻求帮助
• 分享和展示：分享项目成果、使用体验
• 想法或创意：提出新功能、新想法

2.2 编译环境搭建

在开始编译之前，需要准备好Ubuntu编译环境。
基础环境要求：

• 操作系统：Ubuntu 22.04.5 LTS（x86_64）
• 磁盘空间：400GB及以上
• 内存：32GB以上

安装编译依赖：
在Ubuntu终端中执行以下命令安装必需的编译工具：

sudo apt update
sudo apt install -y git curl python3 python3-pip
sudo apt install -y build-essential cmake ninja-build
sudo apt install -y libssl-dev libncurses-dev

配置repo工具：
M-Robots采用多仓管理方式，需要使用repo工具来同步所有代码仓库：

mkdir ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
export PATH=~/bin:$PATH

如果无法访问Google源，可以使用国内镜像源替代。

三、获取源码：把整个项目“搬”回家

3.1 初始化repo仓库

mkdir ~/m-robots
cd ~/m-robots
repo init -u https://atomgit.com/m-robots/mrobots_manifest.git -b M-Robots_6.1_Release

3.2 同步代码

repo sync -c -j8

这一步会拉取M-Robots OS的所有源码仓库。根据网络情况，可能需要30分钟到数小时。建议使用-j8参数（8个并发），如果网络较慢可以调整为-j4。

四、编译与烧录：让系统“跑起来”

4.1 编译M-Robots OS

代码同步完成后，进入编译目录执行编译命令：

cd ~/m-robots
./build.sh --product-name khd_rk3588_a --ccache

编译过程可能需要较长时间（视电脑性能而定）。编译成功后，会在out目录下生成镜像文件。

4.2 固件烧录

准备烧录工具：

• 下载并安装RKDevTool（瑞芯微官方烧录工具）
• 下载HDC工具用于设备连接验证

烧录步骤：

1. 让开发板进入Loader模式（通常按住恢复键再上电）
2. 打开RKDevTool，识别到设备后加载编译生成的镜像
3. 点击“执行”开始烧录，等待完成
4. 烧录成功后，设备自动重启

验证烧录：
使用HDC工具验证设备连接：

hdc list targets

如果能看到设备序列号，说明烧录成功。

五、完成你的首次贡献：从Star开始

现在你已经有了一个可以运行的M-Robots OS环境。接下来，就是参与社区共建的时刻了。
M-Robots社区的贡献路径非常清晰，不需要一开始就写代码，任何有价值的参与都是贡献。

5.1 G1：完成基础参与

这是你的第一步。只需要完成以下任意一项：

• 注册社区账号，签署CLA（贡献者许可协议）
• 关注M-Robots社区，给感兴趣的仓库点亮Star
• 提交第一个Issue：在使用过程中遇到任何问题，都可以在对应仓库提交Issue反馈
• 参与讨论：在“社区讨论”或社群中参与技术讨论

5.2 G2：完成首次有效贡献（进阶）

当你对系统有了一定了解后，可以尝试：

• 提交文档优化PR：发现文档中有错别字或表述不清的地方，提交修改
• 补充示例代码：为某个功能模块编写一个简单的使用示例
• 提交Bug修复：解决一个被标记为good-first-issue的简单问题

5.3 G3+：深度参与，持续成长

随着贡献积累，你可以：

• 加入SIG技术组：社区设有13个SIG组，覆盖确定性通信、分布式融合感知、多机协同、AI Runtime等方向
• 参与核心代码开发：成为某个模块的维护者
• 申请K-Star激励计划：高校学生可申报“新锐”奖（2万元），优秀团队可申报“创业新星”奖（10万元）

社区奖励机制

• 每完成一项操作（Star、Issue、Fork、PR等），将获得相应的积分奖励；
• G1、G2 为名誉与成长支持档位，不发放实物奖励；
• 自 G3 起，满足对应等级全部晋级条件后，每升一级即解锁一档实物奖励，等级越高奖励价值越高；
• 每档实物奖励每位开发者原则上仅可领取一次，达到更高等级后可继续领取更高档位。

六、遇到问题怎么办？

技术问题：

• 在对应仓库提交Issue，社区维护者会及时跟进
• 加入M-Robots社区社群，和其他开发者交流

新手问题：

• 查看社区讨论区的“新手问答”板块
• 关注社区发布的入门教程和视频

七、下一步：你可以做什么？

完成首次贡献后，建议你：

1. 选择一个SIG方向深入参与：13个SIG组各有侧重，找到你最感兴趣的方向
2. 参与社区赛事：M-Robots社区定期举办黑客松和开源贡献赛
3. 分享你的经验：把你在使用M-Robots过程中的实践经验写下来，投稿给社区

开源不设限，共建正当时。
从点亮一个Star开始，从提交一个Issue开始——你的每一份贡献，都在推动国产机器人操作系统生态向前一步。

关于M-Robots OS：
M-Robots OS是基于开源鸿蒙的分布式异构多机协同机器人操作系统。
M-Robots OS以开源鸿蒙为核心底座，具备积木式框架、混合部署、M-DDS、分布式多机协同、AI Agent多模态交互以及生态兼容六大核心能力，打通异构机器人壁垒，构建机器人、人与环境的深度协同，实现异构多机器人实时协同、多硬件形态兼容、AI能力原生深度融合。广泛应用于智能制造、智慧清扫、智慧农业、智慧巡检、科研教育等领域，推动机器人产业实现从“单体智能”到“群体智能”的跨越式升级。参与方式：
开发者可通过官网注册参与代码贡献：https://atomgit.com/m-robots；
企业与高校可申请加入SIG技术组，共同推进标准制定与产业落地。
社区官方社群：