True-Input Driver
L'orchestrateur vous a dirigé ici. Utilisez ces mécanismes pour exécuter votre plan.
Pilotez un vrai émulateur de terminal en injectant des touches via le chemin d'entrée HID natif de la plateforme. Cela prouve exactement quels octets le terminal émet -- pas d'injection synthétique, pas de distorsion PTY.
Quand l'utiliser
- Prouver qu'un terminal envoie vraiment la séquence attendue (par exemple,
Shift+Entersur Ghostty) - Enregistrer des démos qui reflètent le rendu réel du terminal
- Valider que Droid traite correctement une touche du bout en bout dans un terminal spécifique
Si vous n'avez pas besoin de preuve de terminal réel, utilisez tuistory -- c'est plus rapide et plus déterministe.
Support des plateformes
| Plateforme | Statut | Driver | Documentation |
|---|---|---|---|
| Linux / Wayland | Implémenté | cage + wtype + n'importe quel terminal Wayland |
platforms/linux.md |
| macOS (QEMU) | Implémenté | QEMU monitor sendkey vers une VM macOS |
platforms/macos.md |
| Windows (KVM) | Implémenté | virsh send-key vers une VM KVM/QEMU |
platforms/windows.md |
Lisez le fichier plateforme pour votre OS cible. Chacun contient les prérequis, le motif principal, la référence des commandes, la référence des encodages, l'enregistrement, le dépannage et la récupération -- spécifiques à cette plateforme.
Différences clés par rapport à tuistory
| Aspect | tuistory | true-input |
|---|---|---|
| Source des snapshots | Buffer d'écran virtuel | Journal PTY purgé (Linux) ou capture d'écran (plateformes VM) |
| Mécanisme d'attente | Événementiel (redessins d'écran) | Interrogation du journal (Linux) ou basée sur sleep (VMs) |
| Enregistrement | Doit envelopper le lancement (--record) |
Peut démarrer/arrêter à tout moment |
| Encodage du clavier | Synthétique (contourne le terminal) | Chemin d'encodage du terminal réel |
Impasses connues
- Xvfb + xdotool: contourne entièrement le traitement réel du clavier
- uinput + Xvfb: Xvfb ne consomme pas les périphériques d'entrée du kernel
- SSH pour le test TUI: la couche PTY distord l'encodage d'entrée; utilisez SSH uniquement pour le déploiement
asciinema recbrut: true-input enregistre viawf-recorder(capture d'écran Wayland), pas asciinema. Utiliseztctl --recordoutctl record start/stop. Appelerasciinema recdirectement n'a pas d'accès au compositeur et ne produit rien d'utile.