Ros2Supervisor：Webots与ROS 2仿真实时交互的核心枢纽

1. 项目概述：一个被低估的仿真控制枢纽

你正在看的，不是某个冷门插件的说明书，而是一个在Webots+ROS 2协同仿真工作流中真正起承转合的关键节点——Ros2Supervisor。它不像ros2_control那样被反复拆解，也不像nav2那样自带生态光环，但它恰恰是那些“本该能做、但总卡在仿真层”的任务得以落地的底层支点。我带过三届机器人方向的毕设学生，几乎所有人第一次尝试动态加载传感器模型、实时修改世界参数、或导出带交互逻辑的HTML5动画时，都会卡在“怎么让ROS 2命令穿透到Webots内核”这一步。直到他们把Ros2Supervisor加进launch文件，才真正意识到：原来仿真世界不是只读的沙盒，而是可编程的活体系统。

这个节点的核心价值，从来不是“多了一个服务”，而是重建了ROS 2与Webots Supervisor API之间的可信信道。它不处理运动学，不解析SLAM地图，但它让/clock时间戳精准同步、让spawn_node_from_string能像调用本地函数一样注入新机器人、让animation_start_recording直接生成可嵌入网页的3D回放。如果你正在做需要动态重构仿真环境的任务——比如测试多机协同时临时添加障碍物、验证视觉算法时切换不同光照模型、或是为教学演示生成可分享的交互式动画——那么Ros2Supervisor就是你工作流里那个沉默但不可替代的“调度员”。它适合两类人：一类是已经跑通基础仿真、正卡在高级交互需求上的ROS 2开发者；另一类是Webots老用户，想绕过手动编辑.wbt文件、用ROS 2原生方式管理仿真世界的人。下面我会从设计逻辑、实操细节、避坑经验三个维度，带你把它真正用起来，而不是只停留在文档里的几个命令行示例。

2. 设计思路拆解：为什么必须用Supervisor模式？

2.1 Supervisor的本质：Webots世界的“操作系统内核”

很多人误以为Supervisor只是个“有更高权限的机器人”，其实这是根本性误解。在Webots架构里，Supervisor不是一个节点类型，而是一种运行时角色。当你把一个Robot节点的supervisor字段设为TRUE，你不是在给它加权限，而是在告诉Webots：“请把这个节点提升为当前仿真实例的管理进程”。它获得的能力包括：遍历整个世界树（getFromDef()）、动态插入/删除节点（importMFNodeFromString()/remove()）、控制仿真步进（simulationSetMode()）、甚至读取物理引擎状态（getPhysics()）。这些API在普通机器人控制器里是完全不可见的——就像你不能在用户态程序里直接调用mmap()去操作物理内存页表一样。

Ros2Supervisor的设计精妙之处，就在于它把这种“内核级能力”通过ROS 2标准接口做了安全封装。它没有暴露原始C++ API，而是将高频操作映射为服务（Service）和话题（Topic），比如spawn_node_from_string对应importMFNodeFromString()，remove_node对应remove()。这种设计规避了两个致命风险：一是避免ROS 2节点因错误调用导致Webots崩溃（Supervisor API调用失败通常返回NULL，而ROS 2服务会返回success: false）；二是天然支持跨进程通信——你的导航节点、感知节点、规划节点可以各自独立发布/调用服务，无需共享内存或复杂IPC。

提示：Supervisor节点在Webots中默认不启用GUI渲染加速，这意味着它的CPU占用极低。我实测过，在100Hz仿真步频下，一个纯Supervisor节点的CPU占用率稳定在0.3%~0.7%，远低于一个带激光雷达插件的差速机器人（平均4.2%）。这不是巧合，而是Webots刻意为之的设计：Supervisor只负责逻辑调度，渲染交给独立的GUI线程。

2.2 为何必须用extern controller？而非plugin？

这里有个关键细节常被忽略：Ros2Supervisor必须以extern controller方式启动，而不是作为Webots plugin嵌入。原因在于生命周期管理。Plugin的生命周期与Webots主进程强绑定——一旦Webots崩溃，plugin必然终止；而extern controller是独立进程，可通过ROS 2的launch system实现优雅重启。更重要的是，extern controller能天然继承ROS 2的参数系统和日志框架。比如当你要调试spawn_node_from_string失败时，直接ros2 param set /Ros2Supervisor log_level debug就能看到Webots底层API的返回码，而plugin的日志只能打到Webots控制台，无法被ros2 log统一收集。

我在调试一个PROTO导入失败的问题时，就深刻体会到这个设计的价值。当时spawn_node_from_string返回success: false但无任何错误信息。我把log_level调成debug后，在ROS 2日志里立刻看到一行关键输出：[ERROR] [1712345678.123456789] [Ros2Supervisor]: importMFNodeFromString failed: EXTERNPROTO 'my_sensor' not found in world file。这直接指向了.wbt文件里缺少EXTERNPROTO "my_sensor"声明的问题。如果是plugin，这条日志可能就淹没在Webots的数千行启动日志里，排查时间至少增加3小时。

2.3 Clock同步机制：为什么它是use_sim_time的刚需？

很多开发者遇到/tf变换延迟、rqt_graph显示节点断连，最后发现根源竟是/clock不同步。Ros2Supervisor发布/clock的逻辑非常务实：它不自己维护时间，而是每帧从Webots仿真引擎拉取当前仿真时间戳（通过wb_robot_get_time()），然后以builtin_interfaces/msg/Time格式发布。这个时间戳的精度取决于Webots的basicTimeStep设置——如果basicTimeStep=32ms，那么/clock的更新频率就是31.25Hz，且严格对齐仿真步进。

关键点在于：/clock的发布时间与仿真步进完全同步。这意味着当你的导航节点设置了use_sim_time:=true，它收到的每一个/clock消息，都对应Webots中一个确定的仿真状态。我做过对比实验：在相同basicTimeStep=16ms下，用Ros2Supervisor发布的/clock，amcl定位的协方差矩阵收敛速度比用ros2 run tf2_tools static_transform_publisher硬编码时间快2.3倍。因为后者的时间戳是系统时钟，与仿真步进存在相位差，导致TF树在时间轴上出现“抖动”。

注意：Ros2Supervisor不会自动设置use_sim_time参数。你必须显式在所有依赖仿真的节点中配置。常见错误是只在launch文件里给Ros2Supervisor设了use_sim_time:=true，却忘了给robot_state_publisher或joint_state_publisher设。正确做法是在launch文件中统一设置：

from launch.actions import SetEnvironmentVariable # 在LaunchDescription开头添加 SetEnvironmentVariable('ROS_LOG_DIR', '/tmp/ros2_logs'), SetEnvironmentVariable('USE_SIM_TIME', 'true'), # 全局生效

3. 核心功能详解与实操要点

3.1 启动配置：launch文件的四个关键动作

Ros2Supervisor的启动看似简单，实则暗藏玄机。很多教程只贴出ros2_supervisor=True这一行，但实际部署时，有四个环节缺一不可。我按执行顺序拆解：

第一步：在World文件中声明Supervisor Robot
这不是可选项，而是强制前提。你必须在.wbt文件里明确定义一个Robot节点，并将其supervisor字段设为TRUE。常见错误是直接复用现有机器人节点并改名，这会导致冲突。正确做法是新建一个专用Supervisor节点：

# 在world文件末尾添加 Robot { name "supervisor_robot" supervisor TRUE controller "<extern>" # 注意：这里controller必须是"<extern>"，不能是"void"或空字符串 }

这个节点不需要任何传感器或执行器，它纯粹是Webots的管理入口。name字段值（这里是supervisor_robot）会成为后续ROS 2节点的默认命名前缀。

第二步：launch文件中启用ros2_supervisor参数
webots_ros2的WebotsLauncher类提供了ros2_supervisor开关，但它的作用远不止“启动Supervisor”。当设为True时，它会自动完成三件事：1）在Webots启动时加载supervisor_robot；2）为supervisor_robot分配一个唯一的extern controller进程；3）将该进程的PID注入ROS 2参数服务器，供Ros2Supervisor节点读取。代码必须这样写：

from webots_ros2_core.webots_launcher import WebotsLauncher from ament_index_python.packages import get_package_share_directory from launch import LaunchDescription from launch_ros.actions import Node package_dir = get_package_share_directory('my_robot_pkg') webots = WebotsLauncher( world=PathJoinSubstitution([package_dir, 'worlds', 'my_world.wbt']), mode='realtime', ros2_supervisor=True, # 关键！必须为True )

漏掉这行，Ros2Supervisor节点会因找不到Supervisor实例而报错Failed to connect to Webots supervisor。

第三步：将webots._supervisor加入LaunchDescription
这是最易被忽略的步骤。webots._supervisor不是一个变量，而是WebotsLauncher对象的一个属性，它封装了Ros2Supervisor节点的完整启动配置。你必须把它显式加入LaunchDescription，否则节点根本不会启动：

return LaunchDescription([ webots, webots._supervisor, # 必须！否则Ros2Supervisor不会运行 # 其他节点... ])

我见过太多案例：开发者确认ros2_supervisor=True已设置，ros2 node list却看不到/Ros2Supervisor，最终发现就是漏了这一行。webots._supervisor内部会自动配置use_sim_time、log_level等参数，并设置正确的namespace。

第四步：注册仿真退出事件处理器
这是生产环境的必备项。当Webots窗口关闭时，Ros2Supervisor进程不会自动退出，它会变成僵尸进程持续占用端口。RegisterEventHandler的作用是监听OnProcessExit事件，并触发Shutdown信号：

from launch.actions import RegisterEventHandler, EmitEvent from launch.event_handlers import OnProcessExit from launch.events import Shutdown return LaunchDescription([ webots, webots._supervisor, RegisterEventHandler( event_handler=OnProcessExit( target_action=webots, on_exit=[EmitEvent(event=Shutdown())] ) ) ])

没有这个处理器，每次调试都要手动kill -9进程，效率极低。

3.2 动态节点注入：从字符串到世界树的完整链路

spawn_node_from_string服务是Ros2Supervisor最具魔力的功能，但它的使用远不止“发个service call”那么简单。整个链路涉及Webots语法、PROTO声明、路径解析三个层面，任何一个环节出错都会返回success: false且无提示。

语法规范：必须是合法的Webots PROTO定义片段
输入的data字符串不是任意文本，而是Webots世界描述语言（WDL）的子集。它必须是一个完整的节点定义，且首字母大写。常见错误示例：

• ❌ 错误："robot { name \"my_bot\" }"（robot小写，Webots会忽略）
• ❌ 错误："Robot { name \"my_bot\" }"（缺少children或boundingObject，Webots解析失败）
• ✅ 正确："Robot { name \"my_bot\" children [ ] boundingObject NULL }"

更实用的做法是定义一个最小化模板：

ros2 service call /Ros2Supervisor/spawn_node_from_string webots_ros2_msgs/srv/SpawnNodeFromString \ "data: Robot { name \"dynamic_obstacle\" translation 1.0 0.0 0.0 rotation 0 0 1 0 children [ ] boundingObject NULL }"

这个模板确保了节点能被Webots识别并加入世界树。

PROTO声明：EXTERNPROTO必须在.world文件中预注册
当你想注入自定义PROTO（如MyLidar）时，spawn_node_from_string会检查.wbt文件头部的EXTERNPROTO声明。如果未声明，Webots会静默失败。正确做法是在.wbt文件开头添加：

# 在.world文件第一行添加 EXTERNPROTO "MyLidar" "protos/MyLidar.proto" # 或者如果PROTO在其他包里 EXTERNPROTO "MyLidar" "package://my_sensors/protos/MyLidar.proto"

注意路径必须是Webots能解析的绝对路径或package://格式。我曾因路径写成./protos/MyLidar.proto导致注入失败，调试半小时才发现Webots不支持相对路径。

路径解析：ROS 2节点如何找到PROTO文件？
Ros2Supervisor本身不解析PROTO路径，它只是把字符串原样传给Webots。因此，EXTERNPROTO声明中的路径必须对Webots进程有效。最佳实践是：所有PROTO文件放在<package>/protos/目录下，并在CMakeLists.txt中用install(DIRECTORY protos DESTINATION share/${PROJECT_NAME}/protos)安装。这样Webots启动时会自动将share/<pkg>/protos加入搜索路径。

3.3 HTML5动画录制：不只是录屏，而是生成可交互的Web应用

animation_start_recording和animation_stop_recording服务，表面看是录屏功能，实则是Webots的“Web导出引擎”API封装。它生成的不是视频文件，而是包含Three.js渲染引擎、Webots场景数据、以及JavaScript控制逻辑的完整Web应用包。这对教学演示、客户汇报、算法可视化有巨大价值。

目录结构要求：value参数必须是绝对路径且可写
animation_start_recording的value参数指定输出目录，但Webots有严格限制：1）必须是绝对路径（/home/user/anim，不能是~/anim）；2）目录必须已存在且ROS 2节点有写权限；3）目录名不能含空格或特殊字符。我建议用以下方式构造路径：

# 在launch文件中用Python生成绝对路径 import os anim_dir = os.path.abspath(os.path.join(os.environ['HOME'], 'webots_animations')) # 然后在service call中使用 ros2 service call /Ros2Supervisor/animation_start_recording webots_ros2_msgs/srv/SetString \ "{value: \"$anim_dir/index.html\"}"

生成内容解析：index.html不只是播放器
生成的index.html是一个完整的单页应用（SPA）。它包含：

• scene.wbo：二进制场景文件，包含所有节点状态
• js/目录：Three.js引擎及Webots适配层
• css/目录：UI样式
• index.html：主页面，内置播放控制条、视角重置按钮、帧跳转滑块

更关键的是，它支持JavaScript API调用。你可以在自己的网页中嵌入：

<iframe src="/path/to/index.html" width="800" height="600"></iframe> <!-- 然后用JS控制 --> <script> const iframe = document.querySelector('iframe'); iframe.contentWindow.postMessage({action: 'play'}, '*'); </script>

这让你能把仿真动画无缝集成到公司官网或教学平台。

性能优化：避免录制导致仿真卡顿
动画录制会显著增加CPU负载，尤其在高分辨率（1920x1080）下。Webots默认录制帧率为30fps，但你可以通过WebotsLauncher的recording_fps参数降低：

webots = WebotsLauncher( world=..., recording_fps=15, # 降为15fps，CPU占用减少40% )

实测表明，15fps对算法演示完全够用，且生成的index.html体积减小55%。

4. 实操全流程与核心环节实现

4.1 从零开始：一个可运行的完整示例

我们以“动态添加一个移动障碍物并录制其运动动画”为任务，走一遍端到端流程。假设你已有一个基础Webots+ROS 2工作空间，包名为webots_demo。

步骤1：准备World文件
在webots_demo/worlds/demo_world.wbt中，添加Supervisor节点和基础环境：

# demo_world.wbt # 第一行必须声明EXTERNPROTO（即使暂时不用） EXTERNPROTO "Robot" "webots://projects/robots/gctam/protos/Robot.proto" WorldInfo { basicTimeStep 32 } Viewpoint { orientation 0.9999999999999999 0 0 0.5 position 0 0 5 } TexturedBackground { } TexturedBackgroundLight { } # 添加Supervisor节点 Robot { name "supervisor_robot" supervisor TRUE controller "<extern>" } # 添加一个基础地面 RectangleArena { floorSize 10 10 }

步骤2：编写launch文件
在webots_demo/launch/demo_launch.py中：

import os from ament_index_python.packages import get_package_share_directory from launch import LaunchDescription from launch.actions import IncludeLaunchDescription, RegisterEventHandler, EmitEvent from launch.event_handlers import OnProcessExit from launch.events import Shutdown from launch.launch_description_sources import PythonLaunchDescriptionSource from webots_ros2_core.webots_launcher import WebotsLauncher from launch_ros.actions import Node def generate_launch_description(): package_dir = get_package_share_directory('webots_demo') # 启动Webots，启用Supervisor webots = WebotsLauncher( world=os.path.join(package_dir, 'worlds', 'demo_world.wbt'), mode='realtime', ros2_supervisor=True, # 可选：降低录制帧率 recording_fps=15, ) # 创建Ros2Supervisor节点（由webots._supervisor自动配置） return LaunchDescription([ webots, webots._supervisor, # 注册退出处理器 RegisterEventHandler( event_handler=OnProcessExit( target_action=webots, on_exit=[EmitEvent(event=Shutdown())] ) ) ])

步骤3：构建并启动

cd ~/ros2_ws colcon build --packages-select webots_demo source install/setup.bash ros2 launch webots_demo demo_launch.py

启动后，你应该能在ros2 node list中看到/Ros2Supervisor，并用ros2 topic list | grep clock确认/clock已发布。

步骤4：动态注入障碍物
打开新终端，执行：

# 注入一个红色立方体障碍物 ros2 service call /Ros2Supervisor/spawn_node_from_string webots_ros2_msgs/srv/SpawnNodeFromString \ "data: Solid { name \"moving_obstacle\" translation 2.0 0.0 0.5 rotation 0 0 1 0 children [ Shape { geometry Box { size 0.5 0.5 0.5 } appearance PBRAppearance { baseColor 1 0 0 } } ] boundingObject Box { size 0.5 0.5 0.5 } }" # 验证是否注入成功 ros2 node info /Ros2Supervisor # 查看节点状态 ros2 topic echo /clock --once # 确认时间同步

步骤5：录制动画

# 创建输出目录 mkdir -p ~/webots_animations # 开始录制（注意：value必须是绝对路径） ros2 service call /Ros2Supervisor/animation_start_recording webots_ros2_msgs/srv/SetString \ "{value: \"/home/$(whoami)/webots_animations/index.html\"}" # 让仿真运行10秒（可手动操作或用脚本） sleep 10 # 停止录制 ros2 service call /Ros2Supervisor/animation_stop_recording webots_ros2_msgs/srv/GetBool \ "{ask: True}" # 生成的index.html现在可直接用浏览器打开 firefox ~/webots_animations/index.html

4.2 参数调优：影响稳定性的五个关键配置

Ros2Supervisor的稳定性高度依赖Webots仿真参数与ROS 2通信参数的匹配。以下是经过实测验证的五组关键参数组合：

这些参数不是孤立的，而是相互制约的。例如，当你把basicTimeStep从32ms降到16ms时，必须同步将/clock的QoS reliability从RELIABLE改为RELIABLE（保持不变），但要把服务超时从5.0s提高到8.0s，因为更短的步进意味着Webots有更多时间处理注入请求。

4.3 故障诊断：基于真实日志的排查手册

Ros2Supervisor的错误通常不直接报在终端，而是隐藏在ROS 2日志或Webots控制台。以下是我在项目中积累的典型故障模式及解决方案：

故障1：Failed to connect to Webots supervisor

• 现象：ros2 node list看不到/Ros2Supervisor，launch日志显示此错误
• 根因：WebotsLauncher未正确启用ros2_supervisor=True，或.wbt文件中缺少supervisor TRUE节点
• 诊断命令：

  # 检查launch文件是否启用 grep "ros2_supervisor" ~/ros2_ws/src/webots_demo/launch/demo_launch.py # 检查.world文件是否定义Supervisor grep -A5 "supervisor TRUE" ~/ros2_ws/src/webots_demo/worlds/demo_world.wbt

• 修复：确保ros2_supervisor=True且.wbt中有supervisor TRUE节点，重启launch

故障2：spawn_node_from_string返回success: false但无日志

• 现象：服务调用返回success: false，ros2 log无相关错误
• 根因：log_level未设为DEBUG，或.wbt文件缺少EXTERNPROTO声明
• 诊断命令：

  # 提升日志级别 ros2 param set /Ros2Supervisor log_level debug # 重新调用服务，查看详细日志 ros2 service call /Ros2Supervisor/spawn_node_from_string ... ros2 log show --since "1 second ago" | grep -i "spawn\|import"

• 修复：根据日志提示添加缺失的EXTERNPROTO，或修正WDL语法

故障3：/clock发布但use_sim_time节点不响应

• 现象：ros2 topic echo /clock有输出，但robot_state_publisher的TF无变化
• 根因：use_sim_time参数未全局设置，或节点启动顺序错误
• 诊断命令：

  # 检查节点参数 ros2 param get /robot_state_publisher use_sim_time # 检查参数服务器全局设置 ros2 param list | grep use_sim_time

• 修复：在launch文件开头添加SetEnvironmentVariable('USE_SIM_TIME', 'true')，并确保robot_state_publisher在Ros2Supervisor之后启动

5. 常见问题与排查技巧实录

5.1 服务调用失败的七种可能及速查表

Ros2Supervisor的服务调用失败往往不是代码问题，而是环境配置的连锁反应。以下是基于上百次调试总结的速查表，按发生概率排序：

这个表格的价值在于：它把模糊的“服务失败”转化为可执行的验证步骤。比如第3条，很多人以为remove_node是按节点类型删除，其实是按name字段精确匹配。我曾帮一个团队解决这个问题，他们注入时用name "obstacle_1"，删除时却发{data: "obstacle"}，自然失败。

5.2 性能瓶颈分析：CPU与内存占用的真相

Ros2Supervisor的资源占用常被误判。我用htop和ros2 topic hz对同一仿真场景做了72小时连续监控，得出以下结论：

CPU占用：

• 空闲状态（无服务调用）：0.3%~0.7%
• 高频调用spawn_node_from_string（10次/秒）：2.1%~3.5%
• 动画录制中（15fps）：8.7%~12.3%
• 关键发现：CPU峰值出现在animation_start_recording被调用的瞬间，此时Webots要序列化整个世界树，耗时约150ms。这不是Ros2Supervisor的bug，而是Webots的固有行为。解决方案是避免在仿真关键路径（如控制循环）中调用此服务。

内存占用：

• 空闲状态：24MB~28MB
• 注入10个节点后：31MB~35MB
• 动画录制中：峰值达180MB（缓存帧数据）
• 关键发现：内存增长主要来自Webots的帧缓存，而非ROS 2节点本身。当animation_stop_recording被调用后，内存会在30秒内回落至基线。这说明内存泄漏风险极低，但要注意磁盘空间——1分钟15fps动画生成约1.2GB文件。

网络带宽：

• /clock话题：1.2KB/s（32ms步进）
• spawn_node_from_string服务：单次调用约2KB（取决于WDL字符串长度）
• remove_node话题：0.1KB/s（纯字符串）
• 关键发现：Ros2Supervisor对网络带宽要求极低，千兆局域网下可忽略不计。真正的瓶颈是Webots进程的CPU，而非ROS 2通信。

5.3 进阶技巧：超越文档的三个实战方案

技巧1：用Python脚本批量注入节点，替代重复的service call
手动敲ros2 service call效率低下。我写了一个轻量脚本，支持从JSON文件批量注入：

# inject_batch.py import json import subprocess import sys def inject_from_json(json_file): with open(json_file, 'r') as f: nodes = json.load(f) for node in nodes: cmd = [ 'ros2', 'service', 'call', '/Ros2Supervisor/spawn_node_from_string', 'webots_ros2_msgs/srv/SpawnNodeFromString', f'data: "{node["wdl"]}"' ] result = subprocess.run(cmd, capture_output=True, text=True) print(f"Injected {node['name']}: {result.returncode}") if __name__ == '__main__': inject_from_json(sys.argv[1])

配合JSON文件：

[ { "name": "obstacle_1", "wdl": "Solid { name \"obstacle_1\" translation 1.0 0.0 0.5 children [...] }" } ]

运行python inject_batch.py obstacles.json，一键注入。

技巧2：录制动画时自动添加水印和标题
Webots生成的index.html默认无品牌信息。我通过patchindex.html实现自动水印：

# 在animation_stop_recording后执行 sed -i '/<body>/a\ <div style="position:fixed;top:10px;left:10px;color:white;font-size:14px;background:black;padding:5px;">Demo v1.0</div>' \ ~/webots_animations/index.html

这行命令在HTML的<body>标签后插入水印div，无需修改Webots源码。

技巧3：用ros2 topic pub模拟remove_node，避免服务调用开销
remove_node是topic而非service，这意味着它可以被ros2 topic pub直接触发，且无RPC开销。在实时性要求高的场景（如避障响应），我用以下方式替代service调用：

# 创建一个bash函数，快速移除节点 remove_node() { ros2 topic pub --once /Ros2Supervisor/remove_node std_msgs/msg/String "{data: \"$1\"}" } # 使用 remove_node "dynamic_obstacle"

实测比ros2 service call快3.2倍（service平均耗时87ms，topic平均27ms）。

6. 扩展可能性：从工具到工作流的升维

Ros2Supervisor的价值不仅在于它能做什么，更在于它如何重塑你的开发范式。在我参与的三个工业项目中，它催生了三种全新的工作流：

工作流1：仿真即测试环境（Simulation-as-Test）
传统测试需要手动修改.world文件、重启仿真、验证结果。现在，我们用Ros2Supervisor构建了自动化测试框架：

• 测试脚本先调用spawn_node_from_string注入待测传感器模型
• 再调用animation_start_recording开始录制
• 运行ROS 2测试节点（如test_lidar_driver）
• 最后调用animation_stop_recording生成带时间戳的HTML报告
  整个过程无需人工干预，CI/CD流水线可全自动执行。某次回归测试，我们用此框架在12分钟内完成了原本需2小时的手动测试。

工作流2：动态世界构建（Dynamic World Building）
在多机协同仿真中，静态.world文件无法满足“随机障碍物生成”需求。我们扩展了Ros2Supervisor，在launch文件中注入一个Python节点，监听/sim/obstacle_spawn话题，收到消息后自动调用spawn_node_from_string。这样，导航算法的测试不再受限于预设场景，而是能实时响应外部指令生成新环境。

工作流3：仿真-实物映射（Sim-to-Real Bridge）
最颠覆性的应用是“仿真即实物”。我们为每个真实机器人部署一个Ros2Supervisor实例，它不连接Webots，而是连接真实机器人的CAN总线。当ROS 2服务调用spawn_node_from_string时，它解析WDL字符串，提取translation和rotation，