真正稳定的镜像体验
不用锁屏。
不用来回切换。
StupidMirror 直接使用 macOS 暴露的 iPhone 屏幕源。即使 iPhone 正在使用摄像头，Mac 上的主窗口与独立镜像窗口也能继续显示。
0.5
支持 iOS 模拟器与 Android 模拟器，Agent 可以安装应用、录制屏幕。
把 iPhone 接上 Mac。 剩下的交给 StupidMirror。
USB 或无线，把真实 iPhone 放到 Mac 上。再通过本地 OCR、访问树与 MCP，把它交给你和 AI 一起操作。
适配
CodexClaude CodeModel Context ProtocoliPhone · USB
iPhone · 无线Android 11+SimulatorsWebDriverAgentVision OCR
VideoToolbox H.264iOS 访问树
01 / MIRROR
它是一面镜子，
也是一套设备操作台。
镜像、控制和自动化不再是三套割裂的工具。设备发现、实时画面、独立窗口与 AI 操作，都在一个原生 macOS 应用里完成。
不用锁屏。
USB 即连即用
连接并信任 Mac，设备自动发现。
独立镜像窗口
按真实设备比例展示，适合调试、录屏与演示。
多台 iPhone
输入 SM- 激活码即可解锁多设备功能，无需登录。
原生速度
Swift + AVFoundation / CoreMediaIO，不套一层笨重的浏览器壳。
本地识别
macOS Vision OCR 与 iOS 访问树协同，减少视觉模型盲猜。
MCP 控制
在 iPhone 或 Android 11+ 上执行点击、滑动、长按、输入与清空，直接进入 Agent 工作流。
同时支持 ANDROID
也支持 Android 11+。
开启 USB 调试后，即可在同一个 StupidMirror 工作台中使用实时镜像、设备音频、直接控制和 MCP 自动化。
ADB 设备发现
H.264 + 音频
UiAutomator2 控制
Same MCP 工具
02 / WIRELESS
一根线起步，
之后无线继续。
内置向导会检查设备、Apple 开发账号与画面代理。完成一次准备后，断开 USB，仍可通过局域网获得全分辨率 H.264 镜像。
LAN同网发现与镜像
SRT完整访问单元传输
H.264VideoToolbox 编解码
镜像与控制保持独立：只想查看画面时，不会擅自安装或启动控制流程。
CODEX
把手机，放进 Codex。
连接一次，查看、操作、标注。
在 MCP 自动化设置中点击「连接 Codex」，新建聊天并选中 StupidMirror，即可打开内嵌手机面板。
聊天里的实时画面
通过本机 WebRTC 在 Codex 中查看手机画面；切换设备、暂停或继续，无需另开镜像窗口。
你和 AI 都能操作
开启操作模式即可点击和拖动；AI 观察默认保留图片，搭配精简文字和目标操作工具。
用标注说清楚
冻结画面，移动或缩放编号框，按 ⌘＋回车发送标注截图和说明。输入栏位于画面下方，不遮挡画面。
查看 Codex 使用指南
视频在本机传输；AI 请求的截图和你发送的标注受 AI 客户端的数据设置约束。图片消息需要宿主支持。
03 / AI HARNESS
AI 不是旁观者。
它真的可以操作 iPhone。
StupidMirror 内置只监听本机的 MCP Server。不内置模型，不要求额外填写模型 API Key，把真机能力直接交给你已在使用的 Codex 或 Claude Code。
查看 Claude Code / MCP 接入指南observe_screentap_texttap_elementswipelong_press
type_textreplace_textassert_screenwait_forget_ui_tree
show_screenpress_buttonactivate_appscrollscreenshot
先看懂，再操作
最新镜像帧、本地 Vision OCR 与 iOS 访问树共同定位真实目标。
每一步都可见
目标框、点击位置和滑动轨迹只显示在 Mac 侧，方便随时确认与接管。
复杂界面也能找
系统设置、App Store、内容流与自定义业务页面都能获得语义化目标。
真实画面，真实控制
不是 Demo 页，
是真实世界的 App。
拖动浏览截图，点击任意画面可放大查看识别细节。
04 / PRIVACY
识别在本地。
控制权也在你手里。
OCR 在 Mac 本地按需运行。操作标记不写回 iPhone，也不烧录进视频流。StupidMirror 自身不内置模型、不要求模型 API Key，更不会主动把屏幕上传给模型服务。
- LOCALHOST MCP
- ON-DEMAND OCR
- VISIBLE ACTIONS
05 / USE CASES
一台 Mac，
三种新工作方式。
开发与测试
真机调试、问题复现、流程回归，不再在 iPhone 与 Mac 之间反复切换。
- 真实设备画面
- 可见操作轨迹
- 快速重连 WDA
AI 自动化
通过 MCP 把真机交给 Codex 或 Claude Code，执行可观察、可验证的操作链路。
- 语义化定位
- 本地 OCR
- 点击与文本输入
演示与多设备
独立镜像窗口适合录屏、直播与演示；绑定到账号的 SM- 许可可并行管理多台 iPhone。
- 设备比例窗口
- 多设备并行
- 中英文界面
06 / FAQ
常见问题。
需要一直插线吗？
不需要。先用 USB 完成一次「设置这台 iPhone」，之后让 iPhone 和 Mac 处在同一网络，就能通过 Wi-Fi 镜像。无线方式暂不支持声音。
为什么要摄像头权限？
macOS 把通过 USB 连接的 iPhone 屏幕当作一种摄像头式的采集源。StupidMirror 读取的是这个采集源，不会使用 Mac 的摄像头。
支持 Android 吗？
支持。Android 11 及以上，开启 USB 调试后通过 ADB 连接。画面和声音来自 scrcpy，控制通过 Appium 与 UiAutomator2。
哪些 AI Agent 可以用？
Codex 可以通过内置插件使用，聊天里能直接看到手机实时画面；Claude Code 和其他 MCP 客户端通过本机 MCP Server 接入。StupidMirror 本身不需要模型 API Key。
画面和数据会经过云端吗？
不会。Codex 面板通过加密的本地 WebRTC 传输画面，没有云端中转；MCP Server 只监听本机；文字识别用 Apple Vision 在本地完成。
StupidMirror 免费吗？
单台设备无需登录即可镜像和控制。SM- 激活码可以解锁多台设备同时使用。源码以 PolyForm Noncommercial 许可公开，商业使用需要另行授权。
运行需要什么条件？
一台 macOS 15 或更新版本的 Mac。iPhone 无线镜像和控制还需要在手机上开启开发者模式，并在 Mac 上有 Apple Development 签名身份；使用模拟器需要 Xcode。
