Was macht peekaboo?
Verwendung für macOS-Bildschirmaufnahmen, UI-Inspektion und GUI-Automatisierung.
Binärdatei
- Bevorzugt
~/bin/peekaboowenn vorhanden; dies ist Peters lokale Release-Kopie. - Andernfalls
peekabooverwenden. - Zuerst prüfen:
~/bin/peekaboo --version || peekaboo --version.
Mac-App-Host
Peekaboo.appvor der Live-Aufnahme/-Automatisierung starten; die CLI startet sie nicht automatisch.- Die App besitzt TCC-Berechtigungen und bedient
~/Library/Application Support/Peekaboo/bridge.sock. - Installierte App:
open -a Peekaboo. Repository-Build: Das SchemaPeekabooinApps/Mac/Peekaboo.xcodeprojbauen, dann die resultierendePeekaboo.appöffnen. peekaboo daemon startist kein App-Start; der Daemon hat separate Berechtigungen unddaemon.sock.- Überprüfen mit
peekaboo bridge status --verbose --json, obhostKind: guiausgewählt ist;--bridge-socket "$HOME/Library/Application Support/Peekaboo/bridge.sock"verwenden, wenn deterministisches App-Routing erforderlich ist.
Sicherheit
- Berechtigungen vor der Aufnahme/Automatisierung prüfen:
peekaboo permissions status --json. - Für Screenshots wird Bildschirmaufnahme benötigt; Klicks/Texteingabe/Fenstersteuerung benötigen Bedienungshilfen.
- Auf entfernten Macs kann der Screenshot durch fehlende Bildschirmaufnahme blockiert sein, während Klicks/Texteingabe über Bedienungshilfen weiterhin funktionieren; mit Klicks oder DOM-Automatisierung fortfahren, wenn das Ziel anderweitig bekannt ist.
--jsonfür maschinelle Verarbeitung und--no-remotebeim Testen lokaler TCC bevorzugen.- Nicht klicken/tippen/destruktiv automatisieren, es sei denn, der Benutzer hat es verlangt oder das Ziel ist ein kontrollierter Test.
Häufige Befehle
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
Arbeitsablauf
PBwie oben ermitteln und Version bestätigen, wenn der Installationsstatus relevant ist.- Für Live-UI-Arbeit
Peekaboo.appstarten; die GUI-Bridge und ihre Berechtigungen überprüfen. permissions status --jsonausführen; falls TCC fehlt, die genaue fehlende Berechtigung melden.- Für Screenshots
imageverwenden;--path,--jsonund normalerweise--no-remotenur einschließen, wenn absichtlich die aufruferlokale TCC getestet wird. - Für Elementziele
see --json --annotateausführen, dann per Element-ID/Schnappschuss klicken. - Für langlebige/änderungsbewusste Bildschirmaufnahme
capture liveverwenden; für Video-Frame-Samplingcapture videoverwenden. tools --jsonzur Befehls-/Werkzeugsuche undlearnverwenden, wenn die vollständige Agentenanleitung nützlich ist.- Ausgabedateien mit
sips -g pixelWidth -g pixelHeight <path>überprüfen oder das Bild anzeigen.
Dokumentation: ~/Projects/Peekaboo/docs/commands/.