Resolució de problemes

1El Companion no s'inicia

La causa més habitual és un procés encallat d'una sessió anterior que manté obert el fitxer de la clau d'aparellament. El Companion només admet una instància: si ja n'hi ha una en marxa (fins i tot sense finestra visible), el nou inici es tanca en silenci.

1. Mira primer la safata del sistema. Busca a baix a la dreta de la pantalla, prop del rellotge, una icona verda amb forma de "PC". Si hi és, el Companion SÍ que està en marxa: fes-hi doble clic per recuperar la finestra.
2. Mata qualsevol instància encallada. Premeu Ctrl+Shift+Esc per obrir el Gestor de tasques. A la Detalls pestanya, cerqueu un procés que comenci per WindowsHelperCompanion. Feu clic amb el botó dret a → Finalitza la tasca. Repetiu fins que no hi hagi cap llista.
3. Torna a executar el fitxer .exe. Feu doble clic a la carpeta Baixades. En 2-3 segons apareix la finestra i la icona de la safata es torna verda.
4. Encara res? Comproveu el registre de diagnòstic continuat a %APPDATA%\WindowsHelper\logs\ —el més recent companion-YYYYMMDD.ndjson El fitxer té el registre d'inici (o l'error que n'ha impedit). Obriu el Bloc de notes → Fitxer → Obriu i enganxeu aquest camí per veure'l.

2El codi d'aparellament es rebutja

Els codis de vinculació són vàlids durant 10 minuts a partir del moment en què els mostra el telèfon. Si vau trigar més a escriure o el vostre telèfon ha actualitzat el codi (algunes pantalles giren els codis a cada visita), el codi que veu el vostre ordinador ja no coincideix.

1. Obteniu un codi nou del vostre telèfon. Obre WindowsHelper al teu telèfon → toca Control de PC a la navegació inferior. Apareix un codi nou de 8 caràcters (o es mostra l'existent).
2. Vigileu els caràcters que es confonen més fàcilment. Els codis utilitzen lletres majúscules i dígits, però exclouen I, O, 0, and 1 per disseny. Si heu escrit alguna d'aquestes, heu escrit malament.
3. Escriu el codi a la finestra del Companion en un minut o dos després de veure'l al mòbil.
4. Comprovació d'Internet. Tant el vostre telèfon com el vostre ordinador necessiten una connexió a Internet que funcioni (l'encaixada de mans d'aparellament passa per Firestore). Un WiFi domèstic defectuós pot causar el mateix símptoma: proveu de desactivar i tornar a activar el WiFi en qualsevol dispositiu que sigui més feble.

3Les ordres no s'estan executant al meu PC

Tres causes habituals: el límit de velocitat (10 ordres per minut és el límit als dos extrems), una comprovació de seguretat prèvia al vol que va rebutjar l'ordre abans de l'execució o un desajust de signatura d'una clau d'aparellament obsoleta després d'una nova vinculació del costat del telèfon.

1. Mira la secció "Ordres en directe" a la finestra del Companion: cada ordre rebuda hi queda registrada amb el resultat. Si hi surt "Ha fallat la comprovació prèvia" o "Límit de freqüència assolit", aquest és el motiu. Espera 60 segons perquè s'esborri la finestra de freqüència.
2. Si el company mai no va registrar l'ordre, el telèfon mai el va lliurar. Obriu el visualitzador de registres WindowsHelper Companion (feu clic amb el botó dret a la icona de la safata → Visualitza els registres...) i comproveu si hi ha errors de connexió de Firestore a les entrades més recents.
3. Torna a emparellar. Si la verificació de la signatura rebutja les vostres ordres, les claus del telèfon i de l'ordinador no estan sincronitzades. Feu clic amb el botó dret a la icona de la safata → Gira el codi de vinculació... a l'ordinador i, a continuació, torneu a introduir el codi nou a la pantalla de control de l'ordinador del telèfon.
4. Prova la connexió tocant Prova la connexió a la pantalla PC Control del mòbil. Un ping correcte respon en <500 ms amb la versió del Companion i el temps en marxa. Si falla, el que està trencat és l'enllaç mateix, no la teva ordre.

4El telèfon diu "PC fora de línia"

El Companion es marca com a connectat mentre s'està executant, i el telèfon ho torna a comprovar cada pocs segons mentre la pantalla PC Control està oberta. La causa més habitual d'una etiqueta «fora de línia» és que l'ordinador dormia, que el Companion s'ha tancat o que s'ha caigut la connexió de l'ordinador.

1. Comprova que el Companion està en marxa. Busca la icona verda a la safata del sistema de l'ordinador. Si no hi és, fes doble clic al fitxer .exe de la carpeta Baixades per tornar-lo a iniciar.
2. Desperta l'ordinador. Un ordinador adormit no pot donar senyal de si mateix. Mou el ratolí i deixa la pantalla PC Control oberta uns quants segons: l'etiqueta torna a ser verda tota sola. Si no ho fa, torna a iniciar el Companion: dona senyal en el moment que arrenca.
3. Comprova la connexió de l'ordinador. Obre un navegador a l'ordinador i carrega qualsevol lloc web. Si la pàgina no carrega, vol dir que el Companion no pot arribar a Firestore: arregla la xarxa i tornarà a donar senyal.
4. Torna a obrir la pantalla PC Control. Vés enrere i torna a tocar PC Control per reiniciar la comprovació d'estat. Si l'ordinador realment és en línia, l'etiqueta s'actualitza en pocs segons.

5L'antivirus va posar en quarantena el fitxer .exe

Els .exe .NET autònoms són un fals positiu comú per a l'heurística AV: agrupen tot el temps d'execució .NET + el vostre codi en un sol fitxer, que s'assembla estadísticament als empaquetadors de programari maliciós i als motors que no reconeixen l'editor. La signatura de codi elimina això; hi estem treballant. Mentrestant:

1. Afegiu una exclusió ABANS de tornar a baixar. Obriu la configuració de l'antivirus (Windows Defender: Configuració → Privadesa i seguretat → Windows Seguretat → Protecció contra virus i amenaces → Gestiona la configuració → Afegeix o elimina exclusions). Afegiu una exclusió per a:
   • La carpeta on desareu el fitxer .exe (p. ex. C:\Users\YourName\Downloads), o
   • Qualsevol fitxer que comenci per WindowsHelperCompanion (p. ex. WindowsHelperCompanion-*.exe).
2. Restaurar de la quarantena si ja s'ha eliminat. La majoria de productes AV tenen una vista de quarantena (Defensor: Protecció contra virus i amenaces → Historial de protecció). Cerqueu l'entrada, feu-hi clic i després Permetre o Restaurar.
3. Verifiqueu el SHA-256 de la vostra descàrrega. Si l'heu tornat a baixar, confirmeu que el hash coincideix amb el publicat /companion-version.json:

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

4. Últim recurs: proveu un producte AV diferent temporalment. Alguns AV de negocis ho marquen gairebé tot; l'estàndard d'or Windows Defender és generalment el més precís. Si el vostre AV és l'únic que marca això, és molt probable que sigui un fals positiu.