Risoluzione dei problemi

1Il compagno non si avvia

La causa più comune è un processo bloccato nella sessione precedente che tiene aperto il file della chiave di abbinamento. Il compagno è a istanza singola: quando uno è già in esecuzione (anche senza una finestra visibile) il nuovo lancio esce silenziosamente.

1. Controlla prima la barra delle applicazioni. Guarda in basso a destra sullo schermo, vicino all'orologio, per individuare un'icona verde a forma di "PC". Se è lì, il compagno è in esecuzione: basta fare doppio clic per ripristinare la finestra.
2. Uccidi qualsiasi istanza bloccata. Premere ctrl+Cambio+Esc per aprire Gestione attività. Su Dettagli scheda, cerca WindowsHelperCompanion.exe. Fare clic con il pulsante destro del mouse su → Termina attività. Ripetere finché non ne viene elencato nessuno.
3. Esegui nuovamente il file .exe. Fai doppio clic sulla cartella Download. Entro 2-3 secondi viene visualizzata la finestra e l'icona nella barra delle applicazioni diventa verde.
4. Ancora niente? Controllare il registro diagnostico continuo su %APPDATA%\WindowsHelper\log\ - il più recente compagno-AAAAMMGG.ndjson il file ha il record di avvio (o l'errore che ne ha impedito uno). Apri Blocco note → File → Apri e incolla il percorso per vederlo.

2Il codice di abbinamento è rifiutato

I codici di abbinamento sono validi per 5 minuti da quando vengono visualizzati sul telefono. Se hai impiegato più tempo a digitare o se il tuo telefono ha aggiornato il codice (alcune schermate ruotano i codici a ogni visita), il codice visualizzato dal tuo PC non corrisponde più.

1. Ottieni un nuovo codice dal tuo telefono. Apri WindowsHelper sul tuo telefono → tocca Controllo PC nella navigazione in basso. Appare un nuovo codice di 8 caratteri (o viene mostrato quello esistente).
2. Fai attenzione ai personaggi che si confondono più facilmente. I codici utilizzano lettere maiuscole e cifre, ma escludono I, O, 0, and 1 in base alla progettazione. Se ne hai digitato uno, hai digitato male.
3. Digita il codice nella finestra complementare entro un minuto o due dal vederlo sul tuo telefono.
4. Controllo su Internet. Sia il tuo telefono che il tuo PC necessitano di una connessione Internet funzionante (l'handshake di accoppiamento passa attraverso Firestore). Un WiFi domestico instabile può causare lo stesso sintomo: prova a disabilitare e riabilitare il WiFi su qualunque dispositivo sia più debole.

3I comandi non vengono eseguiti sul mio PC

Tre cause comuni: limite di velocità (10 comandi al minuto è il limite su entrambe le estremità), un controllo di sicurezza pre-volo che ha rifiutato il comando prima dell'esecuzione o una mancata corrispondenza della firma da una chiave di accoppiamento obsoleta dopo una riassociazione lato telefono.

1. Controlla la sezione "Comandi live" sezione nella finestra complementare — ogni comando ricevuto viene registrato lì con il suo risultato. Se viene visualizzato il messaggio "Pre-controllo non riuscito" o "Limite tariffario raggiunto", questo è il motivo. Attendere 60 secondi affinché la finestra della tariffa venga cancellata.
2. Se il compagno non ha mai registrato il comando, il telefono non l'ha mai consegnato. Apri il visualizzatore registro WindowsHelper Companion (fai clic con il pulsante destro del mouse sull'icona nella barra delle applicazioni → Visualizza registri...) e controlla gli errori di connessione a Firestore nelle voci più recenti.
3. Riparazione. Se la verifica della firma rifiuta i tuoi comandi, i tasti del telefono e del PC non sono sincronizzati. Fai clic con il pulsante destro del mouse sull'icona nella barra delle applicazioni → Nuovo codice di abbinamento sul PC, quindi reinserire il nuovo codice nella schermata Controllo PC del telefono.
4. Testare la connettività toccando Testare la connessione nella schermata Controllo PC del telefono. Un ping riuscito risponde in <500 ms con la versione complementare + tempo di attività. Un fallimento significa che il filo stesso è rotto, non un tuo comando.

4Il telefono dice "PC offline"

Il compagno scrive un heartbeat su Firestore ogni 30 secondi. Il telefono considera il PC offline se il battito cardiaco più recente è più vecchio di ~90 secondi. La causa più comune è che il PC era in modalità di sospensione, il compagno si è chiuso o la connessione Internet del PC è interrotta.

1. Conferma che il compagno è in esecuzione. Cerca l'icona verde nella barra delle applicazioni del tuo PC. Se manca, fai doppio clic sul file .exe nella cartella Download per riavviarlo.
2. Riattiva il PC. Se il tuo PC era in stato di stop, il battito cardiaco si ferma finché non si riattiva. Muovi il mouse, quindi attendi 30-60 secondi per l'arrivo del battito cardiaco successivo: la pillola del telefono torna automaticamente al verde.
3. Controllare la connessione Internet del PC. Apri un browser sul PC e carica qualsiasi sito web. Un caricamento della pagina non riuscito significa che l'heartbeat non può raggiungere Firestore: correggi la rete, quindi l'heartbeat riprende.
4. Tocca Aggiorna sul telefono. Il pull-to-refresh nella schermata Controllo PC impone un nuovo controllo del documento heartbeat. Se il PC è davvero online, la pillola si aggiorna immediatamente.

5L'antivirus ha messo in quarantena il file .exe

I file .exe autonomi .NET sono un falso positivo comune per l'euristica AV: raggruppano l'intero runtime .NET + il codice in un unico file, che sembra statisticamente simile ai packer di malware per i motori che non riconoscono l'editore. La firma del codice elimina questo problema; ci stiamo lavorando. Nel frattempo:

1. Aggiungi un'esclusione PRIMA di riscaricare. Apri le impostazioni dell'antivirus (Windows Defender: Impostazioni → Privacy e sicurezza → Windows Sicurezza → Protezione da virus e minacce → Gestisci impostazioni → Aggiungi o rimuovi esclusioni). Aggiungi un'esclusione per:
   • La cartella in cui salverai il file .exe (ad es. C:\Users\YourName\Downloads), o
   • Il nome file specifico WindowsHelperCompanion.exe.
2. Ripristina dalla quarantena se era già stata rimossa. La maggior parte dei prodotti AV dispone di una visualizzazione in quarantena (Defender: Protezione da virus e minacce → Cronologia protezione). Trova la voce, fai clic su di essa, quindi Consenti o Ripristina.
3. Verifica lo SHA-256 del tuo download. Se hai effettuato nuovamente il download, verifica che l'hash corrisponda a quello pubblicato su /companion-version.json:

(Get-FileHash -Algorithm SHA256 ~\Downloads\WindowsHelperCompanion.exe).Hash

4. Ultima risorsa: provare temporaneamente un prodotto AV diverso. Alcuni AV a buon mercato segnalano quasi tutto; il difensore Windows standard aureo è generalmente il più preciso. Se il tuo AV è l'unico a segnalarlo, molto probabilmente si tratta di un falso positivo.