SuperAPI AI 工具集

peekaboo

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:Peekaboo 是面向 macOS 的完整 UI 自动化 CLI,用于截屏与检查屏幕、定位 UI 元素、驱动输入,以及管理应用、窗口、菜单和 Dock。命令共享快照缓存,支持 --json/-j 便于脚本化。

主要能力:核心命令包括 bridge(检查 Peekaboo Bridge 连接)、capture(实时捕获或视频导入与抽帧)、clean、config、image(截取屏幕/窗口/菜单栏区域)、learn、list(应用、窗口、屏幕、菜单栏、权限)、permissions、run(执行 .peekaboo.json 脚本)、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 输入文本。多数交互命令支持 --app、--pid、--window-title、--window-id、--window-index、--snapshot、--on/--id、--coords 等定位参数,以及 --no-auto-focus、--space-switch 等焦点控制。捕获参数包括 --path、--format png|jpg、--retina、--mode、--analyze、--annotate、--capture-engine。运动与输入参数包括 --duration、--steps、--delay、--profile human|linear、--wpm、--direction、--amount、--smooth。全局运行标志有 --json/-j、--verbose/-v、--log-level、--no-remote、--bridge-socket。可运行 peekaboo 或 peekaboo <cmd> --help 查看标志,peekaboo --version 打印构建信息。

适用场景:适合在 macOS 上做界面自动化、截图与元素定位、应用与窗口管理、菜单与 Dock 操作、鼠标键盘模拟,以及通过 JSON 输出接入脚本流程。

限制:需要屏幕录制与辅助功能权限;点击前建议先用 peekaboo see --annotate 识别目标。资料未提供收费、价格、平台支持范围与效果保证等信息。