Interface terminale

AQE peut fonctionner avec une interface terminale quand le crate est compilé avec les features runtime et tui. L’interface est construite avec Ratatui et vise les backtests locaux, les sessions live et la supervision de stratégies longues quand vous voulez plus de structure qu’un flux de logs brut.

Le TUI lit les snapshots runtime depuis la mémoire AQE quand c’est possible. Cela garde l’interface légère : état de stratégie actif, variables, métriques, insights actifs, progression et événements sont rendus depuis le processus en cours plutôt que récupérés depuis AQS Cloud ou les bases live locales. Les bases de résultats persistées restent utilisées pour la revue historique une fois les données sorties de la mémoire moteur.

Activer le TUI

Activez les deux features sur le projet de stratégie :

Cargo.toml

aq-engine = { git = "https://github.com/algoquantstudio/aq-engine", version = "0.1.9", features = ["runtime", "tui"] }

Puis exécutez la stratégie depuis un terminal interactif :

cargo run --features runtime,tui --release

Quand les deux features sont compilées et que stdout/stderr sont attachés à un terminal, AQE démarre automatiquement le TUI pour les backtests et runs live.

Utilisez --no-tui pour garder la sortie console classique :

cargo run --features runtime,tui --release -- --no-tui

Panneaux

L’interface terminale est divisée en panneaux faciles à parcourir :

• Metrics affiche les mêmes champs de résultat backtest qu’AQE imprime dans la console, dont equity finale, rendement, drawdown, ratios, nombres de trades, résumés de durée de détention, timestamps d’exécution, points d’historique, taille du trade log et chemin du résultat si disponible.
• Insights liste les insights actifs et permet d’en sélectionner un pour inspecter l’état, les champs d’ordre, le parent id, les quantités, les prix, les niveaux TP/SL et l’historique d’état.
• Variables affiche les variables de stratégie sous forme de liste imbriquée. Les objets et tableaux peuvent être ouverts pour inspecter l’état structuré sans le réduire à des chaînes plates.
• Watch conserve les chemins de variables sélectionnés depuis Variables pour garder l’état important visible pendant le run.
• Events affiche les logs runtime et événements opérationnels avec préfixe timestamp et niveau.

Les backtests affichent aussi la progression basée sur les steps de marché traités, le total de steps, le timestamp courant et le nombre de flux d’événements enregistrés.

Les runs live incluent l’état de synchronisation AQS, l’état broker, l’état datafeed, l’univers, les logs runtime, les insights actifs et les métriques live. Quand un run live est connecté à AQS Cloud, le TUI montre l’état de synchronisation localement pendant qu’AQS reste la surface desktop la plus riche.

Contrôles

Touche	Action
Tab / Shift+Tab	Déplacer le focus entre les panneaux
m	Focus Metrics
i	Focus Insights
v	Focus Variables
e	Focus Events
Up / Down	Déplacer la sélection ou faire défiler le panneau actif
PageUp / PageDown	Faire défiler Events par page
Home / End	Aller au début ou à la fin de Events
Enter / Right	Ouvrir la variable imbriquée sélectionnée
Backspace / Left	Remonter d’un niveau de variable
w dans Variables	Ajouter ou retirer le chemin de variable sélectionné dans Watch
w, Backspace ou Delete dans Watch	Retirer la watch sélectionnée
q / Esc	Demander l’arrêt ou fermer le TUI quand le run est arrêté

Pour les runs live, q ou Esc demande d’abord l’arrêt de la stratégie afin qu’AQE puisse exécuter le teardown. Quand la stratégie atteint un état terminal, appuyez de nouveau sur q pour fermer le TUI. Cela évite que l’interface disparaisse alors que le processus live continue de tourner.

Pour les backtests terminés, AQE garde le TUI ouvert afin que vous puissiez revoir les métriques finales, logs, insights et le chemin du résultat sauvegardé avant de sortir.

Notes de performance

Le TUI est volontairement une vue runtime locale :

• les snapshots sont mis à jour depuis l’état de stratégie AQE derrière un lock ;
• les rafraîchissements de rendu sont throttled ;
• le stockage d’événements est borné, avec le nombre d’événements dropped exposé dans Events ;
• il ne nécessite pas de connexion AQS Cloud ;
• il évite d’interroger les bases live locales pour les données encore disponibles en mémoire processus.

Si vous exécutez une stratégie dans un process manager non interactif, un job CI ou un service wrapper, passez --no-tui et gardez les logs console structurés.