使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/software-mansion/argent --skill argent-ios-device-interact开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Physical iPhone interaction
Read this only for a physical iPhone. argent-device-interact still applies for everything not listed here.
Contract
- Observation never changes the screen; mutation may.
describeandawait-ui-elementfail on a backgrounded target instead of re-fronting it;await-screen-idlereturnssettled: falsewith no reason. The firstdescribewithin a second ofbutton homecan still return the old tree; describe again. Gestures andkeyboardre-front it and returnreactivated: true; re-describe before the next step. launch-app,open-urlandrestart-appset the app under automation;reinstall-appclears it; a tool-server restart forgets it: launch again.- Each tool's description states its own hardware limits (named keys, buttons, edge swipes, tap counts). A gated tool fails with a bare
not supported on ios device: the fix is in the list below, not in the error.
Tools on hardware
- Only these exist:
list-devices,launch-app,restart-app,reinstall-app,open-url,describe,screenshot,screenshot-diff,gesture-tap,gesture-swipe,gesture-custom,gesture-pinch,gesture-rotate,button(home,volumeUp,volumeDown,actionButtonon models that have one),keyboard,await-ui-element,await-screen-idle,run-sequence, the e2e tools,stop-simulator-serverandstop-all-simulator-servers(session end). Every other device tool fails withnot supported on ios device. - No
rotate(the orientation tool),shake,paste,settings-permissions, screen recording,debugger-*,react-profiler-*,native-profiler-*,native-*,boot-device: move the phone by hand, type withkeyboard, change permissions in the phone's Settings, and debug, profile or record on a simulator.