> ## 文档索引
> 获取完整文档索引： https://fushouagent.com/docs/llms.txt
> 先阅读此索引，了解所有可用页面。

# ios exec

> 使用自然语言指令在已连接的 iOS 真机上完成一次操作任务。

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

## 本地交互

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

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

## 命令格式

```bash title="Terminal"
fushou-agent ios exec "<instruction>"
fushou-agent ios exec -p -- "- 请整理这些内容"
fushou-agent ios exec --resume SESSION_ID
```

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

```bash title="Terminal"
fushou-agent ios exec "打开设置并查看 iOS 版本"
```

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

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

## 开始前

- 在管理后台完成客户端使用所需的账号配置。
- 首次使用前，按[安装说明](/docs/client/install)完成 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智能体/自然语言调用页面查看调用记录。

## 相关主题

- [安装客户端能力](/docs/client/install.md)
- [ios rpa exec](/docs/client/ios/rpa/exec.md)
- [ios mcp](/docs/client/ios/mcp.md)