SuperAPI AI 工具集

peekaboo

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

Peekaboo 是面向 macOS 的完整 UI 自动化 CLI,用于捕获和检查屏幕、定位 UI 元素、驱动输入,并管理应用、窗口、菜单与 Dock。命令共享快照缓存,支持 --json/-j 便于脚本化;运行 peekaboo 或 peekaboo <cmd> --help 查看参数,peekaboo --version 打印构建信息。运行 via polter peekaboo 可确保使用最新构建。

核心命令包括 bridge、capture、clean、config、image、learn、list、permissions、run、sleep、tools。交互命令有 click、drag、hotkey、move、paste、press、scroll、swipe、type。系统命令涵盖 app、clipboard、dialog、dock、menu、menubar、open、space、visualizer、window。视觉方面提供 see,用于生成带注释的 UI 地图、快照 ID 和可选分析。

典型流程:先运行 peekaboo permissions 检查权限,再用 peekaboo list apps --json 列出应用,用 peekaboo see --annotate --path /tmp/peekaboo-see.png 生成标注快照,然后 peekaboo click --on B1 点击目标元素、peekaboo type "Hello" --return 输入文本。交互命令支持按应用/窗口、快照 ID、元素 ID 或坐标定位,并可控制焦点与空格切换。截图命令支持 path、format、retina 及 --analyze、--annotate,捕获引擎可选 auto|classic|cg|modern|sckit。动作命令支持时长、步数、延迟、人类化移动配置与滚动方向/平滑等参数。

使用前需授予屏幕录制与辅助功能权限;建议先用 see --annotate 识别目标再点击。其他能力、定价、平台限制与更多细节暂未提供。