mcpField
A
argent-ios-device-interact

argent-ios-device-interact

github.com/software-mansion测试与质量3.1k11.7k 次安装今天更新
代码仓库

关于 argent-ios-device-interact

此技能介绍 Argent 在实体 iPhone 上的设备交互方式，包括观察行为、支持的工具和硬件限制，帮助自动化操作人员选择可用操作并应对设备或应用状态变化。

主要功能

  1. 01列出并启动 iPhone 应用
  2. 02检查界面并截取屏幕
  3. 03点击、滑动和键盘输入
  4. 04等待界面元素或屏幕空闲
  5. 05运行交互序列
  6. 06说明硬件不支持的操作

适用场景

  1. 01自动化操作实体 iPhone 上的应用
  2. 02应用重新进入前台后重新检查界面
  3. 03根据设备硬件选择支持的手势
  4. 04排查失败或不支持的设备操作

MCP 相关

输入介绍了 Argent 设备交互工具，但未说明 MCP 行为。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/software-mansion/argent --skill argent-ios-device-interact

安装后在 Claude Code 中输入/argent-ios-device-interact确认已加载。

详细介绍

与实体 iPhone 交互

仅在使用实体 iPhone 时阅读。对于此处未列出的所有操作，仍使用 argent-device-interact。

约定

  • 观察不会改变屏幕；更改可能会。目标应用在后台时，describe 和 await-ui-element 会失败，而不会将其重新置于前台；await-screen-idle 会返回 settled: false，且不附带原因。执行 button home 后 1 秒内的首次 describe 仍可能返回旧视图树；请再次执行 describe。手势和 keyboard 会将应用重新置于前台，并返回 reactivated: true；执行下一步前请重新描述界面。
  • launch-app、open-url 和 restart-app 会设置自动化所针对的应用；reinstall-app 会清除该设置；工具服务器重启后会忘记该设置：请重新启动应用。
  • 每个工具的描述都会说明其自身的硬件限制（命名按键、gesture-custom 形状、按钮、边缘滑动、点击次数）。受限工具会直接失败并返回 not supported on ios device：请按下方列表处理，而不是从错误信息中寻找解决方法。

在硬件上可用的工具

  • 仅有以下工具：list-devices、launch-app、restart-app、reinstall-app、open-url、describe、screenshot、screenshot-diff、gesture-tap、gesture-swipe、gesture-custom、button（在配备相应按钮的机型上支持 home、volumeUp、volumeDown、actionButton）、keyboard、await-ui-element、await-screen-idle、run-sequence、E2E 工具、stop-simulator-server 和 stop-all-simulator-servers（结束会话）。所有其他设备工具都会失败并返回 not supported on ios device。
  • 不支持双指手势、rotate、shake、paste、settings-permissions、屏幕录制、debugger-*、react-profiler-*、native-profiler-*、native-*、boot-device：通过点击和拖动操作应用自身的缩放和旋转界面，手动移动手机，使用 keyboard 输入文字，在手机的“设置”中更改权限，并在模拟器上进行调试、性能分析或录制。
  • gesture-swipe：durationMs 设置拖动速度，而非持续时间；momentum:false 只会在结束时停顿 300 ms，不会产生减速效果。open-url 打开 HTTPS 链接时会进入 Safari，绝不会进入拥有该链接的应用：请传入 bundleId。

评论

支持 Markdown