Dépannage

1Le Companion ne démarre pas

La cause la plus fréquente est un processus bloqué d'une session précédente qui garde ouvert le fichier de clé d'appairage. Le Companion ne tourne qu'en une seule instance — si une est déjà lancée (même sans fenêtre visible), le nouveau démarrage se ferme silencieusement.

1. Vérifiez d'abord la zone de notification. Regardez en bas à droite de l'écran, près de l'horloge, une icône verte en forme de "PC". Si elle y est, le Companion FONCTIONNE bien — double-cliquez dessus pour ramener la fenêtre.
2. Tuez toute instance bloquée. Appuyez sur Ctrl+Shift+Esc pour ouvrir le Gestionnaire des tâches. Sur le Détails onglet, recherchez un processus commençant par WindowsHelperCompanion. Cliquez avec le bouton droit sur → Fin de tâche. Répétez jusqu’à ce qu’aucun ne soit répertorié.
3. Exécutez à nouveau le .exe. Double-cliquez sur votre dossier Téléchargements. Dans les 2-3 secondes, la fenêtre apparaît et l'icône de la barre d'état devient verte.
4. Toujours rien ? Consultez le journal de diagnostic continu sur %APPDATA%\WindowsHelper\logs\ - le plus récent companion-YYYYMMDD.ndjson Le fichier contient l'enregistrement de démarrage (ou l'erreur qui l'a empêché). Ouvrez le Bloc-notes → Fichier → Ouvrez et collez ce chemin pour le voir.

2Le code d'appairage est rejeté

Les codes de couplage sont valables 10 minutes à partir du moment où votre téléphone les affiche. Si vous avez mis plus de temps à taper ou si votre téléphone a actualisé le code (certains écrans alternent les codes à chaque visite), le code que votre PC voit ne correspond plus.

1. Obtenez un nouveau code depuis votre téléphone. Ouvrez WindowsHelper sur votre téléphone → appuyez sur Contrôle PC dans la navigation inférieure. Un nouveau code à 8 caractères apparaît (ou celui existant est affiché).
2. Attention aux caractères les plus faciles à confondre. Les codes utilisent des lettres majuscules et des chiffres, mais excluent I, O, 0, and 1 par conception. Si vous avez tapé l’un de ces éléments, vous avez mal tapé.
3. Saisissez le code dans la fenêtre du Companion dans la minute ou les deux minutes qui suivent son affichage sur le téléphone.
4. Vérification Internet. Votre téléphone et votre PC ont besoin d'une connexion Internet fonctionnelle (la négociation de couplage passe par Firestore). Un Wi-Fi domestique défectueux peut provoquer le même symptôme : essayez de désactiver et de réactiver le Wi-Fi sur l'appareil le plus faible.

3Les commandes ne s'exécutent pas sur mon PC

Trois causes courantes : une limite de débit (10 commandes par minute est le plafond aux deux extrémités), un contrôle de sécurité avant le vol qui a refusé la commande avant son exécution, ou une incohérence de signature d'une clé d'appairage obsolète après une réparation côté téléphone.

1. Regardez la section "Commandes en direct" dans la fenêtre du Companion — chaque commande reçue y est consignée avec son résultat. Si vous voyez "Échec de la vérification préalable" ou "Limite de fréquence atteinte", voilà votre raison. Attendez 60 secondes que la fenêtre de fréquence se vide.
2. Si le compagnon n'a jamais enregistré la commande, le téléphone ne l'a jamais livré. Ouvrez la visionneuse de journaux WindowsHelper Companion (cliquez avec le bouton droit sur l'icône de la barre d'état système → Afficher les journaux...) et recherchez les erreurs de connexion Firestore dans les entrées les plus récentes.
3. Appariez à nouveau. Si la vérification de la signature rejette vos commandes, les touches du téléphone et du PC sont désynchronisées. Cliquez avec le bouton droit sur l'icône de la barre d'état → Faites pivoter le code d'association... sur le PC, puis saisissez à nouveau le nouveau code sur l'écran de contrôle du PC du téléphone.
4. Testez la connexion en appuyant sur Tester la connexion dans l'écran PC Control du téléphone. Un ping réussi répond en <500 ms avec la version du Companion et la durée de fonctionnement. Un échec signifie que la liaison elle-même est rompue — pas votre commande.

4Le téléphone indique "PC hors ligne"

Le Companion se signale comme connecté tant qu'il tourne, et votre téléphone le revérifie toutes les quelques secondes tant que l'écran PC Control est ouvert. La cause la plus fréquente d'un badge hors ligne est que le PC dormait, que le Companion a été fermé, ou que la connexion du PC est tombée.

1. Vérifiez que le Companion est en cours d'exécution. Cherchez l'icône verte dans la zone de notification de votre PC. Si elle manque, double-cliquez sur le fichier .exe dans votre dossier Téléchargements pour le relancer.
2. Réveillez le PC. Un PC endormi ne peut pas donner signe de vie. Bougez la souris, puis laissez l'écran PC Control ouvert quelques secondes — le badge repasse au vert tout seul. Sinon, relancez le Companion : il se signale dès l'instant où il démarre.
3. Vérifiez la connexion du PC. Ouvrez un navigateur sur le PC et chargez n'importe quel site. Si la page ne se charge pas, le Companion n'atteint pas Firestore — réparez le réseau, et il se signalera à nouveau.
4. Rouvrez l'écran PC Control. Revenez en arrière, puis touchez à nouveau PC Control pour relancer la vérification de l'état. Si le PC est vraiment en ligne, le badge se met à jour en quelques secondes.

5L'antivirus a mis le .exe en quarantaine

Les .exe .NET autonomes sont un faux positif courant pour les heuristiques audiovisuelles : ils regroupent l'intégralité du runtime .NET + votre code dans un seul fichier, ce qui ressemble statistiquement aux packers de logiciels malveillants destinés aux moteurs qui ne reconnaissent pas l'éditeur. La signature de code élimine cela ; nous y travaillons. En attendant :

1. Ajoutez une exclusion AVANT de retélécharger. Ouvrez vos paramètres antivirus (Windows Defender : Paramètres → Confidentialité et sécurité → Windows Sécurité → Protection contre les virus et les menaces → Gérer les paramètres → Ajouter ou supprimer des exclusions). Ajoutez une exclusion pour :
   • Le dossier dans lequel vous enregistrerez le fichier .exe (par ex. C:\Users\YourName\Downloads), ou
   • Tout fichier commençant par WindowsHelperCompanion (par ex. WindowsHelperCompanion-*.exe).
2. Restaurer depuis la quarantaine s'il a déjà été supprimé. La plupart des produits antivirus disposent d'une vue de quarantaine (Defender : Protection contre les virus et les menaces → Historique de protection). Recherchez l'entrée, cliquez dessus, puis Autoriser ou Restaurer.
3. Vérifiez le SHA-256 de votre téléchargement. Si vous avez retéléchargé, confirmez que le hachage correspond à celui publié sur /companion-version.json:

(Get-FileHash -Algorithm SHA256 (Get-ChildItem ~\Downloads\WindowsHelperCompanion*.exe | Sort-Object LastWriteTime | Select-Object -Last 1)).Hash

4. Dernier recours : essayez temporairement un autre produit audiovisuel. Certains AV bon marché signalent presque tout ; le Windows Defender de référence est généralement le plus précis. Si votre AV est le seul à signaler cela, il s'agit très probablement d'un faux positif.