故障排除

1. 设备没有显示#

• 确保设备运行 iOS 27 / iPadOS 27 或更高版本。
• 解锁设备，如果出现询问，请轻点信任。
• 如果 macOS 询问 Allow accessory to connect?（要允许配件连接吗？），请点击允许。
• 换一根数据线或换一个端口试试。有些数据线只能充电。
• 如果通过 Wi-Fi 连接，请确保 Mac 和设备连接在同一网络中，并检查 Device MCP 中的 Settings → General → Connection。

2. 镜像停止或卡住#

在 More (…) 菜单中点击 Reconnect，或按下 ⇧⌘R。

如果 Device MCP 提示有其他 App 正在镜像该设备（例如 Xcode 的 Device Hub），请先在那个 App 中关闭镜像，然后点击 Reconnect。一台设备同一时间只能由一个 App 镜像。

3. 轻点或输入无效#

• 点击一次镜像画面，让按键发送到设备。
• 输入其他语言的文字和表情符号时，如果 iOS 询问是否允许粘贴，请轻点允许粘贴。
• 在设备上打开设置 → 开发者，确保 Enable UI Automation（启用 UI 自动化）已打开。请参阅 iPhone 和 iPad。

4. 设备无法保持旋转#

只有设备平放时，iOS 才会保持旋转方向。请将设备平放在桌面上，然后再次旋转。

5. Agent 找不到 Device MCP#

• 打开 Device MCP，然后打开 Settings → MCP → Enable MCP Server。
• 确保你拥有 Device MCP Pro。
• 检查 Device MCP 是否位于应用程序文件夹中。MCP 页面中的配置指向的就是这个位置。
• 添加 Device MCP 后，重启 Agent。

6. Agent 等待超时#

构建 App 或等待你审批可能需要几分钟。在 Codex 中，请按照 MCP 页面所示设置 tool_timeout_sec = 900。

7. Build & Run 失败#

• 在 Xcode 中打开项目，确保它能使用自动签名为设备构建。
• 查看 Build & Run 标签页中的日志，了解失败原因。
• 如果通过 Wi-Fi 连接，请接上数据线后重试。

8. 仍需帮助？#

在 Device MCP 中选择 Help → Export Diagnostics…。它会在你的 Mac 上保存一个文件，不会发送任何内容。然后联系我们并附上该文件，我们会给你回复。