打开相机或切应用，
画面依然不断流。
USB 与 Wi-Fi 共用同一个签名屏幕组件与 H.264/SRT 视频链路。首次通过 USB 配好组件即可，画面不需要摄像头权限，窗口比例也与各型号 iPhone、iPad 真机边框严丝合缝。
把 iPhone 接上 Mac。 交给 Codex 和 Claude Code。
用 USB 或 Wi-Fi 把真实 iPhone 60 帧投到 Mac 上。一键接入 Codex 或 Claude Code，实时画面就在对话旁边展开，直接读界面、点按钮、验结果。
v0.8.5 · macOS 15+ · iPhone、iPad 与 Android 11+ · 本地 Vision OCR 与 MCP
打开相机或切应用，
键鼠与触控板直控
直接用鼠标点击、拖拽、长按，用 Mac 键盘输入。在 iOS 27+ 和模拟器上，触控板的滚动惯性、双指缩放与旋转手势会直接传给手机。
独立比例小窗
弹出无边框的设备比例小窗，放在编辑器旁边对照调试、录屏或直播演示。
多设备并行
单台手机无需登录即可免费镜像与控制；登录 iTool 年度会员（¥99/年）后可同时连接并操作多台手机。
Android 11+ 同构接入
开启 USB 调试即可通过 scrcpy 传输安卓画面与声音，通过 UiAutomator2 控制屏幕，并共用同一套 MCP 工具。
插线配一次，
之后同网无线连。
内置四步向导会依次检查手机、Apple 开发者账号与签名屏幕组件。首次插线配好之后，拔掉数据线也能在局域网内保持完整分辨率的 H.264 镜像。
LAN同网发现与镜像
SRT完整访问单元传输
H.264VideoToolbox 编解码
镜像与控制保持独立：只想查看画面时，不会擅自安装或启动控制流程。
把手机，放进 Codex
和 Claude Code。
一键接入，实时画面就在对话旁边。
在「设置 → MCP 自动化」中，「接入 Codex」和「接入 Claude Code」都会一并安装插件和 MCP 工具。新开一个会话，AI 就能在真机上查看、点击、输入并验证。
Codex
查看设置里的「通用」一栏并打开「关于本机」
本地 WebRTC 实时画面已在对话内打开
实时
1
1
手机面板就在聊天里。
加密的本机 WebRTC 把画面送进 Codex。可以切换设备、手动控制，也能冻结画面，用 Command-Enter 发送带编号的标注。
- 对话里的实时画面
- 手动控制与切换设备
- 把标注截图发给 AI
Claude Code
在主屏幕上找到「设置」图标并打开
Vision OCR 在当前画面识别出 24 个可点目标
127.0.0.1 · viewer
14
14
手机就在对话旁边打开。
在 Claude 桌面版里，Claude 第一次操作设备时会自动在浏览器面板中打开实时画面，不用复制链接，也不用摆放窗口。在终端里可以让它给出画面链接。
- 自动在浏览器面板中打开
- 画面、切换设备与手动控制一应俱全
- 本地会话可用，走网关的桌面版也支持
视频只在这台 Mac 上传输；AI 请求的截图和你发送的标注受 AI 客户端的数据设置约束。其他 MCP 客户端可通过生成的配置接入。
本地 Vision OCR，
配合 iOS 无障碍树。
StupidMirror 内置只监听本机的 MCP Server，不捆绑模型、也不索要模型 API Key，直接为你已在用的 Codex 或 Claude Code 提供真机上的精确元素坐标。
MCP 工具与其他客户端先看懂，再操作
最新镜像帧、本地 Vision OCR 与 iOS 访问树共同定位真实目标。
每一步都可见
目标框、点击位置和滑动轨迹只显示在 Mac 侧，方便随时确认与接管。
复杂界面也能找
系统设置、App Store、内容流与自定义业务页面都能获得语义化目标。
面对复杂界面，
依然算得准目标。
拖动浏览截图，点击任意画面可放大查看识别细节。
识别在本地。
控制权也在你手里。
OCR 在 Mac 本地按需运行。操作标记不写回 iPhone，也不烧录进视频流。StupidMirror 自身不内置模型、不要求模型 API Key，更不会主动把屏幕上传给模型服务。
- 127.0.0.1 本机 MCP
- 只在这台 Mac 本地监听，使用 Bearer 令牌认证。
- 按需运行 Vision OCR
- 在 Apple Silicon 本地按需识别，不占用 60 帧画面采集链路。
- 标记仅显示在 Mac 侧
- 目标框与点击轨迹只画在 Mac 窗口上，绝不写回手机屏幕。
常见问题。
需要一直插线吗？
不需要。先用 USB 完成一次「设置这台 iPhone」，之后让 iPhone 和 Mac 处在同一网络，就能通过 Wi-Fi 镜像。无线方式暂不支持声音。
什么时候需要摄像头和麦克风权限？
iPhone 的 USB 和 Wi-Fi 画面都不需要这两项权限。USB 连接时，可选「手机」让声音留在设备上，或选「Mac」在电脑播放。Mac 声音通道需要摄像头和麦克风权限，以访问 USB 音频源。
支持 Android 吗？
支持。Android 11 及以上，开启 USB 调试后通过 ADB 连接。画面和声音来自 scrcpy，控制通过 Appium 与 UiAutomator2。
哪些 AI Agent 可以用？
Codex 和 Claude Code 都有内置插件，一键接入。Codex 在聊天里直接显示手机实时画面，Claude 桌面版则在对话旁边的浏览器面板中打开。其他 MCP 客户端通过本机 MCP Server 接入。StupidMirror 本身不需要模型 API Key。
画面和数据会经过云端吗？
不会。Codex 面板通过加密的本机 WebRTC 传输画面，Claude 里的实时画面是这台 Mac 本机提供的页面，都没有云端中转；MCP Server 只监听本机；文字识别用 Apple Vision 在本地完成。
StupidMirror 免费吗？
单台设备无需登录即可镜像和控制。同时使用多台设备包含在 iTool 年度会员中（¥99/年，含全部 iTool 产品），登录后解锁。源码以 PolyForm Noncommercial 许可公开，商业使用需要另行授权。
运行需要什么条件？
一台 macOS 15 或更新版本的 Mac；iPhone 和 iOS 模拟器支持需要 Xcode。iPhone 真机需信任这台 Mac 并开启开发者模式。USB 和 Wi-Fi 画面都需要先通过 USB「设置这台 iPhone」准备签名的屏幕组件，无障碍自动化与兼容控制也使用该组件。
