LeRobot Studio

LeRobot Studio 在浏览器内播放并检查 LeRobot 格式数据集，数据不离开本机。平台在 数据 → LeRobot（路由 /lerobot）内嵌该组件，用于查看平台内已入库或已导出的 LeRobot 数据；独立站点可打开本地文件夹或压缩包。数据格式与训练接入见 LeRobot 数据集与训练 与 LeRobot v2 与 v3 格式差异。

适用角色与前提

适用角色

角色	使用场景	前置权限
项目经理	导出前抽样核对多视角视频与状态、动作曲线是否对齐	「数据列表」
算法工程师	训练前核对 episode 数量、帧率与标注字段	「数据列表」
管理员	查看任意项目下的 LeRobot 数据	不受模块权限限制

前置条件

项	要求
菜单入口	数据 → LeRobot
路由	/lerobot
必需权限	「数据列表」
数据格式	LeRobot v2.0、v2.1 或 v3.0
浏览器	选择本地目录依赖 File System Access API，仅 Chrome 与 Edge 支持
数据来源	平台导出记录、本地目录、本地压缩包、远程 URL

操作步骤

1. 登录平台，展开侧栏 数据，点击 LeRobot。
2. 在欢迎页选择数据来源；也可将本地文件夹或压缩包直接拖入页面。
3. 数据加载完成后，在左侧「任务」标签中选择 episode，在「分析」标签查看汇总统计。
4. 用播放控制栏定位时间点，在视频、图像、折线图与原始消息面板之间对照。
5. 打开「数据集健康检查」核对格式校验结果，按修复建议处理问题。

数据接入方式：

接入方式	入口	支持范围	约束
导出记录	欢迎页左侧「导出历史」	平台状态为已完成的 LeRobot 导出	点击记录后由平台签发下载地址
本地目录	选择本地目录	解压后的 LeRobot 数据集根目录	仅 Chrome 与 Edge
本地压缩包	选择本地压缩包	.zip、.tar、.tar.gz、.tgz	压缩包内需为数据集根目录
远程 URL	输入远程 URL	当前浏览器可访问的下载地址	受跨域策略与链接有效期限制

界面面板

面板	作用	可执行操作
任务侧栏	列出数据集中的 episode 及其长度与任务	搜索、筛选、选择、批量编辑、批量删除、批量恢复
分析侧栏	汇总集数、总帧数、总时长与任务分布	查看
视频面板	播放 dtype 为 video 的字段	随播放控制栏同步播放
图像面板	显示 dtype 为 image 的字段当前帧	查看当前帧
折线图面板	绘制状态、动作等数值字段的时序曲线	选择特征、按关节过滤、分屏对比
原始消息面板	显示当前帧的原始数据结构	选择特征、搜索特征、复制图像、下载二进制、暂停与继续刷新
播放控制栏	帧级播放控制	播放与暂停、上一帧、下一帧、倍速、播放模式切换、时间轴定位
数据集健康检查	展示格式校验结果	查看错误、警告与通过项，导出 CSV 或 PDF

结果校验

校验项	通过标准
健康检查状态	显示「格式检查通过」，无错误与警告
episode 数量	「分析」标签的集数与 meta/info.json 的 total_episodes 一致
时间轴对齐	多路视频与状态、动作曲线在同一时间点对齐
字段完整性	features 中的图像、状态、动作字段均可加载并在面板中显示

异常处置

现象	可能原因	处置	责任方
远程数据加载失败	跨域限制、网络异常或下载链接过期	从导出记录重新获取地址；确认地址可在当前浏览器访问	操作方
本地目录无法打开	浏览器不支持 File System Access API	改用 Chrome 或 Edge，或改为打开压缩包	操作方
压缩包无法打开	归档格式不受支持	使用 .zip、.tar、.tar.gz 或 .tgz	操作方
健康检查报 codebase_version 不匹配	数据集格式版本与加载器不一致	按「修复建议」调整 meta/info.json 或重新导出	数据导出方
健康检查报 episode 数量不一致	meta/episodes 与 info.total_episodes 不一致	按「修复建议」重新生成 episode 元数据或修正 total_episodes	数据导出方

相关页面

页面	用途
LeRobot 数据集与训练	导出与训练总览
LeRobot v2 与 v3 格式差异	两种格式的目录、元数据与校验差异
LeRobot 可视化	平台内 LeRobot 入口的权限与场景
数据导出	生成 LeRobot 训练包