集成应用场景：

日志、错误与运行验收

平台应为每次录制建立 run ID，至少记录：机器人设备 ID、软硬件版本、请求时间、动作、HTTP 状态、录制器 status、落盘目录、字节数、MCAP 起止时间、必需 Topic 计数和审批后的清理结果。日志不得包含 token、Authorization 头、SSH 密码或完整业务请求体。

现象	处理
HTTP 400 / 411 / 413	修正 JSON、严格四字段元数据或 Content-Length；请求未进入 ROS2 调用
HTTP 401	核对 token 注入、轮换和客户进程环境；不得在日志中输出凭据
HTTP 502 / ROS2 超时	命令结果不确定；查录制中目录、完成目录和 recorder 状态，不盲目重试 start
连续两次 start 或其他客户端介入	暂停自动化，确认机器人级控制权；进程内锁不代表分布式互斥
stop 成功但 list 暂无目录	等待目录从 mcap_recording 移入 mcap_recorded；超时后保留现场日志
文件已拉取但解析失败	不删远端；核对文件完整性、MCAP 版本、schema 和序列化格式

集成上线的最小验收是：只读连通通过；错误 token 全部被拒绝；唯一 run ID 的 start → stop → list 通过；精确目录拉取通过；MCAP 起止时间、Topic 与计数通过；磁盘告警可见；精确目录清理只在独立授权后执行；桥重启和 token 轮换后能恢复。