Quick Start：从注册、开发到训练部署
背景与适用范围
本指南面向使用 R2 机器人进行二次开发的用户，覆盖整体基本流程，包含账号注册、设备接入、SDK 二次开发，以及数据准备、模型训练、部署和实机验证等步骤。
- RobbyantStudio：账号注册与服务开通入口。
- RobbyantModels：设备与运行环境管理、数据管理、模型训练和部署平台。
- RobbyantGo（手机端和电脑端）：机器人配套客户端，用于设备连接、激活及现场操作。
- RFrame SDK：二次开发接口，用于接收机器人数据、调用控制接口和开发业务。
操作流程
完整路径： 注册并开通服务 → 接入设备 → 准备运行环境 → SDK 二开 → 准备数据 → 发布数据集 → 训练 → 推理加速 → 部署 → 验证与迭代。
下表链接按“文档名称 → 章节名称”标明查阅位置。
| 步骤 | 你需要做什么 | 去哪里查看详细操作 |
| 1. 注册 RobbyantStudio 平台，开通 RobbyantModels 服务 | 申请试用，收到邀请后注册账号，登录并开通 RobbyantModels。完成后应能进入 Models。 | 《RobbyantModels 产品文档》→「快速入门」 |
| 2. 接入设备 | 确认 R2 已划拨到账号下，通过 RobbyantGo 手机端配网激活；若找不到设备，请联系交付人员。完成后确认平台已识别目标设备。 | 《R2 产品手册》→「RobbyantGo 手机端使用说明／连接与配网」；《RobbyantModels 平台使用最佳实践》→「环境准备／设备激活&登记／灵波 R2」。 |
| 3. 准备运行环境 | 在 Models 中部署与设备兼容的运行环境，检查设备在线状态、机型配置及相机信息；使用闭源模型时绑定目标设备所需的 License。完成后确认运行环境正常。 | 《RobbyantModels 平台使用最佳实践》→「环境准备」，包含运行环境部署、配置检查和 License 绑定。 |
| 4. 开始 SDK 二开 | 确认 SDK 开发环境已就绪，运行示例，跑通图像获取、状态读取和运动控制，再开发自己的业务。 | 《SDK 二开接口开发示例》→「前置条件」及第 1～10 步。 |
| 5. 准备数据 | 在 Models 创建采集任务，通过设备端执行并上传结果；也可以直接导入已有数据。完成后确认数据已进入平台，能够回放，并形成数据集草稿版本。 | 云上操作见：《RobbyantModels 平台使用最佳实践》→「采集或导入数据」；现场操作见 《R2 产品手册》→「RobbyantGo 电脑版使用说明／业务模块-开发模型控制台／数采」。 |
| 6. 检查并发布数据集 | 回放检查数据、完成质检，满足发布条件后发布可用于训练的数据集版本。 | 《RobbyantModels 平台使用最佳实践》→「检查并发布可训练数据」 |
| 7. 训练模型 | 选择基础模型和已发布的数据集，配置并运行训练，查看训练结果；继续训练时可按文档选择已有模型或 Checkpoint。完成后在「我的模型」确认产物。 | 《RobbyantModels 平台使用最佳实践》→「创建并运行模型调优任务」 |
| 8. 准备部署产物 | 在「我的模型」核对训练产物及来源，确认已完成与目标设备匹配的推理加速；未完成时发起加速。 | 《RobbyantModels 平台使用最佳实践》→「管理模型产物」 |
| 9. 部署到设备 | 选择推理加速产物和目标设备，发起端侧部署，确认部署成功、服务运行正常。 | 《RobbyantModels 平台使用最佳实践》→「部署模型／端侧部署」 |
| 10. 验证并迭代 | 在设备上验证实际任务效果；根据结果补充数据，再训练和部署。记录数据集、模型版本及验证结果，便于追溯。 | 《RobbyantModels 平台使用最佳实践》→「验证服务」及其后的「常见问题处理」。设备端推理启动与操作指南待补。 |
注意事项
- 按目标选择路径：只做 SDK 二开，可在准备好设备和开发环境后进入第 4 步；只做 Models 训练与部署，可跳过 SDK 二开。已有数据可直接导入，无需现场采集。
- 区分两种环境：SDK 开发环境与 Models 运行环境需分别确认。Models 运行环境部署成功，不代表 SDK、消息包和编译依赖已准备完成。
- 运动前先完成安全检查：首次操作请先阅读 《R2 产品手册》→「前置声明」。SDK 示例先预览、后执行，按示例核对构型及现场条件，确保物理急停可触达。
- 确认采集数据真正回传：现场采集时检查客户端自动上云配置，并确认云端已收到 Episode。本地采集结束不等于云端数据已就绪。
- 保持数据与设备匹配：数据集、训练任务和部署设备的机器人型号、构型及适配算力应满足文档要求；训练使用已发布且兼容的数据集版本。
- 部署前检查设备状态：设备应在线、运行环境正常、所需授权有效，且没有执行关键任务。端侧部署使用适配目标设备的推理加速产物。
- 以实际任务效果验收：部署成功和服务运行中只代表部署环节完成，仍需实机验证业务目标。记录使用的数据集版本、模型版本、设备和测试结果。