Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ Device control has two routes, picked by iOS version:
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="website/public/architecture-dark.svg">
<img src="website/public/architecture-light.svg" alt="Architecture: an MCP client talks to iphone-control mcp over stdio, which talks to the daemon over a Unix socket; the daemon drives the iPhone or iPad over USB, natively on iOS 27 and later and through WebDriverAgent below that" width="900">
<img src="website/public/architecture-light.svg" alt="Architecture: AI clients use iphone-control mcp over stdio, and the optional control page serves browsers and remote agents over HTTPS; both talk to the daemon over a Unix socket. The daemon is the core: it drives the iPhone or iPad over USB, natively on iOS 27 and later and through WebDriverAgent on iOS 17–26, and keeps running with the control page closed" width="900">
</picture>
</p>

Expand Down
2 changes: 1 addition & 1 deletion README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ iphone-control 在 Linux 或 macOS 上用**一个 Rust 二进制**把这些事
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="website/public/architecture-dark.svg">
<img src="website/public/architecture-light.svg" alt="架构:MCP 客户端经 stdio 调用 iphone-control mcp,再经 Unix socket 交给守护进程;守护进程经 USB 操作 iPhone 或 iPad,iOS 27 起用原生控制,更低的版本用 WebDriverAgent" width="900">
<img src="website/public/architecture-light.svg" alt="架构:AI 客户端经 stdio 调用 iphone-control mcp,可选的控制台经 HTTPS 服务浏览器和远程 agent,两者都经 Unix socket 交给守护进程。守护进程是核心:经 USB 操作 iPhone 或 iPad,iOS 27 起用原生控制,iOS 17–26 用 WebDriverAgent,控制台关着也照常运行" width="900">
</picture>
</p>

Expand Down
4 changes: 2 additions & 2 deletions website/en/guide/what-is-iphone-control.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@ The core is device control: a long-running daemon owns the phone and keeps servi

## How it works

![Architecture: an MCP client talks to iphone-control mcp over stdio, which talks to the daemon over a Unix socket; the daemon drives the iPhone or iPad over USB, natively on iOS 27 and later and through WebDriverAgent below that](/architecture-light.svg){.light-only}
![Architecture: an MCP client talks to iphone-control mcp over stdio, which talks to the daemon over a Unix socket; the daemon drives the iPhone or iPad over USB, natively on iOS 27 and later and through WebDriverAgent below that](/architecture-dark.svg){.dark-only}
![Architecture: AI clients use iphone-control mcp over stdio, and the optional control page serves browsers and remote agents over HTTPS; both talk to the daemon over a Unix socket. The daemon is the core: it drives the iPhone or iPad over USB, natively on iOS 27 and later and through WebDriverAgent on iOS 17–26, and keeps running with the control page closed](/architecture-light.svg){.light-only}
![Architecture: AI clients use iphone-control mcp over stdio, and the optional control page serves browsers and remote agents over HTTPS; both talk to the daemon over a Unix socket. The daemon is the core: it drives the iPhone or iPad over USB, natively on iOS 27 and later and through WebDriverAgent on iOS 17–26, and keeps running with the control page closed](/architecture-dark.svg){.dark-only}

- A **daemon** runs all the time and owns the phone: it pairs, mounts the Developer Disk Image, opens a tunnel, and then drives the phone one of two ways, by iOS version:
- **iOS 27 and later: native control (default).** The screen is read through the system's accessibility service, taps, swipes and buttons go through CoreDevice HID, and apps launch through CoreDevice. Nothing is installed on the phone, no Apple ID is needed, and it's ready in seconds.
Expand Down
4 changes: 2 additions & 2 deletions website/guide/what-is-iphone-control.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@ iphone-control 让 AI agent(例如 Claude)操作一台用数据线接在 Lin

## 怎么工作

![架构:MCP 客户端经 stdio 调用 iphone-control mcp,再经 Unix socket 交给守护进程;守护进程经 USB 操作 iPhone 或 iPad,iOS 27 起用原生控制,更低的版本用 WebDriverAgent](/architecture-light.svg){.light-only}
![架构:MCP 客户端经 stdio 调用 iphone-control mcp,再经 Unix socket 交给守护进程;守护进程经 USB 操作 iPhone 或 iPad,iOS 27 起用原生控制,更低的版本用 WebDriverAgent](/architecture-dark.svg){.dark-only}
![架构:AI 客户端经 stdio 调用 iphone-control mcp,可选的控制台经 HTTPS 服务浏览器和远程 agent,两者都经 Unix socket 交给守护进程。守护进程是核心:经 USB 操作 iPhone 或 iPad,iOS 27 起用原生控制,iOS 17–26 用 WebDriverAgent,控制台关着也照常运行](/architecture-light.svg){.light-only}
![架构:AI 客户端经 stdio 调用 iphone-control mcp,可选的控制台经 HTTPS 服务浏览器和远程 agent,两者都经 Unix socket 交给守护进程。守护进程是核心:经 USB 操作 iPhone 或 iPad,iOS 27 起用原生控制,iOS 17–26 用 WebDriverAgent,控制台关着也照常运行](/architecture-dark.svg){.dark-only}

- **守护进程**常驻,独占手机:配对、挂载开发者镜像、建立隧道,然后按 iOS 版本选一条路线操作手机:
- **iOS 27 及以上:原生控制(默认)。** 读界面用系统的无障碍服务,点击、滑动、按键走 CoreDevice HID,启动 App 走 CoreDevice。手机上什么都不装,不用 Apple ID,几秒就绪。
Expand Down
129 changes: 74 additions & 55 deletions website/public/architecture-dark.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading