Peekaboo 1

使用 Peekaboo CLI 捕获和自动化 macOS 界面

安装

概览

什么是Peekaboo 1

Peekaboo 是一个专为 macOS 设计的全功能 UI 自动化命令行工具,旨在通过简洁的 CLI 接口实现屏幕捕获、界面元素定位、输入驱动以及应用窗口管理等核心操作。该工具支持实时屏幕捕捉与视频导入,并具备智能帧提取能力,同时提供快照缓存机制以优化重复操作的效率。所有命令均兼容 `–json`/`-j` 参数输出结构化数据,极大提升了脚本化集成的便利性。用户可通过 `peekaboo` 或 `peekaboo –help` 快速查阅各子命令的帮助信息,而 `peekaboo –version` 则可查看构建元数据。建议通过 `polter peekaboo` 方式运行以确保使用最新编译版本。

核心功能特点

  1. 支持屏幕录制与 Accessibility 权限检查,确保基础运行环境正常
  2. 提供丰富的目标定位方式:包括元素 ID、坐标点、窗口标题及快照引用
  3. 集成多种交互输入模式:点击、拖拽、滑动、键盘敲击与快捷键组合
  4. 内置截图与图像分析功能,支持自动标注与 OCR 内容识别
  5. 具备完整的系统级控制能力:应用启动/退出、窗口管理、菜单操作与 Dock 控制

适用场景

Peekaboo 特别适用于需要高度自动化 macOS 图形界面操作的场景。例如,在持续集成(CI)流程中,开发者可利用其快速截取特定应用窗口画面并进行视觉验证;测试人员则能借助 `see` 命令生成带注释的 UI 地图,精准定位表单字段或按钮后执行点击与文本输入操作。对于运维人员而言,通过编写 `.peekaboo.json` 脚本可实现无人值守的系统配置变更,如自动登录远程桌面、批量处理文件上传或定期备份任务。此外,结合 `–capture live` 参数进行动态区域监控,也使其成为安全审计或异常行为检测的理想选择。无论是构建跨平台自动化流水线还是替代传统 GUI 测试工具,Peekaboo 都能显著提升执行效率与可靠性。