SuperAPI AI 工具集

argent-simulator-interact

通用与其它

查看项目

更新于 10-16 05:51

技能介绍

用途:通过 argent MCP 工具与 iOS 模拟器交互,完成点击 UI、执行手势、滚动、输入文本、按硬件键、旋转设备与打开应用等操作。

主要能力:list-simulators 与 boot-simulator 管理模拟器;launch-app(bundle ID)和 open-url(URL scheme)打开应用;gesture-tap/swipe/pinch/rotate/custom 执行触摸手势;button 支持 home、back、power、volumeUp、volumeDown、appSwitch、actionButton;paste 与 keyboard 输入文本及 Enter、Escape、方向键等;rotate 切换方向;run-sequence 批量执行多步交互,只在结束时返回一张截图,出错即停止并返回部分结果。发现工具包括 describe(通用可访问性元素树与归一化坐标)、debugger-component-tree(React Native)、native-describe-screen(需 bundleId)、native-user-interactable-view-at-point 与 native-view-at-point。

用法要点:坐标均为 0.0–1.0 归一化值;点击前先按 tapping_rule;首次使用前用 ToolSearch 加载手势工具 schema,否则参数可能被强制转成字符串;打开应用不要点主屏图标;文本输入先点输入框再尝试 paste,失败再用 keyboard;用 gesture-swipe 处理列表滚动;仅在需要时使用 screenshot,默认缩放 30%,可用 scale 0.01–1.0(1.0 为原分辨率)。run-sequence 内不重复写 udid,支持每步可选 delayMs。

限制:部分能力未在资料中说明;手势工具 schema 可能延迟加载;describe 失败时按错误处理(如 ax-service 不可用、返回空列表),空列表可用 screenshot 查看后再重试;React Native 详情不足时用 debugger-component-tree;原生 UIKit 属性需 native-describe-screen 且需注入 dylib。截图仅作最终视觉回退,不要用截图推导常规应用内导航目标。