mylea1/phongent

选用指南

AI 根据 README 整理 · 2026/11/1 23:31:10

适用场景

适用于需要同时管理多台安卓设备并自动化执行任务的场景，如内容创作与分发、批量操作等。

查看 README 依据

安卓既可以管理其他设备，也可以直接操作本机；iOS 作为主控连接安卓执行端。 | 设备角色 | iOS | Android | | --- | --- | --- | | 作为主控，连接和管理其他安卓设备 | 支持 | 支持 | | 分配任务、查看结果与消息 | 支持 | 支持 | | 查看安卓实时小窗、接管操作 | 支持 | 支持 | | 执行本机 App 操作任务 | — | 支持 | ## 演示视频 ### 回复被控设备的消息 从消息通知进入回复窗口，将回复任务交给对应安卓设备的 agent。 [▶ 查看演示：回复消息通知](docs/media/demos/notification-reply.mp4) ### 控制设备执行任务 向设备下发任务，查看 agent 操作手机的过程。 [▶ 查看演示：控制手机执行任务](docs/media/demos/phone-task-control.mp4) ## 核心功能 - **多设备任务分配**：长按对应设备，直接描述对应设备的任务，或是让主控的任务代理自行下发任务。 - **按组协作**：批量分组、折叠组内头像、选中整组下发任务；支持不同组不同任务，以及组内单独指定任务。 - **内容创作与分发**：主控模型可生成多份文案和文字图卡，将各自内容与任务交给对应设备；支持附带图片。

- **实时小窗**：查看安卓虚拟屏画面，通过点击、滑动和输入接管操作；小窗默认开启，可在设置中关闭。 - **消息集中查看**：按设备、应用、消息来源组织通知，查看详情并通过目标设备的 agent 回复。 - **集中配置**：管理记忆、技能、定时任务、操作路线等，按功能选择单台或批量操作。 - **连接与管理**：局域网发现、授权连接、一键连接、断线重连、设备重命名和已连接设备网格。 ## 怎么下发任务 例如： ```text A 打开小红书主页并截图，B 打开浏览器查看今天的天气。 ``` ```text 内容组分别生成一份产品介绍草稿，检查组查看各设备的任务状态。 内容组里的 A 改为整理已有素材，其余设备继续生成草稿。 ``` ```text 为内容组的每台设备生成不同的标题、正文和文字图卡， 分别下发给对应设备，保存为草稿，暂不发布。 ``` ## 快速开始 1. **安装本项目的构建。** 安卓安装 对应 APK；iOS 当前通过 Xcode 构建并签名安装。请勿用上游项目的 APK 替代本项目执行端，它可能缺少群控接口。 2. **配置安卓执行端。** 在应用内完成模型配置和手机操作设置，按功能授予无障碍、通知读取等所需权限。手机操作的底层设置可参考[设置指南](docs/setup-guide.md)，其中部分名称仍沿用上游。

使用方式

通过安装 APK 或使用 Xcode 构建 iOS 应用，在应用内配置模型和权限后，通过主控界面连接设备并下发任务。

查看 README 依据

- **实时小窗**：查看安卓虚拟屏画面，通过点击、滑动和输入接管操作；小窗默认开启，可在设置中关闭。 - **消息集中查看**：按设备、应用、消息来源组织通知，查看详情并通过目标设备的 agent 回复。 - **集中配置**：管理记忆、技能、定时任务、操作路线等，按功能选择单台或批量操作。 - **连接与管理**：局域网发现、授权连接、一键连接、断线重连、设备重命名和已连接设备网格。 ## 怎么下发任务 例如： ```text A 打开小红书主页并截图，B 打开浏览器查看今天的天气。 ``` ```text 内容组分别生成一份产品介绍草稿，检查组查看各设备的任务状态。 内容组里的 A 改为整理已有素材，其余设备继续生成草稿。 ``` ```text 为内容组的每台设备生成不同的标题、正文和文字图卡， 分别下发给对应设备，保存为草稿，暂不发布。 ``` ## 快速开始 1. **安装本项目的构建。** 安卓安装 对应 APK；iOS 当前通过 Xcode 构建并签名安装。请勿用上游项目的 APK 替代本项目执行端，它可能缺少群控接口。 2. **配置安卓执行端。** 在应用内完成模型配置和手机操作设置，按功能授予无障碍、通知读取等所需权限。手机操作的底层设置可参考[设置指南](docs/setup-guide.md)，其中部分名称仍沿用上游。

3. **连接设备。** 主控与执行端接入同一局域网，保持安卓端服务运行；主控在“设备”页选择设备或点击“一键连接”，首次连接在安卓端允许。已授权设备支持重连。 4. **配置主控模型。** 在主控设置中配置任务下发模型；账号登录在对应设备上完成。 5. **开始协作。** 在 agent 页选择全部、设备组或单台设备，输入任务，按设备查看进度和结果。 ### 设备与分组 - 下方网格只显示已连接设备，卡片标注名称与所属组。 - 点击“分组”，勾选设备，选择已有组或新建组，再点击“移动 N 台”。 - 每台设备属于一个组；移动后离开原组。未分组的设备归入“默认组”。 - 长按设备头像或卡片，可重命名或移动分组。重命名会同步到对应安卓 App 内的设备名称，需要执行端支持该接口。 - agent 页左侧按组显示头像，支持折叠。分组保存在当前主控端，不会自动同步到其他主控。 ### 四个入口 | 入口 | 用途 | | --- | --- | | 设备 | 发现、连接、重命名、分组 | | agent | 分配任务、查看执行结果和实时小窗 | | 消息 | 按设备、应用、来源查看通知 | | 设置 | 配置主控、执行端及同步选项 | ## 开发与构建 | 目录 | 内容 | | --- | --- | | `app/` | Android 应用、主控界面和执行端服务 |

部署要求

Android 最低版本 Android 11，iOS 最低部署版本 iOS 17；需要 JDK 17 和 Android SDK（compileSdk 36）进行 Android 构建，iOS 需要 macOS 和 Xcode。

查看 README 依据

| `core/` | agent 核心能力 | | `ios/` | iOS 主控、组件与实时活动 | | `tools/android-emulators/` | 安卓模拟器联调工具 | | `docs/` | 设置指南、协议和验证记录 | **Android**：JDK 17、Android SDK（当前 compileSdk 36）；最低安装版本 Android 11，具体手机操作能力另受系统版本与权限限制。 ```sh ./gradlew :app:assembleDebug ``` 产物位于 `app/build/outputs/apk/debug/`；安装前确认构建产物已使用自己的开发签名签署。 **iOS**：macOS、支持项目所用 SDK 的 Xcode，最低部署版本 iOS 17。打开 `ios/MikaRemote.xcodeproj`，选择 `MikaRemote` scheme，在签名设置中选择自己的开发团队后构建。 模型密钥、账号凭证和本机签名材料不应写入源码。 ## 联系作者 - **X**：[mylea · @myleafy1](https://x.com/myleafy1) - **微信**：

已知限制

iOS 仅作为主控，不支持本机执行；Android 执行端需要授予无障碍、通知读取等权限。

查看 README 依据

安卓既可以管理其他设备，也可以直接操作本机；iOS 作为主控连接安卓执行端。 | 设备角色 | iOS | Android | | --- | --- | --- | | 作为主控，连接和管理其他安卓设备 | 支持 | 支持 | | 分配任务、查看结果与消息 | 支持 | 支持 | | 查看安卓实时小窗、接管操作 | 支持 | 支持 | | 执行本机 App 操作任务 | — | 支持 | ## 演示视频 ### 回复被控设备的消息 从消息通知进入回复窗口，将回复任务交给对应安卓设备的 agent。 [▶ 查看演示：回复消息通知](docs/media/demos/notification-reply.mp4) ### 控制设备执行任务 向设备下发任务，查看 agent 操作手机的过程。 [▶ 查看演示：控制手机执行任务](docs/media/demos/phone-task-control.mp4) ## 核心功能 - **多设备任务分配**：长按对应设备，直接描述对应设备的任务，或是让主控的任务代理自行下发任务。 - **按组协作**：批量分组、折叠组内头像、选中整组下发任务；支持不同组不同任务，以及组内单独指定任务。 - **内容创作与分发**：主控模型可生成多份文案和文字图卡，将各自内容与任务交给对应设备；支持附带图片。

- **实时小窗**：查看安卓虚拟屏画面，通过点击、滑动和输入接管操作；小窗默认开启，可在设置中关闭。 - **消息集中查看**：按设备、应用、消息来源组织通知，查看详情并通过目标设备的 agent 回复。 - **集中配置**：管理记忆、技能、定时任务、操作路线等，按功能选择单台或批量操作。 - **连接与管理**：局域网发现、授权连接、一键连接、断线重连、设备重命名和已连接设备网格。 ## 怎么下发任务 例如： ```text A 打开小红书主页并截图，B 打开浏览器查看今天的天气。 ``` ```text 内容组分别生成一份产品介绍草稿，检查组查看各设备的任务状态。 内容组里的 A 改为整理已有素材，其余设备继续生成草稿。 ``` ```text 为内容组的每台设备生成不同的标题、正文和文字图卡， 分别下发给对应设备，保存为草稿，暂不发布。 ``` ## 快速开始 1. **安装本项目的构建。** 安卓安装 对应 APK；iOS 当前通过 Xcode 构建并签名安装。请勿用上游项目的 APK 替代本项目执行端，它可能缺少群控接口。 2. **配置安卓执行端。** 在应用内完成模型配置和手机操作设置，按功能授予无障碍、通知读取等所需权限。手机操作的底层设置可参考[设置指南](docs/setup-guide.md)，其中部分名称仍沿用上游。