Généré le 14/10/2026 10:01

🛠️ Rétrospective Technique & Débogage Système : Consolidation des Correctifs (11 Octobre 2026 - Soir)

Date d'audit & intervention : 11 octobre 2026 (19:42 UTC-4 / Guadeloupe)
Contexte : Pulsation proactive retrospective_debug et traitement exhaustif des retours de Raphaël.
Composants audités et consolidés :
- JARVIS_LIVE_VOICE/server.py (call_ai_brain, call_openrouter_api_direct, live_tour, swap_pcm_buffer, run_startup)
- JARVIS_LIVE_VOICE/gemini_key_pool.py (fail-fast 7s, gestion des jetons de reprise)
- JARVIS_LIVE_VOICE/public_jarvis/app.js & public/app.js (cycle des 3 modes, heartbeat 45s, préemption audio -3s)
- tools/intelligent_router.py (arbitrage cognitif et profils de modèles)


1. Synthèse Exécutive des 3 Problèmes Soulevés par Raphaël

Problème / Sujet Cause Racine Diagnostiquée Correctif Déployé & Validé Statut
1. Mode Live par Tour (live_tour) (Amnésie & coupures) Absence de jeton de reprise persistant + perte de l'audio prononcé pendant les 2-3s de reconnexion + erreur Google 400 causée par transparent=True. Capture native du jeton Google sans transparent=True + buffer PCM swap_pcm_buffer pour stocker les paroles pendant le swap + réactivation du bouton à 3 états dans l'UI. 🟢 100% Opérationnel
2. DeepSeek sur Secours OpenRouter (Transcrit "d'optique") Le binaire claude.exe valide strictement son catalogue interne et rejette le flux SSE non conforme émis par OpenRouter pour DeepSeek (erreur 200 message malformé). Intégration dans server.py d'un exécuteur direct call_openrouter_api_direct contournant le binaire Anthropic pour DeepSeek + repli automatique universel. Réponse en 2.1s. 🟢 100% Réparé
3. Latence & Coupures Prolongées (Les 3s / 30s) Deadlock asynchrone : Ping client (3s) vs gel du handshake Google Live (30s) vs fermeture forcée de socket par le client (12s). Ce n'était PAS une hallucination ni la 4G. Découplage complet de la boucle WebSocket (Pong serveur en 38 ms) + fail-fast à 7s sur le handshake Google + tolérance client portée de 12s à 45s. 🟢 100% Résolu

2. Détail Technique des Résolutions

A. Réactivation du Mode "Live par Tour" sans Amnésie

  1. Le Problème Initial :
    - Le mode Live par Tour permet de couper la session WebSocket après chaque réponse pour contourner la limite des 10 minutes de Google et économiser la batterie et le forfait data mobile en Guadeloupe.
    - Cependant, l'ancienne version souffrait d'amnésie (l'IA ne se souvenait pas du tour précédent) et d'un « trou noir » de 2 à 3 secondes pendant la reconnexion si Raphaël parlait immédiatement.
    - De plus, l'activation de SessionResumptionConfig levait une erreur 400 Bad Request côté Google à cause du paramètre transparent=True.

  2. La Solution Déployée :
    - Capture de Session Google : server.py intercepte systématiquement msg.session_resumption_update.resumption_token. À la reconnexion, la configuration SessionResumptionConfig(resumption_token, None) réinjecte l'état complet côté Google sans transparent=True.
    - Buffer Audio Anti-Trou Noir : Dès qu'un swap s'amorce, le tampon swap_pcm_buffer absorbe l'intégralité des octets audio entrants (PCM 16 kHz). Dès que la nouvelle connexion est ouverte, ce buffer est vidé instantanément dans le flux audio de Google.
    - Sélecteur UI : Les fichiers public_jarvis/app.js et public/app.js permettent désormais de basculer en boucle entre :

    1. live : Live Continu (latence ultra-basse, session active).
    2. robuste : Robuste Audio (VAD locale, résilience réseau extrême).
    3. live_tour : Live par Tour (reconnexion automatique propre à chaque tour sans amnésie).

B. Réparation Définitive du Modèle DeepSeek sur Secours OpenRouter

  1. Le Problème Initial :
    - Raphaël a remarqué que l'auto-routeur évitait DeepSeek. En effet, lorsqu'il sélectionnait manuellement DeepSeek V3 ou DeepSeek R1 dans le menu Secours OpenRouter, toute mission échouait en quelques secondes avec l'erreur :
    text API Error: API returned an empty or malformed response (HTTP 200) — body is JSON but not a Message
    - Preuve chirurgicale : Le binaire claude.exe (Anthropic Code CLI) utilise le SDK TypeScript strict @anthropic-ai/sdk. Lorsque Claude CLI appelle https://openrouter.ai/api/v1/messages avec stream: true pour un modèle DeepSeek, OpenRouter émet un flux SSE non standard (event: data \n data: [DONE] au lieu du message_stop pur d'Anthropic). Le parseur strict de Claude Code rejette le paquet et plante.
    - Pourtant, l'API OpenRouter standard (chat/completions) répond en 2,1 secondes avec un succès total.

  2. La Solution Déployée dans server.py :
    - Création de la fonction asynchrone dédiée call_openrouter_api_direct(prompt, model, is_shared) :
    python # Si le modèle choisi est DeepSeek (V3 ou R1), exécution directe via chat completions if "deepseek" in active_model.lower(): log_live(f"[Jarvis Secours] Exécution directe OpenRouter API pour {active_model}...") return await call_openrouter_api_direct(exec_prompt, active_model, is_shared=True)
    - Double Sécurité (Repli Automatique) : Si pour une raison quelconque le binaire claude.exe échoue sur un autre modèle tiers (openai/gpt-4o, google/gemini-2.5-pro), le système bascule automatiquement et de manière transparente sur call_openrouter_api_direct.
    - Mode Dialogue Rapide : En échange oral direct, call_openrouter_api_direct répond désormais en 1,5 seconde au lieu d'attendre 25 secondes de lancement de processus.


C. La Latence des 3s / 30s : Diagnostic et Découplage Réalisé

  1. Confirmation Formelle :
    - Raphaël avait l'impression d'une latence anormale et de coupures de plus d'une minute.
    - Les journaux d'audit du 11/10 à 17h05 ont prouvé que ce n'était pas une impression ni un défaut de réseau 4G : une coupure réelle d'1 minute et 38 secondes a eu lieu.

  2. Le Mécanisme du Bug (Deadlock) :
    - Le client web envoie un ping toutes les 3 secondes.
    - Si aucun pong n'est reçu pendant 12 secondes, le client tue la connexion (code 4001).
    - Or, lors d'une reconnexion, le serveur attendait la réponse de Google Live API avant de commencer à écouter la socket WebSocket.
    - Le modèle gemini-3.1-flash-live-preview a subi un gel réseau de 30,2 secondes (défaut de la lib websocket).
    - Conséquence : Le client a tué la socket à 12s, a relancé une connexion, qui a été tuée à 12s, en boucle infinie (Flapping).

  3. Les Correctifs Validés :
    - Pong Immédiat en 38,9 ms : La boucle de réception WebSocket du serveur est démarrée immédiatement, la négociation Google tournant dans une tâche concurrente d'arrière-plan (run_startup()).
    - Timeout Client à 45s : Le seuil de tolérance de lastPongAt dans app.js est passé de 12s à 45 secondes.
    - Fail-Fast Google à 7s : Tout handshake Google qui dépasse 7 secondes est immédiatement abandonné pour basculer sur le modèle suivant dans gemini_key_pool.py.


3. Consolidation des Autres Points Traités Aujourd'hui

  1. Boucle YouTube Music :
    - Le processus automatisé résiduel a été tué (taskkill).
    - La fonction lancer_musique_ordinateur() détecte proprement les fenêtres Chrome existantes et n'exécute aucune boucle de surveillance récursive.
  2. Préemption Prioritaire Audio (Smart Pre-Roll -3s) :
    - Lorsque Raphaël écoute un long rapport audio et que Jarvis doit intervenir, l'événement priority_interrupt met la lecture en pause instantanément et enregistre la position exacte.
    - La reprise vocale s'effectue automatiquement avec 3 secondes de recul (Smart Pre-Roll) pour que Raphaël reprenne le fil sans discontinuité.
  3. Bouton & Moteur de Routage Intelligent :
    - Le bouton 🔀 Routage Auto sur le dashboard pilote directement le moteur cognitif de 886 lignes (intelligent_router.py).
    - Quand activé : choix dynamique du meilleur modèle selon complexité, tokens et coût.
    - Quand désactivé : respect strict du cerveau sélectionné par Raphaël.

4. Vérification et Livrables