用途：为 argent 配置一台通过数据线连接的物理 iPhone，仅在涉及实体设备（list-devices 中显示 kind 为 "device" 的 iOS 条目）时使用；模拟器应改用 argent-ios-simulator-setup。
首次运行：用数据线连接手机并解锁，保持屏幕常亮，开启开发者模式（设置 > 隐私与安全性 > 开发者模式），list-devices 须显示已连接。launch-app 只负责注册应用；首次 describe、gesture 或 screenshot 会构建、签名并启动设备端运行器，冷启动需数分钟，命中缓存或工具服务器重启后需数十秒。构建上限 15 分钟，运行器就绪上限 120 秒。
首次安装时手机会提示信任开发者（设置 > 通用 > VPN 与设备管理），主屏出现 ArgentRunner 应用，应向用户说明这是 argent 的自动化运行器且必须保留安装。
签名无需配置。工具服务器进程首次调用手机会附带一条说明，指明所选团队及 ARGENT_IOS_TEAM_ID 覆盖项（属工具服务器环境变量，改动会触发冷重建）。数据线、锁定、信任、配置过期和证书缺失等错误会给出对应修复方法：照做后重试同一调用。其他情况：errSecInternalComponent 可运行 security set-key-partition-list -S apple-tool:,apple:,codesign: -s ~/Library/Keychains/login.keychain-db（会要求输入登录密码）后重试；team has no devices 保持连接后重试；Bundle id registration failed 属免费团队 app-id 上限，需等待数日或改用付费团队签名；其他 xcodebuild 失败可查看 ~/.argent/ios-device-runner/logs/runner-<udid8>.log 中的原始 error: 行；RUNNER_WEDGED 则对相应 udid 执行 stop-simulator-server 后重试。完成后请阅读 argent-ios-device-interact。