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を含め、通常--no-remoteは意図的に呼び出し元ローカルTCCをテストする場合のみ使用します。 - 要素のターゲティングには
see --json --annotateを実行し、要素IDまたはスナップショットでクリックします。 - 長時間実行/変更検知スクリーンキャプチャには
capture liveを、ビデオフレームサンプリングにはcapture videoを使用します。 - コマンド/ツールの発見には
tools --jsonを、完全なエージェントガイドが必要な場合はlearnを使用します。 - 出力ファイルを
sips -g pixelWidth -g pixelHeight <path>または画像の表示で検証します。
ドキュメント:~/Projects/Peekaboo/docs/commands/。