kevinbadi/Kevs-IOS-Agents
AI 工程在 Mac 上托管真实 iPhone 集群,支持实时控制、定时任务和 TikTok/Instagram 自动化。
项目介绍
Phone Farm iOS 是一个自托管的独立应用,用来从 Mac 操作实体 iOS 设备。它负责引导式设备注册、WebDriverAgent(WDA)与 Appium 进程监管、实时视频和远程输入,并提供一个以 PostgreSQL 为后端的调度器来执行周期性任务。内置插件覆盖 TikTok 和 Instagram 工作流,仪表盘/API 服务和执行历史可以查看实际运行情况。
调度器把每个任务持久化为 pluginId、taskType、taskVersion 和 JSON payload,旧计划不会在任务契约变化后静默执行。插件是扩展点:可以添加带版本的任务、注册检查、设备页面面板、带命名空间的 HTTP 路由和声明的 WDA 扩展。src/example-plugin.ts 是一个最小的打开应用插件示例。
快速使用
需要 Node 22+、PostgreSQL、Xcode、已签名的真实设备 WebDriverAgent,以及 Appium 的 XCUITest driver。在仓库目录中执行:
npm install
cp .env.example .env
npm run appium:install-driver
npm run db:up
npm run db:migrate
npm run wda:prepare
然后分别启动四个常驻进程;如果主机需要长期在线,用 launchd 或 systemd 托管:
npm run appium
npm run wda:service
npm run worker
npm run web
完成后打开仪表盘,按引导注册设备。入门文档覆盖安装、配置、运行和设备注册;架构文档说明四个进程和数据存储。线上演示与操作讲解在 gethandler.ai/ios-farm。
使用约束
绑定回环地址时可以不启用认证;一旦把 WEB_HOST 绑定到回环之外,就必须通过 PHONE_FARM_AUTH_PLUGIN 提供 ESM 认证提供者,否则启动会主动失败。共享或对外部署时,项目建议自行提供 AuthProvider 和进程监管,而不是改核心代码。对外暴露仪表盘前请先阅读 SECURITY.md。
TikTok 和 Instagram 支持默认开启,额外任务插件通过逗号分隔的 ESM 包名配置在 PHONE_FARM_PLUGINS 中。插件兼容性和信任规则见 PLUGIN_DEVELOPMENT.md。
仓库只使用 GitHub 托管的 CI,其策略要求不要把生产设备、Apple 签名材料、生产数据库、自托管 runner 或部署凭据接入由 PR 触发的工作流。项目采用 Apache-2.0 许可证。
HotRepo 点评
该仓库暂无 HotRepo 榜单快照或讨论记录,无法从站内数据判断其热度走势。更值得看的是设计取舍:带版本的任务契约、拆分清楚的进程,以及可替换的认证提供者边界,分别针对插件 API 变动影响旧计划、以及设备控制暴露到 localhost 之外这两类实际问题。评估时要把已签名 WDA 和真实 iPhone 环境带来的运维成本算进去,这通常是上手时投入最多的部分。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- mylea1/phongent用自然语言从一台 iOS 或安卓主控管理多台安卓设备 agent,集中查看进度、消息与实时画面。
- phone-harness/mcp这是一个托管 MCP 服务,让 AI 智能体在云端操控真实 iPhone 和 Android 模拟器。
- swipt-automation/swipt用 TypeScript SDK、命令行和兼容 MCP 的接口来脚本化控制 iPhone 和 iPad 的自动化平台。
- JosssphZhou/poki让 Claude Code、Codex 等 MCP 客户端通过 Mac 操控真实 iPhone,无需越狱或额外硬件。
- phoneuse-official/phoneuse在 Mac 上通过提示词、实时画面、REST 与 MCP 控制 USB 连接的 iPhone 的开源本地工具。