EmbodiFlow文档
开始使用数据工作流与算法训练与部署开发者参考
  • 数据

数据接入

  • 项目
  • 上传录制
  • 采集任务单

查看与复核

  • 回放与可视化
  • 任务片段与标注
  • 质量检查

数据集

  • 数据集版本
  • 导出与下载

© 2026 EmbodiFlow

llms.txtOpenAPI JSON
  1. 数据
  2. 数据接入
  3. 上传录制

上传录制

把录制拖进浏览器,剩下的交给项目工作流。

上传是整个流程里唯一需要你动手的一步。把原始文件或文件夹拖进来,确认它们会被分成哪几条录制,然后开始上传。文件一到,项目的工作流就会自己开始处理,不需要写任何脚本。

上传录制

1打开上传页

在项目里打开「录制」,点击右上角的「上传数据」。也可以在项目页某个项目行的「⋯」菜单里选择「上传」。上传需要项目的所有者、编辑者或上传者角色。

2选择数据来源并填写任务

「数据来源」列出可以上传的格式,尚未开放的格式会标注即将推出,暂时不能选择。机器人项目还需要填写「任务」:写清楚这次上传里机器人做了什么,例如 把烤肠放到烤架上。留空就使用项目的默认任务;如果项目没有默认任务,这一栏必填。

3添加文件或文件夹

把文件或文件夹拖到「将录制拖到这里」,或者点击「选择文件」「选择文件夹」。每个文件夹成为一条录制,单独的机器人 MCAP 文件也各自成为一条录制。如果添加了几个零散文件,可以在上传前把它们合并成一条录制。

4确认上传计划

页面会读取文件,告诉你将要创建什么,例如“将从 1 个文件创建 1 条录制”。「本次导入的格式」显示它识别出的格式,例如「机器人 MCAP」;如果文件符合多种格式,请选择与录制一致的那一种。「待上传的录制」里,每条录制都有可编辑的「录制名称」。如果已有同名录制,点击「加上日期」或「加上编号」即可区分。

下方的「估算」会给出大致的处理时长、费用和占用的存储。如果这次上传会超出配额,就无法开始。

5开始上传

点击「开始上传」。进度条显示已上传的文件数。全部文件到齐后,录制随即创建,页面出现绿色的「已开始处理」提示,附带「查看运行」链接,新录制列在「已创建的录制」下面。

在所有文件到齐之前请不要关闭页面,离开页面会中断上传。

上传之后会发生什么

上传完成后不用做任何设置,项目的工作流会自动开始处理:先把原始文件统一转成 LeRobot v3,再做质检、人脸脱敏,并准备好任务片段。一条机器人录制对应一个任务片段。点击「查看运行」可以看到每一步的进度,录制就绪后也可以直接打开它。每次上传还会记录在页面底部的「上传批次」里,进行中的排在前面。

匿名化完成之前,只有上传者、所有者,以及同时能编辑算法和管理工作流的成员可以打开原始文件。导出时始终会检查匿名化。

支持的格式

每个项目只接受与其种类匹配的格式。标注即将推出的格式会出现在列表里,但暂时不能上传。

种类格式上传什么状态
机器人MCAP包含机器人话题、相机和关节数据的 .mcap 文件,每个文件成为一条录制。可用
机器人LeRobot 文件夹每条录制一个文件夹,根目录包含 meta/info.json、data 和 videos。如果工作流需要分集元数据,再加上 meta/episodes.jsonl。可用
机器人ROS bag、ROS 2 db3、HDF5.bag、.db3、.h5 或 .hdf5 文件。即将推出
人类MCAP每条录制一个文件夹,放入 .mcap、对应的 metadata.yaml、设备导出的 device_meta.json(必需),有 status 文件夹的话也一起放入。可用
人类LeRobot 文件夹与机器人 LeRobot 文件夹相同的结构。可用
人类视频、BVH、Aria VRS、UMI GoPro固定机位视频、动作捕捉和其他采集设备。即将推出

带音频的第一人称录制会被拒绝,缺少 device_meta.json 的人类 MCAP 也会被拒绝。如果页面提示当前部署未启用第一视角数据,请联系团队管理员。

文件没被添加或上传中断

项目不接受的文件会被跳过,页面会说明原因,例如「不是本次上传支持的类型」或「不是有效的 MCAP 文件」。文件夹结构的问题,比如 LeRobot 文件夹缺少 meta/info.json,会列在「需要确认的问题」里,修复后才能开始上传。

如果有文件没传上去,点击「继续上传失败或未完成的文件」,已经到达的文件不会重复上传。如果文件都到了但录制没有创建成功,点击「重试创建录制」。

用命令行上传

批量上传或自动化采集时,可以用 embodiflow 命令行,效果和网页上传一样。例如 embodiflow recordings upload ./recordings/rec-0001 --project <team>/<project> --name rec-0001 会上传一条命名录制。按文件夹批量上传和其他选项见 CLI 参考。

录制列表

项目侧边栏的「录制」列出全部录制。每一行显示状态、来源、上传时间、任务片段数和隐私状态。你可以按名称搜索,也可以按处理状态、切分、数据来源、上传日期和任务片段数筛选。

状态含义
「上传中」文件还在上传。
「处理中」项目工作流正在处理这条录制。
「就绪」处理完成,此后显示检查结果。
「失败」处理失败。打开录制可以看到失败的步骤和原因。
「已停滞」超过 1 小时没有进展。请重新处理,或删除后重新上传。
「已取消」这次运行被取消了。

录制就绪后,状态标签会显示检查结果:「检查通过」「有警告」「检查未通过」「检查出错」「未检查」或「无适用检查」。只有「检查通过」是绿色的,其余结果都需要你看一眼,不能当作通过。详见 质量检查。

「重新处理」会对录制再运行一次项目工作流;勾选多行可以一起重新处理,之前的结果都会保留。行尾「⋯」菜单里的「移入回收站」会把录制从列表移走,30 天内可以恢复。

下一步

  • 回放与可视化
  • 工作流运行
  • 质量检查
上一页

项目

下一页

采集任务单