Que fait peekaboo ?
Utilisé pour la capture d'écran, l'inspection UI et l'automatisation GUI sur macOS.
Binaire
- Préfèrez
~/bin/peekaboolorsqu'il est présent ; c'est la copie locale de la release de Peter. - Sinon, utilisez
peekaboo. - Vérifiez d'abord :
~/bin/peekaboo --version || peekaboo --version.
Hôte d'application Mac
- Lancez
Peekaboo.appavant la capture/l'automatisation en direct ; le CLI ne le lance pas automatiquement. - L'application possède les autorisations TCC et sert
~/Library/Application Support/Peekaboo/bridge.sock. - Application installée :
open -a Peekaboo. Build depuis le dépôt : compilez le schémaPeekaboodeApps/Mac/Peekaboo.xcodeproj, puis ouvrez lePeekaboo.apprésultant. peekaboo daemon startn'est pas un lancement d'application ; le démon a des permissions séparées et son propredaemon.sock.- Vérifiez que
peekaboo bridge status --verbose --jsonrenvoiehostKind: gui; utilisez--bridge-socket "$HOME/Library/Application Support/Peekaboo/bridge.sock"lorsque le routage déterministe de l'application est important.
Sécurité
- Vérifiez les permissions avant capture/automatisation :
peekaboo permissions status --json. - Les captures d'écran nécessitent l'Enregistrement d'écran ; les clics/saisie/contrôle des fenêtres nécessitent l'Accessibilité.
- Sur les Mac distants, la capture d'écran peut être bloquée si l'Enregistrement d'écran est manquant, tandis que les clics/saisie fonctionnent encore via l'Accessibilité ; continuez avec les clics ou l'automatisation DOM lorsque la cible est autrement connaissable.
- Préfèrez
--jsonpour le parsing machine et--no-remotelors des tests TCC locaux. - Ne cliquez/tapez/automatisez pas de manière destructive, sauf si l'utilisateur le demande ou si la cible est un test contrôlé.
Commandes courantes
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
Workflow
- Résolvez
PBcomme ci-dessus et confirmez la version lorsque l'état d'installation est important. - Pour le travail UI en direct, lancez
Peekaboo.app; vérifiez le bridge GUI et ses permissions. - Exécutez
permissions status --json; si TCC manquant, signalez exactement l'autorisation manquante. - Pour les captures d'écran, utilisez
image; incluez--path,--json, et généralement--no-remoteuniquement lorsque vous testez délibérément le TCC de l'appelant. - Pour le ciblage d'éléments, exécutez
see --json --annotate, puis cliquez par identifiant/snapshot d'élément. - Pour la capture d'écran longue durée/sensible aux changements, utilisez
capture live; pour l'échantillonnage vidéo, utilisezcapture video. - Utilisez
tools --jsonpour la découverte de commandes/outils etlearnlorsque le guide complet de l'agent est utile. - Vérifiez les fichiers de sortie avec
sips -g pixelWidth -g pixelHeight <path>ou visualisez l'image.
Documentation : ~/Projects/Peekaboo/docs/commands/.