SuperAPI AI 工具集

wuji-cli-record

通用与其它

查看项目

更新于 10-16 06:12

技能介绍

用途:wuji record teleop 是前台、只读的观测器。需先启动已有的 Glove 到 Hand 2 遥操作程序,再在第二个终端运行录制。录制器附着到设备所有者的共享会话,不发布命令,也不会接管断开的设备。

主要能力:受管 MCAP 包含固定遥操作预设——Glove 的 emf_poses 与 hand_skeleton、全局 tf 与 tf_static、Hand 2 的 joint_command 与 joint_states,以及可用时的 joint_diagnostics。录制使用:wuji record teleop;当有多个设备活跃时用 wuji record teleop --glove <GLOVE_SN> --hand <HAND_SN> 指定配对。

停止与输出:用 Ctrl+C 停止,或仅发送一次 SIGTERM(kill <PID>),然后等待最终 stopped 报告。在 MCAP 收尾期间不要再次发送信号、取消命令或杀进程,再次发送会导致退出码 130 并可能留下未收尾的部分录制;kill -9 无法处理,可能留下中断的未收尾文件。正常情况下 CLI 会收尾 MCAP、更新 manifest、分离两个只读会话,并保留遥操作所有者继续运行。TTY 终端每 5 Hz 收到紧凑心跳,非 TTY 每 30 秒追加一次;--json 仅输出最终报告,--jsonl 输出 started、周期进度与最终 stopped 记录。

历史与导出:wuji record list、wuji record list --days 7、wuji record list --json 查看历史;wuji logs export --recording <RUN_ID> -o support.zip 导出。运行记录存放于 ~/.wuji/recordings/<RUN_ID>/,含 manifest.json 与 recording.mcap。logs export 仅在用可重复的 --recording 显式选择时包含录制,日期过滤不会自动加入。

限制与隐私:MCAP 及其 manifest 含原始运动/控制数据,未做脱敏;文件在用户显式导出或分享前保留在本地;遥测不上传 MCAP;录制时长仅在成功停止后报告。常见错误包括未找到活跃遥操作会话、发现多个设备、附着失败、所需通道不可用、录制为部分状态,需按提示检查设备可见性、共享开启、固件与 SDK 用户配置匹配,并查看摘要后的警告行判断 recording.complete。