ios exec

fushou-agent ios exec 使用自然语言指令，在已连接的 iPhone 上完成任务。仅支持 macOS。

本地交互#

请先安装 Node.js 22.19.0 或更新版本。任务在本机执行，终端显示回复和工具调用；仅在澄清工具提问时显示输入框并接收回答，其余时间不接受输入。会话保存在本机缓存目录。

默认进入交互模式。不连接交互终端时自动使用非交互模式；脚本或其他智能体调用时请显式使用 -p（或 --prompt）。

命令格式#

fushou-agent ios exec "<instruction>"
fushou-agent ios exec -p -- "- 请整理这些内容"
fushou-agent ios exec --resume SESSION_ID

instruction 是要完成的操作。请用引号包裹完整指令，例如：

fushou-agent ios exec "打开设置并查看 iOS 版本"

如果需要使用电脑上的文件，请提供完整文件路径和用途：

fushou-agent ios exec "将 /absolute/path/photo.png 保存到手机照片"

开始前#

• 在管理后台完成客户端使用所需的账号配置。
• 首次使用前，按安装说明完成 iOS 设备准备。
• 使用 USB 连接一台 iPhone，保持解锁，并按手机提示信任当前电脑、开启开发者模式。

如果 iPhone 尚未信任这台 Mac，客户端会显示操作引导并等待最多 30 秒。请在 iPhone 上点击“信任”，按提示输入手机密码；确认后任务自动继续。超时后请完成信任并重试原命令。

手机提示“不受信任的开发者”#

Mac 会显示操作引导，并等待最多 30 秒。请在 iPhone 上：

1. 打开“设置 → 通用 → VPN 与设备管理”。
2. 选择赋手智能体所属的开发者。
3. 点击“信任”并再次确认。

确认成功后引导会关闭，任务自动继续准备；请保持手机连接和解锁。关闭引导窗口不会取消等待。若等待超时，请完成信任后重新运行原命令。

查看结果#

交互模式仅在澄清工具提问时显示输入框并接收回答，其余时间不接受输入。给出最终结果后立即停止接收输入，显示费用并自动退出；开始新任务需重新运行命令。也可在管理后台查看操作记录。

非交互模式仅在 stdout 输出最终结果 JSON，不输出会话编号、工具过程或模型中间回复。使用 -p 或非交互终端时，始终不显示输入框，也不接收输入。需要澄清时保存问题和会话 ID，以退出码 2 结束；可在同一电脑的交互终端使用 --resume SESSION_ID 回答并继续，恢复时不要加 -p。其他退出码：0 完成，1 失败，130 取消。

常见问题#

• 找不到设备：检查数据线连接、手机解锁状态及电脑信任提示，并只连接本次要操作的一台设备。
• 提示设备准备失败：按终端提示处理后，重新运行 fushou-agent install --ios。
• 文件无法读取：确认指令中的完整文件路径正确，且文件存在。

可以在控制台/GUI智能体/自然语言调用页面查看调用记录。