用途:在本对话首次使用手机或服务未启动时,通过 MCP 工具把 iPhone 配置为 READY,用于控制手机执行任务。
主要能力:pua_setup 负责 status、discover、fetch、configure、build、start;pua_ready 验证控制通道并提供设备、会话、视口与当前 observation;pua_doctor 诊断 Xcode、设备、签名、端口与进程;pua_screen 打开屏幕侧边栏或暂停/恢复预览。
使用方式:首次先调用 pua_setup(action="status"),缺服务才 start;就绪后调用 pua_ready(recover=true, screenshot=false)。服务未运行时先查 jobs 复用已有 start/recover 工作,没有活动工作时执行一次 pua_setup(action="start"),默认有界等待最多 20 秒,超时用 pua_setup(action="status", job_id=..., wait_seconds=20) 等待同一工作,不能重复 start。首次安装需用 fetch 获取固定版本服务,configure 填写用户自己的 udid、team_id 和可签名 bundle_id,可选 source_dir、local_port、device_port(默认本机 18100、设备 8100),再 build 和 start。
限制:账号登录、密码、验证码、设备解锁与信任由用户在系统界面完成,工具不索取凭据;个人团队最多 3 个 App/设备,provisioning profile 自签发起 7 天过期需重建重装;本插件不要求越狱,也不支持隐藏信号等未提供信息。缺失事实暂未提供。