用途：该技能面向已存在的 Meta XR Simulator，帮助区分 metavr 的物理设备命令组与 xrsim 模拟器命令组，避免把模拟器任务误发给 ADB 物理设备命令。安装模拟器或将其接入项目属于另一技能 hz-xr-simulator-install-and-configure。
主要能力与命令组：模拟头显型号、IPD、刷新率用 metavr xrsim device；模拟器前端进程用 metavr xrsim app；模拟手与手柄用 metavr xrsim input；合成房间用 metavr xrsim env；合成器图层与模拟帧率用 metavr xrsim layer 或 xrsim runtime fps；模拟器自身日志用 metavr xrsim runtime logs；模拟头显渲染内容用 metavr xrsim record。注意 xrsim record 录制合成器输出为 MP4，而 tapedeck 在物理设备上录制与回放 OpenXR 调用流，二者不可互换；ssim 是 SpatialSim 模拟器，xrsim 才是 Meta XR Simulator。
连接层级与诊断：命令按所需连接分为本地、生命周期、前端、运行时四层。建议按层级从低成本开始诊断：先 metavr xrsim runtime logs，再 metavr xrsim runtime list --format json --timeout 2，最后 metavr xrsim runtime status --format json。runtime list 返回空数组表示前端在线但无应用连接，与前端未启动是不同故障。
安全关闭：按端口限定关闭范围，默认发送关闭请求以便 OpenXR 会话干净退出，仅在优雅关闭失败后使用 --force，--all 只应在必须停止主机上所有实例时使用。
注意事项：device set、device ipd、device refresh-rate 会回读运行时实际值，未加 --wait 时可能仍显示旧值，unknown 应视为读取失败而非设置成功。runtime status 默认容错，可能在某段失败后仍退出 0，自动化中应传 --strict。当 Meta XR Operator 使用非默认端口时，需为应用内层与运行 metavr 的进程设置相同的 AGENTICXR_MCP_PORT。精确参数与输出以 metavr xrsim readme 和 metavr xrsim --help 为准。