DIYgod/pinky

项目介绍

Pinky 是一个运行在 macOS、Windows 和 Linux 上的桌面程序，它通过 MCP 把连接好的 iPhone 或 Android 手机交给 AI agent 使用。Claude Code、Claude Desktop、Codex、Cursor，或任何能运行 MCP 服务的脚本，都可以看到手机屏幕、点击、输入并读取结果；Pinky 自身不带模型，只负责手机接入层和安全检查。

它的关键设计是把高风险操作拦在网关里，而不是交给 agent 自律。付款、转账等被标记的点击会以 approval_pending 返回给 agent，用户在 Pinky 窗口点击 Allow 之前手机上什么都不会发生，agent 无法自己批准，60 秒内不响应视为拒绝。界面是 Go/MyGo 原生窗口，不用 Electron 或 webview；每次任务都会在本地保存分步记录、截图和屏幕录像。

快速使用

1. 从最新发布页下载安装：Mac 选 arm64 或 amd64 的 .dmg（也可 brew install --cask diygod/tap/pinky），Windows 用 pinky-setup-<version>-amd64.exe，Linux 用 .deb 或 .tar.gz。Windows 安装包尚未签名，SmartScreen 需要选择 More info → Run anyway 安装步骤。

2. 连接手机。Android 需打开 USB 调试，在手机上点 Allow，并接受可选的 Pinky Companion 安装；iPhone 需信任电脑、打开开发者模式并挂载开发者磁盘映像（Android 设置、iPhone 设置）。

3. 打开 Settings › Agents，在对应 agent 旁点 Connect，或者手动把 Pinky 注册为 MCP stdio server。任何支持 MCP 的 agent 都可用，命令是 pinkyctl mcp 而不是 pinky：

   { "mcpServers": { "pinky": { "command": "pinkyctl", "args": ["mcp"] } } }
   

   Claude Code 终端里可执行：claude mcp add --scope user pinky -- pinkyctl mcp。

4. 让 agent 在手机上做一件事，例如打开 Messages 回复某人。首次连接会询问授权范围；被标记的步骤会在 Pinky 窗口中等待你点击。

没有手机时，退出 Pinky 后用 --fake 启动，会得到两台脚本化演示手机（含一笔待审批付款、一个被屏蔽的银行 App、一个密码输入框）。

各平台手机支持

iOS 的能力随版本变化。iOS 27 及以上使用 Xcode 的 Device Hub 协议，手机端不装任何东西；iOS 17.4 到 26 需要在 Xcode 中构建并安装一次 WebDriverAgent helper，免费 Apple ID 签名的 helper 每 7 天要重装。这些版本上如果不装 helper，Pinky 只能看屏幕（仅 macOS）和打开 App，不能点击、滑动或输入。iOS 17.3 及更早不支持，完整对照见 phones。

Android 13 及以上，agent 工作在隐藏的第二屏幕上，手机自己的屏幕可以关着或锁着。随附的 companion App 把读屏耗时从约 2 秒降到约 70 毫秒，并支持任意语言输入。Android 支持 10 到 17；应用自带 adb，Windows 上部分手机需要厂商 USB 驱动，Linux 上需要配置 udev 规则。

使用约束

• 桌面要求： macOS 12+、Windows 10/11 x64，或 glibc 2.29+ 且带 GTK 3 的 64 位 Linux。iPhone 实时画面预览需要 macOS。
• 成熟度： 处于 pre-alpha。Claude Code 是唯一在真机上端到端跑通过的 agent，其余功能已实现但部分仍待人工验证，清单见 验收文档。
• 信任边界： 能在同一台电脑上执行任意命令的 agent，可以绕开 Pinky 直接走 adb 操作手机。README 建议把这类 agent 放进沙箱，或从另一台机器经 HTTP 连接 Pinky。
• 隐私： 截图、录像和历史默认保存在本机 30 天。匿名使用计数和崩溃报告默认开启，可在 Settings › Privacy 或通过 DO_NOT_TRACK=1 关闭。
• 许可： Apache-2.0，无需注册账号。

HotRepo 点评

HotRepo 上该项目只有 2026-11-08 一条新项目快照：151 星、9 个 fork，一小时内净增 40 星，尚未记录到全语言日榜名次。这只是单点早期数据，不能说明持续采用。更值得关注的是它对 pre-alpha 状态的坦白：README 把已在真机上验证的部分和未验证的部分分开写，并附上验收清单供读者核对。对评估这类"让 agent 操作手机"工具的读者来说，这种透明度比早期星数更有参考价值，而当前的星数还太薄，谈不上热度判断。