peekaboo

Peekaboo 是一款专为进阶 UI 自动化与桌面环境管理而设计的 macOS CLI 工具。对于需要以程序方式与图形用户界面互动、自动化重复性手动任务或从系统截取视觉资料的开发者与进阶使用者而言，这是不可或缺的工具组。通过连接 CLI 指令与 macOS Accessibility API，Peekaboo 实现了对应用程序、窗口、菜单及系统对话框的无缝控制，无需手动介入。

• 完整的 UI 生命周期管理，包含应用程序启动、聚焦、调整大小、移动及应用程序状态控制。

• 进阶截取功能，支援屏幕、窗口与菜单栏区域，包含即时视频截取与帧截取。

• 强大的互动套件，提供精确的鼠标移动、拖放操作、手势及可自定义延迟与配置的智慧键盘输入。

• 直接整合 macOS 无障碍服务与系统菜单，包含 Dock 项目、菜单栏工具与全局快捷键。

• 支援使用 .peekaboo.json 文件的 JSON 原生脚本，允许定义复杂工作流程，并透过 --json 输出以进行管道传输。

• 基于快照的目标系统，使用识别码来追踪 UI 元素，并结合智慧等待逻辑，提升在不稳定 UI 环境下的执行可靠性。

• 使用者必须在系统设置中授予「屏幕录制」与「辅助使用」权限，工具才能正常运作。

• 强烈建议在构建自动化脚本前，使用 see --annotate 指令来检查识别码并映射目标 UI 元素。

• 此工具设计为可作为独立 CLI 或整合至代理工作流程中，例如 OpenClaw 助理生态系统。

• 支援多种截取引擎，如 classic、cg、modern 与 ScreenCaptureKit，适用于不同 macOS 版本与安全性环境。

• 透过快照缓存优化效能与可靠性，并可使用 clean 指令清除暂存文件。