peekaboo

Peekaboo 是一款面向 macOS 的综合性 UI 自动化 CLI 工具封装，由知名 iOS/macOS 开发者 Peter Steinberger（steipete）创建。该 skill 本身仅作为文档和元数据封装，实际功能依赖通过 Homebrew 安装的 peekaboo 二进制工具。

核心用法：用户可通过自然语言指令调用丰富的 CLI 命令，涵盖屏幕捕获（image、、capture、、see）、输入模拟（click、、type、、press、、hotkey、、drag、、scroll）、应用与窗口管理（app、、window、、menu、、dock）、系统交互（clipboard、、dialog、、space）等场景。所有命令支持 --json 输出便于脚本集成，，see 命令提供带标注的 UI 元素识别，是构建自动化工作流的核心入口。

显著优点：功能覆盖极为全面，从基础截图到复杂的跨应用自动化均可实现；命令设计遵循 Unix 哲学，参数一致性强，学习曲线相对平缓；支持 --analyze 进行 AI 视觉分析（需注意网络传输）；作者为业界知名开发者（PSPDFKit 创始人），项目透明度高、文档详尽；通过 Homebrew 分发，安装便捷。

潜在缺点与局限性：仅支持 macOS 系统，跨平台兼容性为零；依赖外部二进制工具，skill 本身无法独立运行；--analyze 功能可能将屏幕内容传输至远程服务器，存在隐私顾虑；需要授予 Screen Recording 和 Accessibility 两项敏感系统权限，安全门槛较高；CLI 工具为闭源二进制，无法完全审计内部实现。

适合的目标群体：macOS 高级用户、自动化测试工程师、需要批量处理 UI 工作流的产品团队、以及希望用脚本替代重复性手动操作的技术从业者。特别适合已有 Homebrew 生态、熟悉命令行工具的用户。

使用风险：性能方面，频繁的屏幕捕获和 UI 元素解析可能带来一定系统开销；依赖项方面，工具更新依赖作者维护的 Homebrew tap，非官方核心仓库存在供应链风险；安全方面，授予的权限可被滥用于监控用户操作、捕获敏感信息或在后台执行未授权操作，建议配合 --no-remote 参数使用并定期审查权限状态。

Peekaboo 是由知名 macOS 开发者 Peter Steinberger（steipete，PSPDFKit 创始人）开发的 macOS UI 自动化 CLI 工具的官方文档型 Skill。该工具定位为"完整的 macOS UI 自动化解决方案"，核心能力涵盖四大领域：

核心功能：支持屏幕/窗口/菜单栏截图（image/see）、实时视频捕获与帧提取（capture）、UI 元素识别与注释（see --annotate）、应用/窗口/菜单管理（app/window/menu/menubar/dock）、鼠标键盘交互（click/drag/type/hotkey/scroll/swipe/move/press）等 30+ 命令。

显著优点：
1. 来源顶级可信：维护者 steipete 是 GitHub 15+ 年历史的资深开发者，PSPDFKit 创始人，行业声誉极佳
2. 功能覆盖全面：从基础截图到复杂的多步骤自动化脚本（.peekaboo.json），支持 --json 输出便于编程集成
3. 智能交互设计：支持元素 ID/坐标/查询多模式定位，内置智能等待、平滑移动、人类化输入曲线等人机工程优化
4. 现代架构：基于 Swift/Cocoa 原生实现，通过 Homebrew 官方渠道分发，更新及时

潜在局限：

• 平台独占：仅支持 macOS（Darwin），无 Windows/Linux 版本
• 权限门槛高：必须授予屏幕录制和辅助功能权限，企业环境可能受 MDM 策略限制
• 学习曲线：30+ 命令及复杂参数体系需要一定学习时间，虽提供 learn 命令内置完整指南
• 独立工具依赖：Skill 本身仅为文档，实际功能需额外安装 peekaboo CLI（约 50MB+ 二进制）

适合人群：macOS 平台的质量工程师、自动化测试开发者、需要批量 UI 操作的效率用户、Apple 生态下的 RPA 需求者。不适合无编程背景的最终用户或跨平台需求场景。

常规风险：CLI 工具本身涉及系统级控制（模拟键盘输入可触发敏感操作、屏幕录制可能捕获机密信息），建议在受控环境使用，避免在生产系统执行未经验证的 .peekaboo.json 脚本。