用途:自动化 iOS 模拟器/设备与 Android 模拟器/设备的应用交互,适用于导航、快照/截图、点击、输入等移动端 UI 任务,并支持探索式测试与确定性回放。作为路由式技能,先选一种模式:常规交互流、调试/崩溃流、回放维护流,然后运行对应标准流程;被阻塞时再查阅 references。
主要能力:设备发现与目标选择(devices、ensure-simulator、install/reinstall、open/close、session list);快照与定位(snapshot -i、diff snapshot -i、find、press @e1、fill、is visible);实用工具(appstate、clipboard、keyboard、perf、network dump、push、trigger-app-event、get text、screenshot、settings permission、trace);批量执行 batch --steps-file;远程多租户租约(HTTP JSON-RPC 的 allocate/heartbeat/release);设备范围与租户隔离。常规流程示例:agent-device open Settings --platform ios 然后 snapshot -i、press @e3、fill @e5 "test"、close。
使用方式:探索用快照 ref,确定性回放/断言用选择器;UI 变更后需重新快照。Android .apk/.aab 先用 install 或 reinstall,再按包名 open --relaunch,不可用 open <apk|aab> --relaunch。可用 AGENT_DEVICE_SESSION、AGENT_DEVICE_PLATFORM 绑定会话,--session-lock reject|strip 控制锁策略。
限制与注意:日志默认关闭,仅调试时开启,logs clear --restart 需先 open 活跃会话;boot 仅作回退;network dump 为尽力而为解析;.aab 需 PATH 中有 bundletool;权限设置需活跃应用会话;iOS 模拟器权限弹窗用 alert wait 与 accept/dismiss。常见错误包括复用过期 ref、将调试流混入常规运行、Android 用 URL 搭配 --activity、误将 boot 当默认首步。安全上建议使用预装二进制并固定版本,自主运行使用最小权限环境。其余未提供的细节暂未提供。