peekaboo 是做什么的?
用于 macOS 屏幕捕获、UI 检查和 GUI 自动化。
二进制文件
- 优先使用
~/bin/peekaboo(如果存在);这是 Peter 的本地发布副本。 - 否则使用
peekaboo。 - 首先检查:
~/bin/peekaboo --version || peekaboo --version。
Mac 应用宿主
- 在实时捕获/自动化之前,请启动
Peekaboo.app;CLI 不会自动启动它。 - 该应用拥有 TCC 授权,并提供
~/Library/Application Support/Peekaboo/bridge.sock。 - 已安装的应用:
open -a Peekaboo。仓库构建:构建Apps/Mac/Peekaboo.xcodeproj中的Peekabooscheme,然后打开生成的Peekaboo.app。 peekaboo daemon start并非应用启动;守护进程具有单独的权限和daemon.sock。- 通过
peekaboo bridge status --verbose --json验证是否选择了hostKind: gui;当需要确定性应用路由时,使用--bridge-socket "$HOME/Library/Application Support/Peekaboo/bridge.sock"。
安全性
- 在捕获/自动化之前检查权限:
peekaboo permissions status --json。 - 截图需要屏幕录制权限;点击/输入/窗口控制需要辅助功能权限。
- 在远程 Mac 上,截图可能因缺少屏幕录制权限而被阻止,但点击/输入仍可通过辅助功能工作;当目标在其他方面可知时,可继续使用点击或 DOM 自动化。
- 优先使用
--json进行机器解析,并在测试本地 TCC 时使用--no-remote。 - 除非用户要求或目标为受控测试,否则请不要点击/输入/进行破坏性自动化。
常用命令
PB="${PEEKABOO_BIN:-$HOME/bin/peekaboo}"
[ -x "$PB" ] || PB="$(command -v peekaboo)"
"$PB" permissions status --json
open -a Peekaboo
"$PB" bridge status --verbose --json
"$PB" list screens --json
"$PB" list apps --json
"$PB" list windows --app Safari --json
"$PB" image --mode screen --screen-index 0 --path /tmp/screen.png --json --no-remote
"$PB" see --app frontmost --path /tmp/frontmost.png --json --annotate
"$PB" tools --json
"$PB" learn
"$PB" click --coords 100,100 --json
"$PB" type "text" --json
工作流程
- 按上述方法解析
PB,并在安装状态重要时确认版本。 - 对于实时 UI 工作,启动
Peekaboo.app;验证 GUI 桥接及其权限。 - 运行
permissions status --json;如果缺少 TCC 授权,报告具体缺少的授权。 - 对于截图,使用
image;包含--path、--json,并且通常仅在故意测试调用方本地 TCC 时使用--no-remote。 - 对于元素定位,运行
see --json --annotate,然后按元素 ID/快照进行点击。 - 对于长时间运行/感知变化的屏幕捕获,使用
capture live;对于视频帧采样,使用capture video。 - 使用
tools --json发现命令/工具,并在完整代理指南有用时使用learn。 - 使用
sips -g pixelWidth -g pixelHeight <path>或查看图像来验证输出文件。
文档:~/Projects/Peekaboo/docs/commands/。