用途:Peekaboo 是 macOS 全功能 UI 自动化 CLI,用于捕获与检查屏幕、定位 UI 元素、驱动输入,以及管理应用、窗口、菜单和状态栏。命令共享快照缓存,并支持 --json/-j 以便脚本调用。
主要能力:核心命令包括 capture(实时捕获或视频摄取与抽帧)、image(屏幕/窗口/菜单栏区域截图)、see(带注释的 UI 地图与快照 ID,可选分析)、list(应用、窗口、屏幕、菜单栏、权限)、run(执行 .peekaboo.json 脚本)、config、clean、permissions、sleep、tools、learn。交互命令包括 click、drag、swipe、move、scroll、type、press、hotkey、paste,可按元素 ID、查询、坐标或快照定位。系统命令包括 app、window、space、menu、menubar、dock、dialog、clipboard、open、visualizer。
用法:运行 peekaboo 或 peekaboo <cmd> --help 查看参数,peekaboo --version 输出构建信息。典型流程是先授权再定位与操作,如 peekaboo permissions、peekaboo list apps --json、peekaboo see --annotate --path /tmp/peekaboo-see.png、peekaboo click --on B1、peekaboo type "Hello" --return。多数交互命令支持 --app、--pid、--window-title、--window-id、--snapshot、--on/--id、--coords 等定位参数;截图支持 --path、--format、--retina、--analyze、--annotate、--capture-engine。
适用场景:适合在 macOS 上编写脚本化的界面测试、截图与元素检查、应用与窗口操作、菜单与 Dock 控制等自动化任务,并可结合 --json 输出接入其他流程。
限制:需要屏幕录制与辅助功能权限;建议先用 peekaboo see --annotate 识别目标再点击;资料未提供价格、平台之外的支持范围与更多安装细节。