Resolución de problemas

1O Companion non se inicia

A causa máis habitual é un proceso atascado dunha sesión anterior que mantén aberto o ficheiro da chave de emparellamento. O Companion só admite unha instancia: se xa hai unha en marcha (mesmo sen xanela visible), o novo inicio péchase en silencio.

1. Mira primeiro a bandexa do sistema. Busca abaixo á dereita da pantalla, preto do reloxo, unha icona verde con forma de "PC". Se está aí, o Companion SI está en marcha: fai dobre clic para recuperar a xanela.
2. Mata calquera instancia atascada. Preme Ctrl+Shift+Esc para abrir o Xestor de tarefas. Sobre o Detalles ficha, busque un proceso que comece por WindowsHelperCompanion. Fai clic co botón dereito do rato en → Finalizar tarefa. Repita ata que non apareza ningunha.
3. Executa o .exe de novo. Fai dobre clic no cartafol Descargas. Dentro de 2-3 segundos aparece a xanela e a icona da bandexa vólvese verde.
4. Aínda nada? Comprobe o rexistro de diagnóstico continuo en %APPDATA%\WindowsHelper\logs\ - o máis recente companion-YYYYMMDD.ndjson o ficheiro ten o rexistro de inicio (ou o erro que o impediu). Abre o Bloc de notas → Ficheiro → Abre e pega ese camiño para velo.

2Rexeitouse o código de sincronización

Os códigos de sincronización son válidos durante 10 minutos desde que os mostra o teu teléfono. Se tardaches máis en escribir ou o teu teléfono actualizou o código (algunhas pantallas rotan os códigos en cada visita), o código que ve o teu PC xa non coincide.

1. Obtén un código novo do teu teléfono. Abre WindowsHelper no teu teléfono → toca Control de PC na navegación inferior. Aparece un novo código de 8 caracteres (ou móstrase o existente).
2. Fíxate nos caracteres que se confunden máis facilmente. Os códigos usan letras maiúsculas e díxitos, pero exclúense I, O, 0, and 1 por deseño. Se escribiu algún destes, escribiu mal.
3. Escribe o código na xanela do Companion nun ou dous minutos desde que o vexas no móbil.
4. Comprobación de Internet. Tanto o teu teléfono como o teu PC necesitan unha conexión a Internet que funcione (o apretón de mans de vinculación pasa por Firestore). Unha conexión wifi na casa defectuosa pode causar o mesmo síntoma: proba a desactivar e volver habilitar a wifi no dispositivo que sexa máis débil.

3Os comandos non se executan no meu PC

Tres causas comúns: límite de velocidade (10 comandos por minuto é o límite nos dous extremos), unha comprobación de seguridade previa ao voo que rexeitou o comando antes da execución ou unha falta de coincidencia de sinatura dunha clave de emparejamento obsoleta despois dun emparejamento no teléfono.

1. Mira a sección "Ordes en directo" na xanela do Companion: cada orde recibida rexístrase alí co seu resultado. Se aparece "Fallou a comprobación previa" ou "Límite de frecuencia acadado", ese é o motivo. Agarda 60 segundos a que se baleire a xanela de frecuencia.
2. Se o compañeiro nunca rexistrou o comando, o teléfono nunca o entregou. Abre o visor de rexistro de WindowsHelper Companion (faga clic co botón dereito na icona da bandexa → Ver rexistros...) e comprobe se hai erros de conexión de Firestore nas entradas máis recentes.
3. Volve emparellar. Se a verificación da sinatura está a rexeitar os teus comandos, as teclas do teléfono e do PC non están sincronizadas. Fai clic co botón dereito na icona da bandexa → Xira o código de sincronización... no PC e, a continuación, introduza de novo o novo código na pantalla de control do PC do teléfono.
4. Proba a conexión tocando Probar conexión na pantalla PC Control do móbil. Un ping correcto responde en <500 ms coa versión do Companion e o tempo en marcha. Se falla, o roto é a propia ligazón, non a túa orde.

4O teléfono di "PC fóra de liña"

O Companion márcase como conectado mentres está en marcha, e o teu teléfono compróbao de novo cada poucos segundos mentres a pantalla PC Control está aberta. A causa máis habitual dunha etiqueta «fóra de liña» é que o PC estaba a durmir, que o Companion se pechou ou que caeu a conexión do PC.

1. Comproba que o Companion está en marcha. Busca a icona verde na bandexa do sistema do PC. Se non está, fai dobre clic no .exe do cartafol Descargas para inicialo de novo.
2. Esperta o PC. Un PC durmido non pode dar sinal de si mesmo. Move o rato e deixa a pantalla PC Control aberta uns segundos: a etiqueta volve poñerse verde soa. Se non o fai, inicia de novo o Companion: dá sinal no momento en que arrinca.
3. Comproba a conexión do PC. Abre un navegador no PC e carga calquera sitio web. Se a páxina non carga, o Companion non pode chegar a Firestore: arranxa a rede e volverá dar sinal.
4. Volve abrir a pantalla PC Control. Vai atrás e toca PC Control outra vez para reiniciar a comprobación de estado. Se o PC está realmente en liña, a etiqueta actualízase en poucos segundos.

5O antivirus puxo en corentena o .exe

Os .exe .NET autónomos son un falso positivo común para a heurística AV: agrupan todo o tempo de execución de .NET e o teu código nun só ficheiro, que estatisticamente semella aos empaquetadores de malware aos motores que non recoñecen ao editor. A sinatura de código elimina isto; estamos traballando niso. Mentres tanto:

1. Engade unha exclusión ANTES de volver descargar. Abra a súa configuración antivirus (Windows Defender: Configuración → Privacidade e seguranza → Windows Seguridade → Protección contra virus e ameazas → Xestionar a configuración → Engadir ou eliminar exclusións). Engade unha exclusión para:
   • O cartafol no que vai gardar o .exe (p. ex. C:\Users\YourName\Downloads), ou
   • Calquera ficheiro que comece por WindowsHelperCompanion (p. ex. WindowsHelperCompanion-*.exe).
2. Restaurar da corentena se xa foi eliminado. A maioría dos produtos AV teñen unha vista de corentena (Defender: protección contra virus e ameazas → Historial de protección). Busca a entrada, fai clic nela e despois Permitir ou Restaurar.
3. Verifique o SHA-256 da súa descarga. Se volveches a descargar, confirma que o hash coincide co publicado /companion-version.json:

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

4. Último recurso: proba un produto AV diferente temporalmente. Algúns AVs de ganga marcan case todo; o estándar Windows Defender é xeralmente o máis preciso. Se o teu AV é o único que sinala isto, é moi probable que sexa un falso positivo.