快速上手
XPhoneUse 把一台真实手机镜像到桌面,并把它交给 AI 智能体。手机还是那台手机,账号还是你的账号,应用状态一点没变——变的只是操作它的人。
安装
从下载页取 Windows 安装包,双击运行。安装器检测到缺少 Apple Mobile Device Support 时会提示并自动补齐,不需要单独装 iTunes;Android 不需要任何额外驱动。
装好后启动应用,允许它访问 USB 设备。
连接设备
Android
- 手机上打开开发者选项 → USB 调试。
- 插上数据线,手机上点“允许”。
- 应用里出现设备名称与序列号,点它开始镜像。
想让智能体无线工作,就在开发者选项里打开无线调试,之后用 wifi connect <ip>:<port> 连。
iPhone
- 解锁手机,插上数据线。
- 手机上点“信任此电脑”。
- 应用里选中设备。画面、触控、截图、剪贴板所需的开发者镜像由 app 自己下载并挂载(iOS 27+ 首次约 16MB;iOS 16 及更早的机器不用隧道,但截图同样要它,约 7MB)。
- 装这个镜像需要开发者模式:如果它关着,app 会提示 10 秒后自动开启(手机会重启一次),重启后解锁手机再连一次即可。镜像挂好之后开发者模式可以再关掉。
隧道连上后,画面、输入和截图共用这一根线,iOS 16 及更早的机器会自动回退到 AirPlay 镜像。
镜像出来
选中设备后窗口切到实时画面。底部是导航键、旋转、音量、截图、录屏与宏控制。这时你和智能体共用同一条连接——它操作时你可以旁观,也可以随时接管。
交给智能体
在你正在用的智能体对话里输入 请安装 skill:https://xphoneuse.aovik.com/static/skills/xphoneuse.zip,它自己会把 skill 装好,之后就知道怎么连设备了。手动跑一次也就三行:
python scripts/xphoneuse-cli.py list
python scripts/xphoneuse-cli.py connect <serial-or-udid>
python scripts/xphoneuse-cli.py screenshot
或者把 MCP 端点加进客户端:
{
"mcpServers": {
"xphoneuse": { "url": "http://127.0.0.1:7070/mcp" }
}
}
接下来
最后更新 2026-09-17