用途
Peekaboo 是一个完整的 macOS UI 自动化 CLI，用于截取/检查屏幕、定位 UI 元素、驱动输入，以及管理应用、窗口与菜单。各命令共享快照缓存，并支持 --json/-j 以便脚本化。运行 peekaboo 或 peekaboo <cmd> --help 可查看参数；peekaboo --version 打印构建元数据。资料提示：可通过 polter peekaboo 运行以确保使用最新构建。
主要能力
核心命令：bridge 检查 Peekaboo Bridge 主机连通性；capture 实时采集或视频导入加抽帧；clean 清理快照缓存与临时文件；config 初始化/展示/编辑/校验及 providers、models、credentials 配置；image 截取屏幕/窗口/菜单栏区域截图；learn 打印完整智能体指南与工具目录；list 列举应用、窗口、屏幕、菜单栏与权限；permissions 检查屏幕录制/辅助功能状态；run 执行 .peekaboo.json 脚本；sleep 暂停执行；tools 列出可用工具并支持过滤与展示选项。
交互命令：click 按 ID/查询/坐标点击并支持智能等待；drag 跨元素/坐标/Dock 拖放；hotkey 组合键（如 cmd,shift,t）；move 光标定位并可平滑移动；paste 设置剪贴板后粘贴再恢复；press 特殊按键序列并支持重复；scroll 定向滚动（可指定目标并平滑）；swipe 在目标间做手势拖拽；type 输入文本与控制键（支持 --clear 与延迟）。
系统命令：app 启动/退出/重启/隐藏/显示/切换/列举应用；clipboard 读写剪贴板（文本/图片/文件）；dialog 点击/输入/选择文件/关闭/列举系统对话框；dock 启动/右键/隐藏/显示/列举 Dock 项；menu 点击/列举应用菜单及菜单附加项；menubar 列举/点击状态栏项；open 增强型打开并支持指定应用与 JSON 负载；space 列举/切换/移动窗口（Spaces）；visualizer 演示 Peekaboo 视觉反馈动画；window 关闭/最小化/最大化/移动/缩放/聚焦/列举窗口。
视觉命令：see 生成带标注的 UI 地图、快照 ID，并可选分析。
全局运行参数包括 --json/-j、--verbose/-v、--log-level <level>、--no-remote、--bridge-socket <path>。
使用方式
快速上手流程：
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（来自 see 的 ID，默认最新）；元素/坐标用 --on/--id 或 --coords x,y；焦点控制用 --no-auto-focus、--space-switch、--bring-to-current-space、--focus-timeout-seconds、--focus-retry-count。
常见截取参数：输出用 --path、--format png|jpg、--retina；目标用 --mode screen|window|frontmost、--screen-index、--window-title、--window-id；分析用 --analyze "prompt"、--annotate；采集引擎用 --capture-engine auto|classic|cg|modern|sckit。
常见运动/输入参数：时序用 --duration（drag/swipe）、--steps、--delay（type/scroll/press）；拟人化用 --profile human|linear、--wpm（打字）；滚动用 --direction up|down|left|right、--amount <ticks>、--smooth。
示例：先 see 再 click 再 type 是最可靠流程；也可按窗口 ID 定位、截屏并分析、实时采集（运动感知）、管理应用与窗口、操作菜单/菜单栏/Dock、执行鼠标手势与键盘输入。
适用场景与限制
适用于需要以命令行方式自动化 macOS 界面操作、截图分析、窗口与应用管理等场景。使用前需授予屏幕录制与辅助功能权限。建议先用 peekaboo see --annotate 识别目标后再点击。除上述权限要求与材料中提到的命令、参数外，其他功能、收费与平台支持情况暂未提供。