Problemen oplossen

1De Companion start niet

De meest voorkomende oorzaak is een vastgelopen proces uit een vorige sessie dat het koppelsleutelbestand open houdt. De Companion draait maar in één exemplaar — draait er al een (ook zonder zichtbaar venster), dan sluit de nieuwe start stilletjes af.

1. Kijk eerst in het systeemvak. Zoek rechtsonder op je scherm, bij de klok, naar een groen "PC"-vormig pictogram. Staat het er, dan draait de Companion WEL — dubbelklik erop om het venster terug te halen.
2. Dood elke vastgelopen instantie. Druk op Ctrl+Shift+Esc om Taakbeheer te openen. Op de Details tabblad, zoek naar een proces dat begint met WindowsHelperCompanion. Klik met de rechtermuisknop op → Taak beëindigen. Herhaal dit totdat er geen worden vermeld.
3. Voer de .exe opnieuw uit. Dubbelklik vanuit uw map Downloads. Binnen 2-3 seconden verschijnt het venster en wordt het systeemvakpictogram groen.
4. Nog steeds niets? Controleer het rollende diagnostische logboek op %APPDATA%\WindowsHelper\logs\ – de meest recente companion-YYYYMMDD.ndjson bestand heeft het opstartrecord (of de fout die dit verhinderde). Open Kladblok → Bestand → Open en plak dat pad om het te zien.

2Koppelingscode wordt afgewezen

Koppelcodes zijn 10 minuten geldig vanaf het moment dat uw telefoon ze weergeeft. Als het langer duurde om te typen, of als uw telefoon de code heeft vernieuwd (sommige schermen roteren codes bij elk bezoek), komt de code die uw pc ziet niet langer overeen.

1. Ontvang een nieuwe code van uw telefoon. Open WindowsHelper op uw telefoon → tik PC-besturing in de onderste navigatie. Er verschijnt een nieuwe code van 8 tekens (of de bestaande wordt weergegeven).
2. Let op de tekens die het gemakkelijkst te verwarren zijn. Codes gebruiken hoofdletters en cijfers, maar sluiten deze uit I, O, 0, and 1 door ontwerp. Als je een van deze hebt getypt, heb je verkeerd getypt.
3. Typ de code in het Companion-venster binnen een minuut of twee nadat je hem op de telefoon zag.
4. Internetcontrole. Zowel uw telefoon als uw pc hebben een werkende internetverbinding nodig (de koppelingshandshake verloopt via Firestore). Een slecht wifi-netwerk in huis kan hetzelfde symptoom veroorzaken: probeer wifi uit te schakelen en opnieuw in te schakelen op het apparaat dat zwakker is.

3Commando's worden niet uitgevoerd op mijn pc

Drie veelvoorkomende oorzaken: snelheidslimiet (10 commando's per minuut is de limiet aan beide kanten), een veiligheidscontrole vóór de vlucht die het commando weigerde vóór uitvoering, of een handtekening die niet overeenkomt met een verouderde koppelingssleutel na een herkoppeling aan de telefoonzijde.

1. Kijk naar het gedeelte "Live-opdrachten" in het Companion-venster — elke ontvangen opdracht wordt daar met het resultaat gelogd. Staat er "Voorafgaande controle mislukt" of "Snelheidslimiet bereikt", dan is dat je reden. Wacht 60 seconden tot het snelheidsvenster leeg is.
2. Als de begeleider het commando nooit heeft geregistreerd, de telefoon heeft het nooit afgeleverd. Open de logviewer van WindowsHelper Companion (klik met de rechtermuisknop op het systeemvakpictogram → Logboeken bekijken...) en controleer op Firestore-verbindingsfouten in de meest recente vermeldingen.
3. Opnieuw koppelen. Als handtekeningverificatie uw opdrachten afwijst, zijn de telefoon- en pc-toetsen niet gesynchroniseerd. Klik met de rechtermuisknop op het systeemvakpictogram → Koppelingscode draaien... op de pc en voer vervolgens de nieuwe code opnieuw in op het pc-bedieningsscherm van de telefoon.
4. Test de verbinding door in het PC Control-scherm van de telefoon op Verbinding testen te tikken. Een geslaagde ping antwoordt binnen <500 ms met de Companion-versie en de looptijd. Mislukt hij, dan is de verbinding zelf stuk — niet je opdracht.

4Telefoon zegt "PC offline"

De Companion markeert zichzelf als verbonden zolang hij draait, en je telefoon controleert dat elke paar seconden opnieuw zolang het PC Control-scherm open staat. De meest voorkomende oorzaak van een offline-markering is dat de pc sliep, dat de Companion is afgesloten, of dat het internet van de pc wegviel.

1. Controleer of de Companion draait. Zoek het groene pictogram in het systeemvak van je pc. Ontbreekt het, dubbelklik dan op de .exe in je map Downloads om hem opnieuw te starten.
2. Maak de pc wakker. Een slapende pc kan zich niet melden. Beweeg de muis en laat het PC Control-scherm een paar seconden openstaan — de markering wordt vanzelf weer groen. Gebeurt dat niet, start de Companion dan opnieuw: hij meldt zich op het moment dat hij start.
3. Controleer het internet van de pc. Open een browser op de pc en laad een willekeurige website. Laadt de pagina niet, dan bereikt de Companion Firestore niet — repareer het netwerk, dan meldt hij zich weer.
4. Open het PC Control-scherm opnieuw. Ga terug en tik opnieuw op PC Control om de statuscontrole opnieuw te starten. Is de pc echt online, dan wordt de markering binnen een paar seconden bijgewerkt.

5Antivirus heeft het .exe-bestand in quarantaine geplaatst

Op zichzelf staande .NET .exe's zijn een veel voorkomende fout-positief voor AV-heuristieken: ze bundelen de hele .NET-runtime + uw code in één bestand, dat statistisch gezien lijkt op malware-packers en op motoren die de uitgever niet herkennen. Code-ondertekening elimineert dit; wij zijn er mee bezig. In de tussentijd:

1. Voeg een uitsluiting toe VOORDAT u opnieuw downloadt. Open uw antivirusinstellingen (Windows Defender: Instellingen → Privacy en beveiliging → Windows Beveiliging → Virus- en bedreigingsbescherming → Instellingen beheren → Uitsluitingen toevoegen of verwijderen). Voeg een uitsluiting toe voor:
   • De map waarin u het .exe-bestand opslaat (bijv. C:\Users\YourName\Downloads), of
   • Elk bestand dat begint met WindowsHelperCompanion (bijv. WindowsHelperCompanion-*.exe).
2. Herstellen vanuit quarantaine als het al was verwijderd. De meeste AV-producten hebben een quarantaineweergave (Defender: Bescherming tegen virussen en bedreigingen → Beschermingsgeschiedenis). Zoek het item, klik erop en vervolgens Toestaan of Herstellen.
3. Controleer de SHA-256 van uw download. Als u opnieuw hebt gedownload, controleer dan of de hash overeenkomt met de hash die is gepubliceerd /companion-version.json:

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

4. Laatste redmiddel: probeer tijdelijk een ander AV-product. Sommige goedkope AV's markeren bijna alles; de gouden standaard Windows Defender is over het algemeen de meest nauwkeurige. Als uw AV de enige is die dit signaleert, is het zeer waarschijnlijk een vals-positief signaal.