SuperAPI AI 工具集

peekaboo

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

用途:Peekaboo 是运行于 macOS 的完整 UI 自动化 CLI,用于截屏与检查屏幕、定位界面元素、驱动输入,以及管理应用、窗口和菜单,适合脚本化操作与界面测试。

主要能力:核心命令包括 bridge(检查 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,并支持分析。全局运行参数有 --json/-j、--verbose/-v、--log-level、--no-remote、--bridge-socket。

使用方式:先执行 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,以及焦点控制相关参数。截屏参数包括 --path、--format png|jpg、--retina、--mode、--analyze、--annotate、--capture-engine。输入与动作参数包括 --duration、--steps、--delay、--profile human|linear、--wpm,滚动支持 --direction、--amount、--smooth。可运行 peekaboo 或 peekaboo <cmd> --help 查看参数,peekaboo --version 打印构建信息;提示可通过 polter peekaboo 运行以获得最新构建。

适用场景:需要以命令行批量或脚本方式操作 macOS 界面、截屏并分析屏幕内容、按元素或坐标驱动鼠标键盘、管理应用窗口菜单等自动化任务。

限制:需要授予屏幕录制与辅助功能权限;点击前建议先用 peekaboo see --annotate 识别目标。资料未提供收费、价格、平台版本等更多信息。