AB
AiBoss
project

poki - 在 iPhone 上替你操作真实 App 的智能体

poki 是一个运行在 iPhone 本机的智能体应用:它读取屏幕、点击、输入与滚动,在你真实使用的 App 里完成任务。本文整理其维护状态、项目自述的能力、安装入口与已知限制。

poki 是一个运行在 iPhone 本机上的智能体应用。按项目自述,它会读取屏幕内容,然后在你真实安装的 App 里点击、输入和滚动,替你完成聊天里交代的任务。它面向的是希望把手机上的重复操作交给模型执行的用户:你只需要在对话里描述目标,剩下的界面操作由 poki 完成。项目同时提供 iPhone 应用与 MCP 两种形态,后者用于接入已有的编码智能体。

维护者与状态

仓库由 JosssphZhou 维护,地址为 github.com/JosssphZhou/poki。仓库创建于 2026-11-05,最后提交时间为 2026-11-16,最新 release 为 app-0.4.3-beta.1,发布于 2026-11-16。截至 2026-11-16,仓库星标数为 1466。从时间线看,这是一个非常年轻且迭代频繁的项目,当前发布版本仍处于 beta 阶段。

主要能力

以下能力均来自项目自述(README),未经独立验证。

  • 在真实 App 中操作:据项目说明,poki 不是模拟环境里的演示,而是在你日常使用的 App 中读取屏幕并执行点击、输入、滚动等动作。
  • 对话式下达任务:用户在聊天界面里给出任务描述,poki 据此在其它 App 中执行。README 给出的首个示例任务是在「备忘录」中新建一条标题为 Poki Demo 的笔记并写入三行内容,完成后打开该笔记。
  • 分级审批机制:项目自述称,支付、删除以及钱包内的操作始终需要用户确认;对于发送消息、输入密码等敏感步骤,用户可以在「设置 > 审批」中选择 poki 以何种方式征询,或是否征询。
  • 两种控制路径:据项目说明,在 iOS 27 及更高版本上,poki 通过系统原生服务控制 iPhone;在 iOS 18 至 26 上则改用 XCTest 会话,需要在 iPhone 的开发者设置中开启 UI 自动化。
  • MCP 形态:README 提到,如果只想在现有编码智能体中使用 poki MCP,可以走 MCP 安装路径,此时使用的是该客户端自身的模型访问能力。
  • 自带更新与续签:应用内提供签名与更新页面,可下载安装新版本;在电脑端也可通过 Poki Setup 的 Renew 完成更新与签名续期。

使用入口

项目仓库位于 JosssphZhou/poki,产品站点为 poki.bot。

据 README,安装需要一次性借助电脑:Mac(macOS 14 或更高)或 Windows x64 电脑,Windows 需先安装 Apple Devices 或 iTunes 以便通过 USB 识别 iPhone。推荐方式是把下面这句话交给编码智能体(如 Claude Code 或 Codex),由它执行仓库中的安装脚本:

Install Poki on my iPhone from https://github.com/JosssphZhou/poki

也可以直接下载 Poki Setup 的 macOS 或 Windows 安装包,按窗口提示操作。安装完成后,任务在 iPhone 上独立运行,不再依赖电脑;但若使用免费 Apple 账户,签名有效期只有 7 天,需要保持 Poki Setup 在电脑上开启以便自动续签,或在 iPhone 上登录 Apple 账户自行续签。

运行任务前还需满足若干前置条件:iPhone 需为 iOS 18 或更高版本(iPhone XS、XR、SE 第二代及更新机型),iPad 需 iPadOS 18 或更高;需要 USB 数据线与 Apple 账户;iPhone 上需有一个能把 10.7.0.1 路由回本机的 VPN 应用;此外还需要用户自己的模型账户,可用 ChatGPT Plus 或 Pro 计划登录,或填入 Anthropic、OpenAI、Gemini、DeepSeek、OpenRouter 的 API Key,也可接入自建的 OpenAI 兼容服务。README 特别说明 Claude 订阅无法登录,需改用 Anthropic API Key;语音对话还需要额外的语音模型 Key。

许可与限制

项目采用 AGPL-3.0 许可证。

README 中列出的已知限制与边界包括:

  • poki 操作的是真实 iPhone,若要求它发送消息或付款,它会照做;屏幕内容会被发送到用户自行配置的模型服务。
  • 实体机验证目前仅覆盖使用中文界面的 iPhone,且仅限竖屏,横屏不受支持;iOS 18 至 26 所用的控制路径尚未在实体 iPhone 上测试。
  • 若无法在 iPhone 上登录 Apple 账户,需回到电脑端用 Poki Setup 完成续签与更新。
  • 更新时不要删除应用来「修复」问题,删除会一并清除对话记录。
  • 更新依赖 GitHub,部分网络可能无法访问或触发 GitHub 的 403、429 限流,可更换网络或代理节点,或改用电脑端更新。
  • 当前安装脚本选择 Beta 通道,历史上 Stable、Alpha、Pre-alpha 的偏好也会解析到 Beta;若无可用 Beta 则停止。

需要说明的是,以上能力描述与限制均出自项目自述,实际表现可能随版本变化,使用前建议对照仓库中的 CHANGELOG 与文档确认。