From 6dba8182ef038715a7cf0800ba52bc7e428f38ac Mon Sep 17 00:00:00 2001 From: Derrors <33656531+Derrors@users.noreply.github.com> Date: Sun, 15 Nov 2026 22:11:40 +0800 Subject: [PATCH] docs: redraw the architecture diagram around the three layers The diagram only showed the MCP path into the daemon, with relabelled cards. It now shows the three layers: access (AI clients through iphone-control mcp; the optional control page, which also serves browsers and remote agents over HTTPS and HTTP MCP), and the daemon as the core, with native control (iOS 27+, default) and WebDriverAgent (iOS 17-26) as its two routes and tasks and supervision beside them. Light and dark come from one layout. The alt texts in README and the guide follow. Co-Authored-By: Claude Opus 5.5 --- README.md | 2 +- README.zh-CN.md | 2 +- website/en/guide/what-is-iphone-control.md | 4 +- website/guide/what-is-iphone-control.md | 4 +- website/public/architecture-dark.svg | 129 ++++++++++++--------- website/public/architecture-light.svg | 129 ++++++++++++--------- 6 files changed, 154 insertions(+), 116 deletions(-) diff --git a/README.md b/README.md index 78cafe1..2f8933e 100644 --- a/README.md +++ b/README.md @@ -59,7 +59,7 @@ Device control has two routes, picked by iOS version:

- 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: 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

diff --git a/README.zh-CN.md b/README.zh-CN.md index 13c91be..b8674f4 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -59,7 +59,7 @@ iphone-control 在 Linux 或 macOS 上用**一个 Rust 二进制**把这些事

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

diff --git a/website/en/guide/what-is-iphone-control.md b/website/en/guide/what-is-iphone-control.md index 0c8f1b9..2a790aa 100644 --- a/website/en/guide/what-is-iphone-control.md +++ b/website/en/guide/what-is-iphone-control.md @@ -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. diff --git a/website/guide/what-is-iphone-control.md b/website/guide/what-is-iphone-control.md index b72d3e0..61e3287 100644 --- a/website/guide/what-is-iphone-control.md +++ b/website/guide/what-is-iphone-control.md @@ -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,几秒就绪。 diff --git a/website/public/architecture-dark.svg b/website/public/architecture-dark.svg index 8f512c8..327c410 100644 --- a/website/public/architecture-dark.svg +++ b/website/public/architecture-dark.svg @@ -1,4 +1,4 @@ - + iphone-control architecture @@ -19,71 +19,90 @@ - - + + Linux or macOS host · launchd, systemd user service or a terminal - - - AI client - Claude Code · Cursor · - any MCP client + + + AI client + Claude Code · Codex · + any MCP client - - MCP · stdio + + MCP · stdio - - - iphone-control mcp - one per agent session, - a thin client + + + iphone-control mcp + one per agent session, + a thin client - - Unix - socket + + Unix + socket - Works with the control page closed. - The page and remote MCP are opt-in. + + + Control page + + optional + iphone-control viewer + live picture · AI tasks + HTTP MCP at /mcp - - + + Unix + socket + + + browsers, remote agents · HTTPS, login + + + iphone-control daemon - one long-running process owns the phone - + the core: owns the phone, runs with the page closed + + Native control - - iOS 27+ - accessibility · HID · nothing on the phone - - WebDriverAgent client - - iOS 17–26 - for older iOS · signed with a free Apple ID - - Supervisor - usbmuxd · reconnect · disk image · re-sign · notify + + iOS 27+ · default + accessibility service · HID · CoreDevice + nothing installed, no Apple ID + + + WebDriverAgent + + iOS 17–26 + runs on the phone, signed with a free Apple ID + re-signed before the 7-day profile expires + + + Tasks and supervisor + pause · take over · confirm before risky steps + reconnect · disk image · unlock · notify - - - USB - usbmuxd + + + USB + usbmuxd - - - - - iPhone / iPad - iOS 17+ - - iOS 27+ - no install - older iOS: - WebDriverAgent + + + + + iPhone / iPad + iOS 17+ + + iOS 27+ + nothing to install + iOS 17–26: + WebDriverAgent - - - Outbound HTTPS - Apple ID (WDA only) - Bark · Telegram + + + Outbound HTTPS + Apple ID (WDA only) + Bark · Telegram diff --git a/website/public/architecture-light.svg b/website/public/architecture-light.svg index ca1bf84..7df1afd 100644 --- a/website/public/architecture-light.svg +++ b/website/public/architecture-light.svg @@ -1,4 +1,4 @@ - + iphone-control architecture @@ -19,71 +19,90 @@ - - + + Linux or macOS host · launchd, systemd user service or a terminal - - - AI client - Claude Code · Cursor · - any MCP client + + + AI client + Claude Code · Codex · + any MCP client - - MCP · stdio + + MCP · stdio - - - iphone-control mcp - one per agent session, - a thin client + + + iphone-control mcp + one per agent session, + a thin client - - Unix - socket + + Unix + socket - Works with the control page closed. - The page and remote MCP are opt-in. + + + Control page + + optional + iphone-control viewer + live picture · AI tasks + HTTP MCP at /mcp - - + + Unix + socket + + + browsers, remote agents · HTTPS, login + + + iphone-control daemon - one long-running process owns the phone - + the core: owns the phone, runs with the page closed + + Native control - - iOS 27+ - accessibility · HID · nothing on the phone - - WebDriverAgent client - - iOS 17–26 - for older iOS · signed with a free Apple ID - - Supervisor - usbmuxd · reconnect · disk image · re-sign · notify + + iOS 27+ · default + accessibility service · HID · CoreDevice + nothing installed, no Apple ID + + + WebDriverAgent + + iOS 17–26 + runs on the phone, signed with a free Apple ID + re-signed before the 7-day profile expires + + + Tasks and supervisor + pause · take over · confirm before risky steps + reconnect · disk image · unlock · notify - - - USB - usbmuxd + + + USB + usbmuxd - - - - - iPhone / iPad - iOS 17+ - - iOS 27+ - no install - older iOS: - WebDriverAgent + + + + + iPhone / iPad + iOS 17+ + + iOS 27+ + nothing to install + iOS 17–26: + WebDriverAgent - - - Outbound HTTPS - Apple ID (WDA only) - Bark · Telegram + + + Outbound HTTPS + Apple ID (WDA only) + Bark · Telegram