roubao

# 肉包 Roubao 2.0 for iPhone · iPhone AI Agent

**让 AI 直接操作你的 iPhone：看屏幕、点按、输入、跨应用完成任务，支持在用户授权下操作微 x。**

**运行时无需 Wi-Fi、无需越狱、无需电脑、无需额外硬件。支持纯蜂窝网络，在 iPhone 上独立运行 Agent。**

[English](README_EN.md) · [Android 旧版在下方](#android) · [详细安装教程](ios/docs/INSTALL.md) · [使用指南](ios/docs/USAGE.md) · [验证与限制](ios/docs/VALIDATION.md) · [架构](ios/docs/ARCHITECTURE.md)

![iOS 26+](https://img.shields.io/badge/iOS-26%2B-black)
![Swift and Rust](https://img.shields.io/badge/Swift%20%2B%20Rust-orange)
[![AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue)](ios/LICENSE)

> **首次配置仍需 Mac + USB**：编译签名、安装、开启开发者模式、生成并导入本机配对文件。配置完成后，Mac 可以关机、USB 可以拔掉。签名到期或配对失效时需要维护。“独立运行”指任务循环和手机控制在本机，模型推理使用你配置的联网 API，**不代表离线大模型**。当前发布为开发者源码预览版。

## 真机演示（3× 速度）

[![肉包 2.0 for iPhone 真机演示：应用检索、PDF 报告与原生分享](https://img.youtube.com/vi/H0GKo_TD2i4/hqdefault.jpg)](https://www.youtube.com/watch?v=H0GKo_TD2i4)

**[▶ 在 YouTube 观看完整演示](https://www.youtube.com/watch?v=H0GKo_TD2i4)** · 约 1 分 18 秒 · 英文字幕与背景音乐

真实 iPhone 上的应用资料查询、PDF 报告与原生分享流程；保留完整操作顺序，以 **3× 速度**展示。点击封面即可观看视频。

## 平台版本与入口

| 平台 | 状态 | 源码与文档 | 许可 |
|---|---|---|---|
| **iPhone · 肉包 2.0** | 当前开发者预览版 | [iOS 源码](ios/) · [安装教程](ios/docs/INSTALL.md) · [使用指南](ios/docs/USAGE.md) | [AGPL-3.0](ios/LICENSE) |
| **Android · 旧版** | 暂未更新，保留历史版本 | 根目录 `app/` · [旧版中文文档](docs/ANDROID.md) · [Android V1.4.2](https://github.com/Turbo1123/roubao/releases/tag/V1.4.2) | [MIT](LICENSE) |

以下内容主要介绍 **肉包 2.0 for iPhone**。Android 代码与原有构建目录保留；iPhone 2.0 的能力不代表安卓版已更新。[分平台许可说明](LICENSING.md)

## 把“AI 手机”的跨应用能力带到 iPhone

**不必换手机：自选模型、微 x操作、任务续聊、PDF 报告，把 AI 手机的操作体验带到你现有的 iPhone。**

你说目标，肉包观察实际页面，规划并执行步骤；需要你选择或授权时发通知、出卡片，收到回答后继续。可以把它理解为把类似“豆包手机”的 AI 操作体验带到现有 iPhone，无需更换手机或外接控制板。本项目与豆包、字节跳动及 Apple 无官方关联，不承诺功能等同。

肉包 2.0 是 **open-source iPhone AI agent / iOS automation / phone-use harness**，基于 [iphone-use-app](https://github.com/EliotAndres/iphone-use-app) 扩展，保留上游贡献和 AGPL-3.0 许可。Android 旧版保留在本仓库根目录；新版 iOS 源码位于 `ios/`。

## 能做什么

| 能力 | 使用方式 |
|---|---|
| 跨应用操作 | 启动应用、截图、点按、长按、滑动、中文/英文/Emoji 输入、返回主屏幕 |
| **微 x控制（实验性）** | 用户授权下操作微 x界面与分享文件；已有生成的 PDF 在指定聊天中实际发送的开发验证 |
| 搜索与整理 | 查询地图地点、查商品页面、整理不同应用里的可见信息 |
| 比价与 PDF | 比较指定平台的同款商品、配置、可见价格及优惠条件，生成带表格/截图的报告 |
| 完成后继续聊 | “把刚才报告缩成两页”“补一个平台”；保留本会话历史、文件和已完成工作 |
| 用户参与决策 | 一次一张问题卡，可返回修改，最后统一提交；等待时发送本地通知 |
| 长任务与恢复 | 默认 100 步，到达后询问是否加 50 步；检查点和继续任务保留进度 |
| 动态岛进度 | 查看阶段和步骤、随时停止；刷新频率由 iOS 决定 |
| 文件与分享 | 原生 PDF、文件列表、QuickLook 预览及关闭、iOS 系统分享面板；报告可继续修改 |
| 流式语音输入 | 可选豆包/火山引擎 ASR，边说边显示，结束后先手动改再发送 |
| 自选模型 | 手机内填写兼容接口 Base URL、Key、模型 ID；可选 TypeSafe JEV 加速执行 |
| 卡住时主模型接管 | 本地 OCR 辅助定位，两次定位无进展/失败后要求主模型多模态重新定位 |

上述是实现能力，**不是每项业务都经过完整验收**。已有计算器、信息查询、比价 PDF、语音等开发验证；不保证无人值守发送、下单和支付可靠。[验证范围与已知问题](ios/docs/VALIDATION.md)

## 微 x也能协助操作

肉包支持在你授权的情况下操作微 x界面，使用通用截图、点击、输入及系统分享通道；已有将生成的 PDF 发到指定聊天中的真机开发记录。你可以让它：“把刚才的 PDF 分享到我指定的微 x聊天，发送前让我核对接收人与文件。”

微 x能力仍处于实验验证阶段，发送前请核对联系人、文件和内容。历史测试出现过重复发送及误点，已补充通用授权与重复动作保护，但修复后尚未重新完成完整发送验收；不承诺所有微 x页面或无人值守发送可靠。具体记录见 [验证范围与已知问题](ios/docs/VALIDATION.md)。不绕过微 x登录、验证或系统授权。

## 要安装 WDA 吗？

**不用。当前版本不依赖 WebDriverAgent、