用途：在 facebook/immersive-web-sdk 的 poke 示例中，用 iwsdk CLI 验证 XR 交互行为，共 12 个测试套件：实体发现、ECS 注册、机器人射线交互、机器人戳触交互、面板射线交互、面板双模式（射线+戳触）、跨实体隔离、输入模式切换、快速戳触循环回归、音频、UI 面板、稳定性。
主要能力：通过 npx @iwsdk/cli 子命令操作运行中的应用，包括 ecs find/query/systems/components/set-component、scene runtime-hierarchy/transform、xr look-at/set-select-value/set-transform/animate-to/select/set-input-mode、browser reload/logs/screenshot、dev status/down。输出为 stdout 上的 JSON（{ok, workspaceRoot, operation, result}），据此断言。
使用方式：在示例工作区（cwd 为 $IWSDK_REPO_ROOT/examples/poke）内运行。先 npm run fresh:install，再以 run_in_background 启动 npm run dev，轮询 Vite 就绪或 dev status，用 ecs systems 验证连通。随后按套件逐条执行命令，每条命令单独运行并解析 JSON 断言，不串联命令；等待用独立 sleep。CLI 从 cwd 自动发现应用根，无需路径处理。
限制与注意：戳触依赖 2cm downRadius 阈值，动画需 2-2.5 秒慢速，过快会跳帧；音频自动播放受浏览器策略限制，_playRequested 可能静默失败；_playRequested 与 _stopRequested 在一帧内被消费并重置；实体索引在重载后会变化，不可缓存，需重新 ecs find；touch 子指针需在实体创建时调用 toggleSubPointer('touch', true)。瞬时错误可重启服务器并重试一次，同一套件两次失败则记 FAIL。
适用场景：XR 交互回归测试与调试。