# Apple Watch

在 Mac 上镜像和操控运行 watchOS 27 的 Apple Watch 或 Apple Watch 模拟器，让你的 AI Agent 用同一套 MCP 工具测试你的手表 App。

Device MCP 镜像和控制运行 watchOS 27 的 Apple Watch 和 Apple Watch 模拟器的方式与 iPhone 相同：在同一个侧边栏里，用同样的鼠标和键盘控制，AI Agent 也使用同一套 MCP 工具。

## 1. 要求
* 运行 **watchOS 27** 或更高版本的 **Apple Watch**，与 Mac 连接同一个 Wi-Fi 网络。
* Mac 上需要安装 **Xcode**。Xcode 负责将手表与 Mac 配对，也提供 Device MCP 所用的 watchOS 开发者工具。
* Apple Watch 模拟器需要 **watchOS 27** 模拟器运行时。可在 **Xcode → Settings → Components** 中添加。

## 2. 配对你的手表
手表没有数据线：Xcode 将它与 Mac 配对后，Device MCP 就通过 Wi-Fi 连接它。每块手表只需配对一次。

1. 在手表上打开**设置 → 隐私与安全性 → 开发者模式**。
2. 在 Xcode 的 **Device Hub** 中选择 **Pair Nearby Wireless Device**，然后选中这块手表。
3. 输入手表上显示的代码。
4. 手表会出现在 Device MCP 的侧边栏中。点击它即可开始镜像。

即使没有 Xcode，只要与手表配对的 iPhone 连接着 Mac，Device MCP 也能通过这台 iPhone 找到手表，并提示还缺什么：

| 提示 | 怎么做 |
| --- | --- |
| **Needs Xcode** | 安装 Xcode 并打开一次，然后在它的 Device Hub 中配对手表。 |
| **Not Paired** | 按上面的步骤，在 Xcode 的 Device Hub 中将手表与这台 Mac 配对。 |
| **Not Nearby** | 唤醒并解锁手表，让它靠近 Mac 并连接同一个 Wi-Fi。放在充电器上时，手表会保持 Wi-Fi 打开。 |
| **Developer Mode Off** | 在手表上打开**设置 → 隐私与安全性 → 开发者模式**。 |

{% hint style="info" %}
Device MCP Free 一次镜像一台设备，手表或 Apple Watch 模拟器也算一台。Device MCP Pro 不限数量。参见[许可证](../license.md)。
{% endhint %}

## 3. Apple Watch 模拟器
1. 点击侧边栏顶部的 **+**，选择 **New Simulator → Apple Watch** 和机型。
2. 点击 **Start**。Device MCP 会启动模拟器，并在启动完成后立即显示它的屏幕。

Apple Watch 模拟器的列出、启动和关闭方式与 iPhone 模拟器相同。参见 [iOS 模拟器](ios-simulator.md#2-start-a-simulator)。

## 4. 镜像与控制
* **用它自己的外框**：每款 Apple Watch 都按真机样子显示，带有数码表冠、侧边按钮，Apple Watch Ultra 还有操作按钮。
* **鼠标和触控板**：点击即轻点，拖动即轻扫。参见[使用鼠标和键盘控制](../basic-features/control.md)。
* **数码表冠**：在外框的表冠上滚动即可转动它，也可以按 <kbd>⌘↑</kbd> 和 <kbd>⌘↓</kbd>。点击表冠或按 <kbd>⇧⌘H</kbd>（**Home**）即可按下它。
* **按钮**：点击外框上的侧边按钮（<kbd>⌘L</kbd>）或操作按钮。**Home** 和 **App Switcher** 与 iPhone 一样位于工具栏中。
* **截图与录屏**：参见[截图与录屏](../basic-features/screenshots-and-recording.md)。
* **Info 标签页**：显示与手表配对的 iPhone。

## 5. 配合 AI Agent 使用
你的 Agent 通过与 iPhone 相同的 [MCP](../ai-agents/mcp.md) 服务器使用手表，还能转动数码表冠。它也能列出、启动和新建 Apple Watch 模拟器。

### ✅ 示例提示词
* 启动一个 Apple Watch Ultra 模拟器并截图。
* 在我的 Apple Watch 上打开“设置”，用数码表冠滚动到最底部。
* 在 Apple Watch 模拟器上打开“地图”，找一家附近的面包店。

## 6. 与 iPhone 的区别
* **只用 Wi-Fi**：无论 **Settings → General → Connection** 怎么设置，Device MCP 总是通过 Wi-Fi 连接手表。
* **不能旋转**：watchOS 只有一个屏幕方向。
* **没有音量按钮**：<kbd>⌘↑</kbd> 和 <kbd>⌘↓</kbd> 改为转动数码表冠。