用途:通过 argent MCP 工具以“交互—截图—验证”循环,自主测试 iOS 或 Android 应用 UI,适用于 UI 流程测试、视觉回归对比及修改可见 UI 后的视觉验收。工具对两平台同名,由传入的 udid 自动分发(UUID 形为 iOS,adb serial 为 Android)。
使用方式:先调用 list-devices 选择设备,若无可运行设备则用 boot-device。iOS 或 Android 的引导分别参考 argent-ios-simulator-setup、argent-android-emulator-setup。基本流程:先截图获取基线;再用 describe、React Native 的 debugger-component-tree 或截图定位元素;执行 gesture-tap、gesture-swipe、keyboard 等操作,操作后自动返回截图;最后按断言类型验证。视觉类用 screenshot-diff 对比基线,结构类用 describe、debugger-component-tree 或 native-describe-screen,运行时/日志/网络类用 view-network-logs、debugger-log-registry、debugger-evaluate 等。等待加载时用 await-ui-element 阻塞到元素可见或隐藏,避免固定延时。凭证必须用 {{secret:<NAME>}} 占位符,值来自 ARGENT_SECRET_<NAME> 环境变量或 argent secrets 文件,不得明文输入或写入报告。可重复的流程可用 argent-create-flow 录制成 .yaml 脚本并用 flow-execute 回放。
限制与恢复:应用后台时 describe 会失败,需先 launch-app;RN 应用在 Android 上需执行 adb -s <serial> reverse tcp:8081 tcp:8081。点击未命中应重新定位后重试一次,同坐标连续失败两次则停止并报告;权限弹窗优先用 describe 探测,不可靠时回退截图;debugger-log-registry 在调试器不可达时返回 not_connected,此结果不构成应用证据。若回放失败,按 argent-create-flow 的“诊断回放失败”处理。
其余平台细节暂未提供。