VM-Labor
Verwenden Sie dies, wenn eine saubere macOS-VM benötigt wird, um GUI-Automatisierung, TCC-Aufforderungen, Screenshot-Erfassung, Klicken, Tippen, Leistung oder „Zwei-Wege-Validierung“ von Peekaboo-ähnlichen Werkzeugen zu testen.
Kernidee: Führen Sie das zu testende Werkzeug innerhalb des Gasts aus, aber verifizieren Sie es von außerhalb des Gasts mit Parallels-Screenshots und hostseitigen Beobachtungen. Schließen Sie keine Apps, die Ihnen nicht gehören.
Sicherheitsregeln
- Behandeln Sie den VM-Snapshot als wegwerfbar, nicht den Host.
- Geben Sie niemals Geheimnisse aus. Wenn
opbenötigt wird, folgen Sie dem 1Password-Skill und führen Sie es nur innerhalb vontmuxaus. - Bevorzugen Sie frische App-Fenster, die Sie selbst erstellen: TextEdit, eine lokale HTML-Testseite oder eine kleine Test-App.
- Vermeiden Sie es, den Host-Status zu ändern, außer bei temporären Screenshots unter
/tmp. - Verwenden Sie für Git-Repos innerhalb der VM HTTPS-Remotes und normale Branch-Disziplin.
VM-Erkennung
VMs auflisten:
prlctl list --all
VM-Status/IP abrufen:
prlctl list --info "macOS Tahoe"
Gast-Befehle als Peter ausführen:
prlctl exec "macOS Tahoe" \
'sudo -u steipete -H /bin/zsh -lc '\''source ~/.zprofile 2>/dev/null || true; uname -a'\'''
Unabhängigen hostseitigen Screenshot erstellen:
prlctl capture "macOS Tahoe" --file /tmp/vm-reference.png
sips -g pixelWidth -g pixelHeight /tmp/vm-reference.png
TCC-/GUI-Zuordnung
Für macOS-Bildschirmaufnahme und Bedienungshilfen ist der verantwortliche Prozess entscheidend.
prlctl execist kopflos und kann fehlschlagen, eine nützliche Bildschirmaufnahme-Zuordnung zu liefern.- Starten Sie den Testbefehl aus einer sichtbaren Terminal-App im Gast, wenn die Bildschirmaufnahme betroffen ist.
- Ghostty funktioniert als GUI-Terminal, falls installiert.
- Nach einem ersten fehlgeschlagenen Erfassungsversuch überprüfen Sie
Systemeinstellungen > Datenschutz & Sicherheit > Bildschirm- & Systemaudioaufnahme. permissions status, ausgeführt überprlctl exec, kann nach dem Erlauben von Ghostty immer noch „false“ für die Bildschirmaufnahme melden; validieren Sie die Bildschirmaufnahme, indem Sie die Erfassung über Ghostty wiederholen.
Den Bereich „Bildschirmaufnahme“ öffnen:
prlctl exec "macOS Tahoe" \
'sudo -u steipete -H open "x-apple.systempreferences:com.apple.preference.security?Privacy_ScreenCapture"'
Ghostty öffnen:
prlctl exec "macOS Tahoe" 'sudo -u steipete -H open -a Ghostty'
Befehle über Ghostty ausführen
Bester Weg: Erstellen Sie ein Gast-Skript mit prlctl exec, öffnen/fokussieren Sie Ghostty, und tippen Sie dann nur einen kurzen Launcher-Pfad in das sichtbare Terminal.
Gast-Skript-Muster:
prlctl exec "macOS Tahoe" 'sudo -u steipete -H /bin/zsh -lc '\''cat > /tmp/run-vm-lab.zsh <<EOF
#!/bin/zsh
source ~/.zprofile 2>/dev/null || true
cd ~/Projects/Peekaboo || exit 1
Apps/CLI/.build/debug/peekaboo image --path /tmp/peekaboo-vm.png --json
rc=$?
echo "EXIT:$rc"
[ -f /tmp/peekaboo-vm.png ] && sips -g pixelWidth -g pixelHeight /tmp/peekaboo-vm.png
echo "Drücken Sie die Eingabetaste zum Schließen..."
read _
exit $rc
EOF
chmod +x /tmp/run-vm-lab.zsh
ln -sf /tmp/run-vm-lab.zsh /tmp/r
open -a Ghostty'\'''
Verknüpfen Sie dann den Launcher mit Ghosttys Home-Verzeichnis und tippen Sie ./r mit scripts/parallels_type.py. Dies vermeidet unzuverlässige Pfadzeichen in der Parallels-Tasteneingabe.
prlctl exec "macOS Tahoe" \
"sudo -u steipete -H /bin/zsh -lc 'ln -sf /tmp/run-vm-lab.zsh ~/r'"
python3 skills/vm-lab/scripts/parallels_type.py "macOS Tahoe" $'./r\n'
Vermeiden Sie langes Befehlsgetippe. Die Parallels-Tasteneingabe verwendet eine eigene Tastencodetabelle und kann layoutempfindlich sein.
Bekannte Fallstricke
- macOS-Zwischenablage-APIs können bei
prlctl execfehlschlagen;pbcopy, AppleScript-Zwischenablage und Peekaboo-Einfügen können alle im kopflosen Gast-Kontext fehlschlagen. open -na Ghostty.app --args -e ...kann nur ein vorhandenes Ghostty-Fenster auf macOS fokussieren; gehen Sie nicht davon aus, dass es den Befehl ausführt.prlctl execkann argv über eine Gast-Shell wieder zusammenführen; übergeben Sie für komplexe Payloads einen vollständig shell-zitierten Befehlstring oder erstellen Sie die Datei mit einem kleinen Python-Schreiber.- Parallels
send-key-event --keyverwendet Parallels-Tastenwerte, nicht macOS-virtuelle Tastencodes. - Für normales Tippen senden Sie
prlctl send-key-event <vm> --key <key>ohne--event; explizitespress/releasekann wiederholen oder hängen bleiben. Die Eingabetaste ist eine Ausnahme: Drücken Sie zuerstpress, dannrelease. - Bevorzugen Sie einen
prlctl send-key-event --json-Batch gegenüber vielen separatensend-key-event-Prozessen; separate Aufrufe können bei Fokus/Latenz abdriften. - Verwenden Sie
PRL_KEY_ENTER = 36,PRL_KEY_SLASH = 61,PRL_KEY_R = 27,PRL_KEY_T = 28,PRL_KEY_M = 58,PRL_KEY_P = 33. - Wenn Tastatureingaben Müll erzeugen, senden Sie die Eingabetaste, um die Zeile zu löschen, erstellen Sie einen kürzeren Launcher und versuchen Sie es erneut.
- Wenn Peekaboo-Berechtigungssonden bei fehlender Bildschirmaufnahme hängen bleiben und
SWIFT TASK CONTINUATION MISUSEausgeben, erfassen Sie dies als Produktfehler; verwechseln Sie es nicht mit der VM-Testumgebung.
Zwei-Wege-Validierung
Überprüfen Sie für jede GUI-Aktion über zwei unabhängige Signale:
- Ausgabe des zu testenden Werkzeugs: JSON, Screenshot-Datei, AX-Ergebnis oder App-Status.
- Externer Verifizierer:
prlctl capture, hostseitige Bildinspektion, Dateiinhalt im Gast oder Prozess-/Fensterstatus.
Beispiele:
- Screenshot: Vergleichen Sie Peekaboo-Bildabmessungen/-inhalt mit
prlctl capture. - Klicken: Verwenden Sie Peekaboo, um eine Testschaltfläche zu klicken, und überprüfen Sie dann sowohl den Gast-App-Status als auch den Host-Screenshot.
- Tippen: Verwenden Sie Peekaboo, um in ein kontrolliertes Textfeld zu tippen, und überprüfen Sie dann den AX-Wert und den Host-Screenshot.
- Leistung: Wickeln Sie Befehle mit
/usr/bin/time -pein; wiederholen Sie kalte/warme Läufe; behalten Sie Ausgaben in/tmp.
Peekaboo-VM-Baseline
Innerhalb des Gasts:
cd ~/Projects/Peekaboo
git pull --recurse-submodules
swift build --package-path Apps/CLI
Apps/CLI/.build/debug/peekaboo --version
Apps/CLI/.build/debug/peekaboo permissions status --json
Hostseitige Referenzerfassung:
prlctl capture "macOS Tahoe" --file /tmp/vm-prlctl-reference.png
Gastseitige Peekaboo-Erfassung über Ghostty:
/tmp/r
Vergleichen:
prlctl exec "macOS Tahoe" \
'sudo -u steipete -H /bin/zsh -lc '\''sips -g pixelWidth -g pixelHeight /tmp/peekaboo-vm.png'\'''
sips -g pixelWidth -g pixelHeight /tmp/vm-prlctl-reference.png
Berichterstattung
Fügen Sie bei der Übergabe nur Folgendes ein:
- VM-Name und OS-Build.
- Getesteter Repo-Commit.
- Berechtigungsstatus.
- Befehle, die bestanden/nicht bestanden haben.
- Ergebnis des unabhängigen Verifizierers.
- Entdeckte Produktfehler.