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的Peekaboo方案,然後開啟產生的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/。