SuperAPI AI 工具集

argent-device-interact

智能体与模型

查看项目

更新于 10-16 09:30

技能介绍

用途:通过统一的 argent MCP 工具面与三类目标交互——iOS 模拟器、Android 模拟器和 Chromium(CDP)应用(Electron 应用或暴露 Chrome DevTools Protocol 端点的 Chrome 系浏览器)。所有交互工具都接受 udid 参数,按其形态自动分派:UUID 走 iOS 模拟器,chromium-cdp-<port> 走 Chromium,其余走 Android adb 串号。

主要能力:list-devices 获取目标并带平台标记,boot-device 启动设备;launch-app、open-url、restart-app 打开或重启应用,避免点击主屏图标。点击用 gesture-tap,滑动/滚动用 gesture-swipe(Chromium 用 gesture-scroll),拖拽、长按等用 gesture-custom,另有 gesture-pinch、gesture-rotate。keyboard 输入文字或特殊键(text 与 key 互斥),paste 粘贴文本(仅模拟器/仿真器),button 按下硬件键,rotate、fold、shake 分别旋转、折叠和摇动设备。await-ui-element 与 await-screen-idle 用于等待元素状态或屏幕稳定,避免轮询截图。

使用方式:坐标均为归一化 0.0–1.0。首次使用前先用 ToolSearch 加载手势工具的参数 schema,否则参数可能被强制转成字符串导致校验错误。查找点击目标优先用 describe 返回无障碍元素树,React Native 可用 debugger-component-tree,需要应用级原生属性时用 native-describe-screen(需 bundleId)。操作后先看返回的元素树,仅在无新树时再 describe。凭据可用 {{secret:<NAME>}} 占位符输入,规则见 references/secrets.md。

适用场景与限制:适用于在模拟器/仿真器和 Chromium 目标上做 UI 自动化、导航、输入和诊断。paste 仅支持 iOS 模拟器与 Android 仿真器,TV 目标、真机、Chromium 和 Vega 会被拒绝;delayMs 在 Android 手机/平板、Vega 和 TV 上被忽略;fold 只适用于可折叠 iOS 模拟器。await-screen-idle 仅用于实时诊断,不应放入 run-sequence;驱驶 Chromium 前应先阅读其参考文档,滚动、标签页、Cookie 与存储行为不同。其他细节(安装、收费等)资料未提供。