DCS Copilote

Ton copilote vocal pour DCS World (Windows / Linux) : il te parle comme un équipier dans le cockpit. Tu maintiens un bouton (clavier ou HOTAS), tu poses ta question à voix haute, la réponse s'affiche dans un overlay et est lue au casque. L'appareil piloté est détecté automatiquement via Export.lua.

[bouton PTT] → micro → Whisper (local) → LLM compatible OpenAI (streaming) → overlay + Piper (voix locale)
                                            ↑
                    DCS Export.lua → UDP 127.0.0.1:7779 (appareil, altitude, vitesse)

• Appui : bip, enregistrement. Un nouvel appui coupe la réponse en cours.
• Question vocale = mode vol : 1 à 3 phrases, lues au fur et à mesure qu'elles arrivent.
• Question tapée dans l'overlay = mode sol : réponse détaillée, non lue (sauf speak_typed).
• Contexte conservé sur 6 échanges (« et ensuite ? » fonctionne), remis à zéro au changement d'appareil ou avec ↺.

Version Windows (installeur)

Pas besoin d'installer Python : télécharge l'installeur (DCSCopilote-win-Setup.exe, dans les Releases du dépôt) et lance-le. L'appli s'installe pour ton compte (sans droits administrateur), avec un raccourci sur le bureau et dans le menu Démarrer. Quand une nouvelle version sort, l'appli te propose de l'installer au démarrage : un clic, elle se met à jour et redémarre. Version sans installation : DCSCopilote-win-Portable.zip.

Tes fichiers (config, clés API, journal, historique, manuels indexés, modèles téléchargés) sont rangés dans %LOCALAPPDATA%\DCS-Copilote et survivent aux mises à jour. Les anciennes versions en .zip qui ont déjà leur config.json à côté de l'exe continuent de l'utiliser là. Tu passes d'un ancien .zip à l'installeur ? Au premier lancement, « J'avais déjà DCS Copilote : importer mes réglages » reprend ton ancien config.json (clés, indicatif, bouton PTT…).

Fabrication automatique par GitHub Actions (.github/workflows/windows-exe.yml), avec Velopack :

• publier une version : git tag v1.2.3 && git push origin v1.2.3 → construit (PyInstaller), vérifie (--selftest), empaquette (vpk pack) et publie l'installeur, le .zip portable et les fichiers de mise à jour dans la Release ;
• construction d'essai : onglet Actions → Windows .exe → Run workflow → le tout est téléchargeable dans le résultat (14 jours).

Fabrication à la main sous Windows : pip install -r requirements.txt pyinstaller, python build/make_icon.py, pyinstaller --noconfirm build/dcs-copilote.spec → dist/DCS-Copilote/ ; puis, avec l'outil .NET vpk (dotnet tool install -g vpk) : vpk pack --packId DCSCopilote --packVersion 1.2.3 --packDir dist/DCS-Copilote --mainExe DCS-Copilote.exe.

Tests : python -m pytest tests (logique et interface sans écran, sans micro ni DCS) ; lancés aussi par GitHub Actions à chaque push.

Site de présentation

La page de présentation destinée à GitHub Pages se trouve dans docs/. Elle présente les fonctionnalités, l’installation et les téléchargements. Le workflow .github/workflows/pages.yml la déploie lors des modifications du site sur main, une fois Settings → Pages → Source → GitHub Actions sélectionné dans le dépôt.

Installation

Windows (Python 3.11/3.12) : install.bat, puis run.bat.

Linux :

sudo apt install python3-venv libportaudio2 libxcb-cursor0 espeak-ng
./install.sh && ./run.sh

Interface

Overlay semi-transparent toujours au premier plan (Qt / PySide6) : appareil, réponse affichée au fil de l'eau (mise en forme Markdown), champ de question, pastille d'état (vert prêt · rouge écoute · ambre réflexion). Fais-le glisser par son en-tête ; sa position est mémorisée. Le coin bas-droit le redimensionne (largeur et hauteur de la réponse) ; la taille est mémorisée.

• Micro à droite du champ : maintiens-le pour parler (pratique pour tester sans bouton PTT).
• Répéter (ou « répète », « redis », « quoi ? » à la voix) relit la dernière réponse, sans redemander à l'IA ; Détailler demande la version complète.
• Haut-parleur : lire ou non les réponses aux questions tapées.
• Icône dans la zone de notification (si le bureau en a une) : afficher / masquer l'overlay, réglages, quitter.
• Une seule instance à la fois ; journal dans logs/dcs-copilote.log (bouton « Ouvrir le journal » des réglages).
• Historique : chaque question et sa réponse (appareil, pages du manuel) sont notées dans data/historique/AAAA-MM-JJ.md, à relire après le vol (bouton « Historique des questions » des réglages).

Checklists, alertes, latence

• Checklist : « Lance la procédure de démarrage » ou « checklist décollage » (à la voix ou tapé). Les étapes sont tirées des manuels indexés et annoncées une par une ; appui bref sur le PTT ou « suivant » = étape suivante, « répète », « précédent », « stop ». Boutons équivalents dans l'overlay.
• Alertes vocales (Réglages → Alertes) : train rentré en approche, taux de chute élevé près du sol, train ou volets sortis au-delà de la limite de l'appareil (F/A-18C 250 kt, F-16C 300 kt, P-51D 148 kt…), carburant bas, facteur de charge élevé. Une alerte passe devant la réponse en cours. Il faut le script DCS v2.
• Effet radio (Réglages → Voix) : léger, radio ou fort — bande étroite, saturation, souffle, clic d'ouverture et « kssh » de fin de transmission (une fois par réponse).
• Latence : chaque question laisse une ligne [latence] dans le journal (transcription, 1er mot de l'IA, début de la voix). Pour aller plus vite : « Réponse rapide en vol » (Réglages → IA, limite la réflexion de Gemini 2.5 / GPT-5…) et reconnaissance vocale en ligne (Réglages → Voix : Groq gratuit ~0,3 s, ou OpenAI), avec repli automatique sur Whisper local.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗