FAQ常见问题
Poki App installs through Poki Setup without Xcode and can run on the iPhone with your Mac off. Poki MCP and the Mac-side Agent have different requirements. See the App and MCP installation guide.Poki App 通过 Poki Setup 安装,不需要 Xcode,Mac 关机后仍可在 iPhone 上运行。Poki MCP 与 Mac 端 Agent 的要求不同,参见 App 与 MCP 安装指南。
How does Poki work?Poki 的工作原理是什么?
Poki reads the iPhone screen structure via the accessibility tree, lets the model decide the next step, and dispatches native touch and input events to the physical device. Once a run passes verification, the Self-Learning Framework compiles the trace into a parameterized route for deterministic reuse.Poki 读取 iPhone 的屏幕无障碍树,由模型决定下一步操作,再将原生触摸和输入事件发送到真实设备。任务通过核验后,自学习框架会将执行轨迹编译为参数化路线,供后续直接复用。
How is this different from the iOS Simulator?和 iOS 模拟器有什么区别?
Poki can control the apps and signed-in accounts on a physical iPhone. Poki MCP also supports iOS Simulators; physical-device and simulator capabilities differ.Poki 可以操作实体 iPhone 上已安装的 App 和已登录账号。Poki MCP 也支持 iOS 模拟器,真机与模拟器的可用能力不同。
Which apps work with Poki?支持哪些 App?
Poki reads accessibility data with OCR fallback. App behavior varies; canvas views, games, and unsupported orientations can limit control. Physical MCP verification covers Chinese interfaces in portrait orientation, not every app.Poki 读取无障碍数据,并可回退到 OCR。应用表现不同,画布、游戏和不支持的方向可能限制控制。实体 iPhone 的 MCP 验证覆盖中文界面的竖屏使用,不代表所有 App 都经过验证。
How do I connect my own agent setup?如何接入现有的工作流?
You can run Poki Agent directly with your OpenAI account, or connect MCP clients like Claude Code and Codex straight to the Poki MCP server. Already using Claude Code, Codex, or another MCP client? Connect Poki MCP and use your own subscription. No extra model account needed.可运行内置的 Poki Agent 并配置 OpenAI 账号;使用 Claude Code 或 Codex 时,将 Poki MCP 注册为本地 MCP 服务即可调用设备控制工具。已经在用 Claude Code、Codex 或其他 MCP 客户端?接入 Poki MCP,直接用你自己的订阅,不需要另外登录模型账号。
What hardware do I need?需要哪些硬件?
Poki App requires iOS 18+, a USB data cable, an Apple Account, and Poki Setup. The Mac installer requires macOS 14+ and Node.js 24+, while a bundled standalone CLI covers Windows or machines without Node.js. During setup, configure the phone's local VPN/proxy connection, Developer Mode, UI Automation, and model provider, and keep the iPhone on Wi-Fi until initial setup completes. Free Apple Account signing lasts seven days. Building Poki MCP from source requires macOS 15+, full Xcode, Node.js 24+, Rust, Python 3, and ffmpeg.Poki App 需要 iOS 18+、USB 数据线、Apple Account 和 Poki Setup。Mac 安装程序需要 macOS 14+、Node.js 24+;Windows 或没有 Node.js 时可用内置命令行工具。手机须配置本机 VPN 或代理连接、开发者模式、UI 自动化和模型,首次配置完成前要一直连着 Wi-Fi。免费签名有效期为七天。MCP 源码构建则需要 macOS 15+、完整 Xcode、Node.js 24+、Rust、Python 3 和 ffmpeg。
What does it cost?费用如何计算?
Poki MCP and Poki Agent are free and open source (AGPL-3.0). Model usage is billed directly to your own provider account. Already using Claude Code, Codex, or another MCP client? Connect Poki MCP and use your own subscription. No extra model account needed.Poki MCP 与 Poki Agent 开源(AGPL-3.0 协议),可免费使用,模型调用按自有账户计费。已经在用 Claude Code、Codex 或其他 MCP 客户端?接入 Poki MCP,直接用你自己的订阅,不需要另外登录模型账号。
Disclaimer免责声明
Poki is an independent open source project. It is not affiliated with, or endorsed by, Apple, OpenAI, or the makers of any app or website it operates. iPhone is a trademark of Apple Inc.Poki 是独立的开源项目,与 Apple、OpenAI 以及它所操作的任何应用或网站的开发者均无关联,也未获得其认可。iPhone 是 Apple Inc. 的商标。
Automating third-party apps and websites may violate their terms of service. Decide for yourself whether to use Poki with a given service. You are responsible for what it does on your device and accounts, including messages it sends, changes it makes, and any account restrictions that result.自动操作第三方应用和网站可能违反其服务条款,请自行判断是否在相应服务上使用 Poki。Poki 在你的设备和账号上执行的操作由你负责,包括它发送的消息、作出的更改,以及由此导致的账号限制。
Poki is provided "as is", without warranty, as set out in the AGPL-3.0 license.Poki 按「原样」提供,不附带任何担保,具体以 AGPL-3.0 许可证为准。