安装应用并连接手机
将 StupidMirror 放入「应用程序」并打开，连接并解锁手机。USB 画面需要信任这台 Mac 并授予摄像头权限；Android 需要授权 ADB。
CODEX 插件
把真实手机放进 Codex 聊天里。
StupidMirror 内置 Codex 插件。Agent 能看到真实 iPhone 或 Android 的实时画面，通过 MCP 操作它；你可以用标注直接指出想说的位置。
四步连接
使用已安装的应用时，不需要克隆仓库、安装 Python / Node.js 或复制令牌。
完成一次 iPhone 设置
首次控制 iPhone 或使用无线画面前，先用 USB 完成「设置这台 iPhone」。
点击「连接 Codex」
在「设置 → MCP 自动化」点击「连接 Codex」。应用会开启本机 MCP，并通过 Codex 桌面应用的 CLI 安装内置插件。
向 Codex 提问
新建 Codex 聊天，选中 StupidMirror，发送：「在 Codex 里显示我的手机，先不要点击。」面板会通过 show_screen 打开。
查看、操作、标注
查看
选择设备，暂停或继续、刷新、回到主屏幕、复制截图。画面直接显示在聊天里，不会另开镜像窗口。
操作
手动开启「操作」后，单击即点击、拖动即滑动。开启之前不会向手机发送任何操作。
标注
冻结当前画面，最多画八个编号框，用 ⌘＋回车把标注截图和说明一起发送。画框不会误触手机。
让 Agent 动手
Agent 按「观察 → 操作 → 观察」的循环工作，用本地 OCR、元素 ID 和定点点击完成任务，并在真机上确认结果。
画面只在这台 Mac 上传输
硬件 H.264 画面通过加密的本地 WebRTC 传输，没有云端中转，也不使用 STUN/TURN。Agent 请求的截图和你主动发送的标注会交给 AI 客户端，受该客户端的数据设置约束。不要把 MCP 连接凭据文件发到聊天里。
常见问题排查
Codex 里没有 StupidMirror 的工具
重新连接插件，并在新的 Codex 聊天中选中它。更新应用后，需要再点一次「连接 Codex」（更新或重新安装插件）。
初始化报错 -32603
旧版本不兼容实验性的客户端能力。升级到 StupidMirror 0.3.1 或更新版本后重新连接插件；重启 Codex 解决不了这个问题。
找不到设备或没有画面
解锁手机，检查数据线和信任提示或 ADB 授权，然后刷新。USB 连接的 iPhone 需要摄像头权限；无线画面需要先完成 iPhone 设置向导。
点击没有反应
等待控制连接完成，确认 iPhone 已开启开发者模式并安装了签名的运行组件，然后重新开启「操作」。查看和控制是分别就绪的。
标注发不出去
宿主需要支持图片消息。如果面板提示输入框不可用，打开对应聊天，让 Codex 再调用一次 show_screen，在新面板中继续。草稿会保留。