Pinky可以让任何Agent(Claude Code、Claude Desktop、Codex、Cursor,或者一段脚本)通过MCP操作真实的iPhone或Android手机。它在Agent和手机之间架了一层本机网关,AI发出的每一个动作,都得先过这道门。看看页面、划划列表直接放行。
点到支付、发送、删除,调用挂起,桌面弹窗等你确认。你没反应,超时自动作废,手机什么都没发生。Agent没有任何接口能替你点允许。哪怕屏幕上的文案试图骗它,网关也不认。
打开 Pinky,选「添加手机」。准备好的手机会出现在 Pinky 的窗口里;还缺什么的话,手机页面会告诉你。
Android
「添加手机 › Android」会按你手机的品牌给出下面这些步骤,用的是这个品牌自己的菜单名称,也会列出要额外打开的开关:小米、OPPO、vivo、荣耀、华为、三星和 Pixel,其他品牌给通用步骤。
1.在手机上打开 USB 调试:在「设置 › 关于手机」里连续点「版本号」7 次,然后在「设置 › 系统 › 开发者选项」里打开「USB 调试」。有些品牌的菜单名称略有不同。
2.把手机插到电脑上。手机问是否允许 USB 调试时,点「允许」。Android 11 及以上也可以在「添加手机」里改用 Wi-Fi 配对。Android 10 没有「无线调试」:插上线后,用「改用 Wi-Fi 连接…」就能换成 Wi-Fi。
3.Pinky 会提出给手机装上它的应用,也就是手机上的 Pinky(在手机上显示为 Pinky),能让读屏快很多倍,还能让 Pinky 输入任何语言。手机可能会让你允许安装一次。
每台手机都有「体检」,在投屏下方的 ··· 菜单里。它会列出哪些能用、没通过的怎么改,比如小米的「USB 调试(安全设置)」开关。
通过 Wi-Fi 时,Pinky 会确认应答的是你的手机:它在准备好的每台手机上留下一个标记,只有通过手机的调试连接才能读到,adb 每次连上手机时都会核对,网络上的其他设备没法冒充它。通过「无线调试」连着、但 Pinky 没用过的手机(比如别的工具连上的)会显示为「在 Wi-Fi 上发现」,在你选择「使用」之前 Pinky 不会碰它。如果你自己重置过手机或重新设置过它,之后手机页面显示「这可能不是 …」,就在那里选「信任这台手机…」,或者插一次线。
要带手机出门?装上 Tailscale 后,Pinky 在外面也能连到它。
Android 工具
Pinky 自带 adb,这是它连接 Android 手机用的工具,从 Android 源码构建,所以不用另装任何东西。如果电脑上已经有 Android 的 platform tools(来自 Android Studio、Homebrew 或系统的软件包),Pinky 会用它们,并和 Android Studio 等工具共用同一个 adb 服务。退出 Pinky 时,它会停止自带的 adb,除非 Android Studio 等其他应用正在使用;在「设置 › 高级 › 退出 Pinky 时停止 adb」里可以关掉。你自己安装的 adb 会继续运行。
在 Pinky 里打开「设置 › 智能体」,点你的 Agent 旁边的「接入」。Pinky 会在你的电脑上找到 Claude Code、Claude Desktop、Codex、Cursor、VS Code、Copilot CLI、Windsurf(Devin Desktop)和 Gemini CLI,并用应用自身的路径把自己加进 Agent 的 MCP 服务器:Agent 有自己的命令时用它的命令(比如 claude mcp add),否则写进它的设置文件,写之前先备份一份,而且只改 Pinky 那一项。它还会把 Pinky 的 Agent 指南 SKILL.md 装到 Agent 读取技能的位置,并让它保持最新:Pinky 更新后,会把装好的指南改写成新版本的内容。在接入 Agent 之前,Pinky 侧栏里会有一张卡片,帮你接入,或者告诉你去哪里获取 Agent。
• Claude Desktop:「接入」会在 Claude Desktop 里打开 Pinky 的扩展,在那里点「Install」。双击发布页上的 pinky-.mcpb 效果一样。
• 其他 Agent:「设置 › 智能体 › 手动添加智能体」会给出适用于你这份 Pinky 的命令,旁边有复制按钮。添加一个运行这条命令的 MCP 服务器(stdio)。用 Homebrew cask 或 Linux 软件包安装时,JSON 配置写成:
{ "mcpServers": { "pinky": { "command": "pinkyctl", "args": ["mcp"] } } }
Claude Code 在终端里运行:claude mcp add --scope user pinky -- pinkyctl mcp。大多数 Agent 从 ~/.agents/skills/pinky/SKILL.md 读取指南,Claude Code 从 ~/.claude/skills/pinky/SKILL.md 读取。
命令是 pinkyctl 而不是 pinky:很多电脑上已经有另一个叫 pinky 的程序。另一台电脑上或容器里的 Agent 可以改用 HTTP 连接。
• 哪些 Agent 能用 Pinky?
任何能用 MCP 服务器的 Agent:通过 stdio 运行 pinkyctl mcp,或者用智能体令牌通过 HTTP 连接(怎么连)。「设置 › 智能体」能一键接入 Claude Code、Claude Desktop、Codex、Cursor,以及它在你电脑上找到的其他 Agent。目前在真机上完整跑通的是 Claude Code。动脑子的是你的 Agent;没有 Agent 时,简单的任务可以用你自己的 API 密钥交给 Pinky。
• Pinky 把文件放在哪里,能换个位置吗?
Pinky 的设置、历史记录,以及 Agent 用来连接它的 socket,都放在你的用户目录里:Mac 上是 ~/Library/Application Support/Pinky;Windows 上是 %APPDATA%\Pinky 和 %LOCALAPPDATA%\Pinky;Linux 上是 ~/.config/pinky、~/.local/share/pinky 和 $XDG_RUNTIME_DIR/pinky。想把它们都放到你自己选的一个文件夹里,就把环境变量 PINKY_HOME 设成那个文件夹,Pinky 会用其中的 config、data 和 run。要让 Pinky 和 Agent 都能看到这个变量,比如在 Windows 上设成用户环境变量,或者同时写进 Agent 的 MCP 设置("env": { "PINKY_HOME": "…" }):没带这个变量启动的 Pinky 会用默认位置,也就找不到另一个。macOS 和 Linux 上 socket 的路径不能太长(大约 100 个字符),PINKY_HOME 让它超长时 Pinky 会直接说明。
Windows 上 Agent 通过命名管道连接 Pinky,Claude、Codex 桌面版这类打包(MSIX)的应用里也能连上。旧版 Pinky 用的是 AppData 里的 socket 文件,这些应用看不到它;如果其中的 Agent 连不上 Pinky,请先更新 Pinky。
• Agent 能自己批准有风险的操作,或者被人骗着批准吗?
不能。规则在 Pinky 的网关里执行,网关挡在 Agent 和手机之间。需要你批准的步骤会以 approval_pending 返回给 Agent,你在 Pinky 里点「允许」之前,手机上什么都不会发生;Agent 也没有任何东西可以发来替你确认。真正执行前,Pinky 还会核对按钮是否还在原处,60 秒内没回应就当作拒绝。Pinky 靠按钮上的文字认出这些按钮,支持 10 种语言,长得特别的按钮可能会漏掉:想更严格,「设置 › 安全」里有「在每个操作前都询问」和「只读模式」。
• 哪些东西 Agent 看不到?
银行、钱包和密码管理器类 App(Pinky 自带一份名单,可以在「设置 › 安全」里从手机上的应用中挑选添加):Agent 拿不到它们的画面,它们的通知也会被藏起来,下拉通知栏和锁屏上也一样。别的界面上出现被屏蔽的 App 时,比如通知栏或横幅里它的通知、最近任务里它的卡片,Agent 只会读到那里有东西被隐藏了,Agent 拿到的截图和「活动」里的截图也会用灰块遮住(录屏里保持原样,所以录屏留在你的电脑上:只有你在某次导出时允许,Agent 才拿得到)。Agent 不能往密码框和验证码框里输入。想在模拟器上用测试账号测试登录时,可以在「设置 › 安全 › 允许在虚拟手机上输入密码」里放开(默认关闭),真机上始终不行。Agent 在任务中需要用银行或钱包 App 时,Pinky 会先问你。你允许的话,Agent 在这次任务剩下的时间里可以打开和读取这个 App,你的规则在那里照样会问,Pinky 也不会留下它的截图和录屏:只有画面上才有的文字,Pinky 在内存里看一眼画面识别出来,只把文字交给 Agent,不给图。密码管理器不会提供这个选项。
一次性验证码会在 Agent 读到之前被打码:不管是在短信、邮件、通知里还是屏幕上别的地方,「您的验证码为 482913」到 Agent 那里都是「您的验证码为 ••••••」,Agent 拿到的截图和「活动」里的截图也会用灰块把验证码遮住。价格、电话号码、日期和跟验证码无关的文字里的数字都保持原样。录屏里的验证码保持原样,所以录屏留在你的电脑上:只有你在 Agent 导出某次任务报告时允许,它才拿得到。可以在「设置 › 安全 › 对智能体隐藏验证码」里关掉。
• 手机屏幕会被传到云端吗?
Pinky 不会传。截图、录屏和记录都存在你的电脑上,默认保留 30 天,可以在「设置 › 隐私」里修改,也可以在那里删除。Agent 读到的内容、它保存的截图和报告,以及你在某次导出时允许给它的录屏,会发给你选的那个 Agent,这和你给它用任何工具一样。Pinky 的匿名使用统计从不包含屏幕内容、输入的文字或 App 名。
• Pinky 会在手机上装什么?
Android 上,你点「安装」后会装上手机上的 Pinky,它在手机上显示为 Pinky(2026 年 11 月之前叫 Pinky Companion)。之后 Pinky 会帮它保持最新,并且只在 Agent 工作时开启它的无障碍服务。iPhone 上,iOS 27 及以上不装任何应用:Pinky 只是像 Xcode 那样挂载 Apple 的开发者磁盘映像。iOS 17.4 到 26 上是内含 WebDriverAgent 的 iPhone 上的 Pinky,要你在装有 Xcode 的 Mac 上装一次(在 Pinky 里点「安装 iPhone 上的 Pinky」,或运行 pinkyctl helper install),手机上显示为 Pinky(2026 年 11 月之前是「Pinky 助手」)。
• 怎么手动安装手机上的 Pinky?
有的手机不让电脑通过 USB 安装应用,比如没插 SIM 卡的小米手机打不开「USB安装」,这时可以自己安装手机上的 Pinky。它的安装包 pinky-android.apk 就在 Pinky 里:
• macOS: 在应用里面,路径是 Pinky.app/Contents/Resources/pinky-android.apk:在「应用程序」里右键 Pinky,选「显示包内容」。
• Windows: 在 Pinky 所在的文件夹里,和 Pinky.exe 放在一起。
• Linux: 在 .tar.gz 解压出来的文件夹里,和 pinky 放在一起;用 .deb 安装的在 /opt/pinky/ 里。
通过 USB 安装失败时,手机页面上的「显示 pinky-android.apk」会帮你找到这个文件。把它拷到手机上(用数据线或聊天软件发过去都行),在手机上打开安装;手机可能会先让你允许用来打开它的应用安装应用。装好后 Pinky 会认出它,因为应用和签名都一样,就不会再提示安装了。
在小米、Redmi 和 POCO 手机上,Pinky 点按、输入和开启手机上的 Pinky 的无障碍服务,还需要打开「开发者选项」里的「USB调试(安全设置)」,打开后要重启手机才生效。这个开关和「USB安装」一样要联网向小米核验,也可能要求插 SIM 卡。没有它,手机上的 Pinky 装上了也开不起来,Pinky 在这台手机上也没法点按和输入。
只有手机上的 Pinky 自己的代码改了,它才会出新版本,不是 Pinky 每次更新都有。打开「自动更新」时,Pinky 会通过 USB 试着装一次新版本;手机拒绝的话,侧栏会有一张卡片告诉你,附「显示 pinky-android.apk」,这个版本 Pinky 也不会再试。按上面的方法装上新的 pinky-android.apk 就行。关掉「自动更新」时,打开手机页面就能看到新版本。
• 银行等 App 会发现手机上的 Pinky 吗?
无障碍服务开着的时候,它们能发现。恶意软件常常滥用无障碍服务,所以很多银行 App 在发现某个不是从应用商店装的 App 开着无障碍服务时,会拒绝登录:马来西亚的银行(Maybank、CIMB、HSBC 以及马来西亚银行公会的其他成员,2024 年起)和新加坡的银行(DBS、OCBC、UOB,2023 年起)都是这样,其他地方也有。手机上的 Pinky 就是这样的 App,因为它是 Pinky 通过 USB 装上的。微信、抖音、小红书这类 App 也能看到这个服务,并且会留意自动化操作;我们还没听说它们因为手机上的 Pinky 采取过措施,但让 Agent 操作它们可能违反它们的用户协议。
App 也能看到手机开着 USB 调试或无线调试,Pinky 在每台安卓手机上都需要它;有些 App(包括一些银行 App)在它开着时会提醒你,或者不让你用。只要这台手机还在用 Pinky,它就一直开着。
所以 Pinky 只在 Agent 操作手机时才开启这个服务:任务开始时开启,任务结束或你接管手机后几秒关闭,Agent 一分钟没有操作也会关闭。其余时间它都是关着的,这些 App 照常能用。Agent 工作期间(哪怕是在手机的后台显示器上),它们能看到这个服务:这时要用它们,先在 Pinky 里点「接管」,或者结束任务。
如果完全不想让 Pinky 开启这个服务,从手机上卸载 Pinky(Android 的「设置 › 应用 › Pinky」)。没有它 Pinky 照样能用,只是慢一些:读一次屏约 2 秒而不是 70 毫秒,输入英文以外的文字要经过手机的剪贴板。手机页面上的「以后再说」可以收起 Pinky 重新安装它的提示。
• Pinky 和其他给 Agent 用的手机工具有什么不同?
做 Pinky 之前,我们看了十几个同类方案。没有一个开源项目能同时做到:iPhone 和 Android 都支持,macOS、Windows、Linux 都能跑,能接任意 Agent,并且让人在回路里。多数方案要么靠 Agent 自觉先问你,要么只能整类拦截;Pinky 在 Agent 之外扣住有风险的那一下点按,并且记录每一次运行。
• 把手机交给能执行命令的 Agent 安全吗?
能以你的身份执行命令的 Agent,可以绕开 Pinky 直接接触手机(比如调用 adb),从而跳过它的规则。这类 Agent 请放在接触不到手机的沙盒里运行,或者把手机插到另一台电脑上,让 Agent 通过 HTTP 连接那台电脑上的 Pinky。
v2026.1116.4版本
在 iOS 27 以下的 iPhone 上,手机锁着时按 Home 键现在只会点亮屏幕,不会再报错。
展开内容
访问网络 访问网络连接,可能产生GPRS流量 ------------------------------------- 开机自动允许 允许程序开机自动运行 -------------------------------------