用途：Peekaboo 是 macOS 上的完整 UI 自动化 CLI，用于捕获与检查屏幕、定位 UI 元素、驱动输入，并管理应用、窗口与菜单。
主要能力：核心命令包括 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、--focus-timeout-seconds 等焦点控制。捕获参数包括 --path、--format png|jpg、--retina、--mode screen|window|frontmost、--analyze、--annotate、--capture-engine。全局运行标志有 --json/-j、--verbose/-v、--log-level、--no-remote、--bridge-socket。
适用场景：需要脚本化操作 macOS 界面、截图分析、批量点击输入、窗口与菜单管理的自动化流程。
限制：需要屏幕录制与辅助功能权限；建议先用 see --annotate 识别目标再点击；资料未提供价格、平台版本要求等更多信息。