Solución de problemas

1El Companion no se inicia

La causa más habitual es un proceso atascado de una sesión anterior que mantiene abierto el archivo de la clave de emparejamiento. El Companion solo admite una instancia: si ya hay una en marcha (incluso sin ventana visible), el nuevo arranque se cierra en silencio.

1. Mira primero la bandeja del sistema. Busca abajo a la derecha de la pantalla, junto al reloj, un icono verde con forma de "PC". Si está ahí, el Companion SÍ está en marcha: haz doble clic para recuperar la ventana.
2. Mata cualquier instancia atascada. Pulsa Ctrl+Shift+Esc para abrir el Administrador de tareas. en el Detalles pestaña, busque un proceso que comience con WindowsHelperCompanion. Haga clic derecho en → Finalizar tarea. Repita hasta que no aparezca ninguno en la lista.
3. Ejecute el .exe nuevamente. Haga doble clic en su carpeta de Descargas. Al cabo de 2 o 3 segundos aparece la ventana y el icono de la bandeja se vuelve verde.
4. ¿Aún nada? Consulte el registro de diagnóstico continuo en %APPDATA%\WindowsHelper\logs\ — el más reciente companion-YYYYMMDD.ndjson El archivo tiene el registro de inicio (o el error que lo impidió). Abra el Bloc de notas → Archivo → Abra y pegue esa ruta para verla.

2El código de emparejamiento es rechazado.

Los códigos de emparejamiento son válidos durante 10 minutos desde que su teléfono los muestra. Si tardó más en escribir o su teléfono actualizó el código (algunas pantallas rotan los códigos en cada visita), el código que ve su PC ya no coincide.

1. Obtenga un código nuevo desde su teléfono. Abre WindowsHelper en tu teléfono → toca Control por PC en la navegación inferior. Aparece un nuevo código de 8 caracteres (o se muestra el existente).
2. Fíjese en los caracteres que se confunden más fácilmente. Los códigos utilizan letras mayúsculas y dígitos, pero excluyen I, O, 0, and 1 por diseño. Si escribiste alguno de esos, escribiste mal.
3. Escribe el código en la ventana del Companion en uno o dos minutos desde que lo veas en el móvil.
4. Comprobación de Internet. Tanto su teléfono como su PC necesitan una conexión a Internet que funcione (el protocolo de enlace de emparejamiento se realiza a través de Firestore). Un WiFi doméstico defectuoso puede causar el mismo síntoma: intenta desactivar y volver a activar el WiFi en cualquier dispositivo que sea más débil.

3Los comandos no se ejecutan en mi PC

Tres causas comunes: límite de velocidad (10 comandos por minuto es el límite en ambos extremos), una verificación de seguridad previa al vuelo que rechazó el comando antes de la ejecución o una falta de coincidencia de firma de una clave de emparejamiento obsoleta después de una reparación del lado del teléfono.

1. Mira la sección "Órdenes en directo" en la ventana del Companion: cada orden recibida queda registrada ahí con su resultado. Si pone "Comprobación previa fallida" o "Límite de frecuencia alcanzado", ese es el motivo. Espera 60 segundos a que se vacíe la ventana de frecuencia.
2. Si el compañero nunca registró el comando, el teléfono nunca lo entregó. Abra el visor de registros WindowsHelper Companion (haga clic con el botón derecho en el icono de bandeja → Ver registros...) y verifique si hay errores de conexión de Firestore en las entradas más recientes.
3. Vuelve a emparejar. Si la verificación de firma rechaza sus comandos, las teclas del teléfono y de la PC no están sincronizadas. Haga clic derecho en el icono de la bandeja → Girar código de emparejamiento... en la PC, luego vuelva a ingresar el nuevo código en la pantalla de control de PC del teléfono.
4. Prueba la conexión tocando Probar conexión en la pantalla PC Control del móvil. Un ping correcto responde en <500 ms con la versión del Companion y el tiempo en marcha. Si falla, lo roto es el enlace en sí, no tu orden.

4El teléfono dice "PC sin conexión"

El Companion se marca como conectado mientras está en marcha, y tu teléfono lo vuelve a comprobar cada pocos segundos mientras la pantalla PC Control está abierta. La causa más habitual de una etiqueta «sin conexión» es que el PC estaba en suspensión, que el Companion se cerró o que se cayó la conexión del PC.

1. Comprueba que el Companion está en marcha. Busca el icono verde en la bandeja del sistema del PC. Si no está, haz doble clic en el .exe de la carpeta Descargas para volver a iniciarlo.
2. Despierta el PC. Un PC en suspensión no puede dar señales de sí mismo. Mueve el ratón y deja la pantalla PC Control abierta unos segundos: la etiqueta vuelve a ponerse verde sola. Si no lo hace, vuelve a iniciar el Companion: da señal en el momento en que arranca.
3. Comprueba la conexión del PC. Abre un navegador en el PC y carga cualquier sitio web. Si la página no carga, el Companion no puede llegar a Firestore: arregla la red y volverá a dar señal.
4. Vuelve a abrir la pantalla PC Control. Sal atrás y toca PC Control otra vez para reiniciar la comprobación de estado. Si el PC está realmente en línea, la etiqueta se actualiza en unos segundos.

5El antivirus puso en cuarentena el .exe

Los archivos .exe .NET autónomos son un falso positivo común para la heurística antivirus: agrupan todo el tiempo de ejecución de .NET + su código en un solo archivo, lo que estadísticamente se parece a los empaquetadores de malware para motores que no reconocen al editor. La firma de código elimina esto; Estamos trabajando en ello. Mientras tanto:

1. Agregue una exclusión ANTES de volver a descargar. Abra la configuración de su antivirus (Windows Defender: Configuración → Privacidad y seguridad → Windows Seguridad → Protección contra virus y amenazas → Administrar configuración → Agregar o eliminar exclusiones). Agregue una exclusión para:
   • La carpeta en la que guardará el .exe (p. ej. C:\Users\YourName\Downloads), o
   • Cualquier archivo que comience con WindowsHelperCompanion (por ej. WindowsHelperCompanion-*.exe).
2. Restaurar desde la cuarentena si ya fue eliminada. La mayoría de los productos antivirus tienen una vista de cuarentena (Defender: protección contra virus y amenazas → Historial de protección). Busque la entrada, haga clic en ella y luego Permitir o Restaurar.
3. Verifique el SHA-256 de su descarga. Si volvió a descargar, confirme que el hash coincida con el publicado en /companion-version.json:

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

4. Último recurso: pruebe temporalmente un producto AV diferente. Algunos AV de ganga marcan casi todo; el estándar de oro Windows Defender es generalmente el más preciso. Si su antivirus es el único que indica esto, es muy probable que se trate de un falso positivo.