用途：Peekaboo 是一款 macOS UI 自动化 CLI，用于屏幕捕获与检查、定位 UI 元素、驱动键鼠输入，以及管理应用、窗口和菜单。命令共享快照缓存，并支持 --json/-j 便于脚本化。
主要能力：核心命令包括 bridge（检查 Peekaboo Bridge 主机连接）、capture（实时捕获或视频导入与帧提取）、clean（清理快照缓存与临时文件）、config（初始化/查看/编辑/校验及提供方、模型、凭据）、image（截取屏幕/窗口/菜单栏区域截图）、learn（打印完整 agent 指南与工具目录）、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 或 peekaboo <cmd> --help 查看参数，peekaboo --version 打印构建元数据；提示可通过 polter peekaboo 运行以获取新构建。典型流程：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，以及焦点控制与捕获、运动、打字相关参数。
适用场景：需要在 macOS 上自动化界面操作、截图分析、批量控制应用窗口与菜单、以脚本驱动键鼠流程的场景。
限制：需要屏幕录制与辅助功能权限；建议先用 peekaboo see --annotate 确认目标再点击。其余具体限制暂未提供。