上传是整个流程里唯一需要你动手的一步。把原始文件或文件夹拖进来,确认它们会被分成哪几条录制,然后开始上传。文件一到,项目的工作流就会自己开始处理,不需要写任何脚本。
上传录制
打开上传页
在项目里打开「录制」,点击右上角的「上传数据」。也可以在项目页某个项目行的「⋯」菜单里选择「上传」。上传需要项目的所有者、编辑者或上传者角色。
选择数据来源并填写任务
「数据来源」列出可以上传的格式,尚未开放的格式会标注即将推出,暂时不能选择。机器人项目还需要填写「任务」:写清楚这次上传里机器人做了什么,例如 把烤肠放到烤架上。留空就使用项目的默认任务;如果项目没有默认任务,这一栏必填。
添加文件或文件夹
把文件或文件夹拖到「将录制拖到这里」,或者点击「选择文件」「选择文件夹」。每个文件夹成为一条录制,单独的机器人 MCAP 文件也各自成为一条录制。如果添加了几个零散文件,可以在上传前把它们合并成一条录制。
确认上传计划
页面会读取文件,告诉你将要创建什么,例如“将从 1 个文件创建 1 条录制”。「本次导入的格式」显示它识别出的格式,例如「机器人 MCAP」;如果文件符合多种格式,请选择与录制一致的那一种。「待上传的录制」里,每条录制都有可编辑的「录制名称」。如果已有同名录制,点击「加上日期」或「加上编号」即可区分。
下方的「估算」会给出大致的处理时长、费用和占用的存储。如果这次上传会超出配额,就无法开始。
开始上传
点击「开始上传」。进度条显示已上传的文件数。全部文件到齐后,录制随即创建,页面出现绿色的「已开始处理」提示,附带「查看运行」链接,新录制列在「已创建的录制」下面。
上传之后会发生什么
上传完成后不用做任何设置,项目的工作流会自动开始处理:先把原始文件统一转成 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 天内可以恢复。