Risoluzione dei problemi

1Companion non si avvia

La causa più comune è un processo bloccato di una sessione precedente che tiene aperto il file della chiave di associazione. Companion gira in una sola istanza: se ne è già attiva una (anche senza finestra visibile), il nuovo avvio si chiude silenziosamente.

1. Controlla prima l'area di notifica. Guarda in basso a destra sullo schermo, vicino all'orologio, se c'è un'icona verde a forma di "PC". Se c'è, Companion È in esecuzione: fai doppio clic per riportare la finestra.
2. Uccidi qualsiasi istanza bloccata. Premere Ctrl+Shift+Esc per aprire Gestione attività. Su Dettagli scheda, cercare un processo che inizi con WindowsHelperCompanion. 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\logs\ - il più recente companion-YYYYMMDD.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 10 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 caratteri più facili da confondere. 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 di Companion entro un minuto o due da quando lo vedi sul 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 in diretta" nella finestra di Companion: ogni comando ricevuto viene registrato lì con il suo esito. Se compare "Controllo preliminare non riuscito" o "Limite di frequenza raggiunto", ecco il motivo. Attendi 60 secondi che la finestra di frequenza si svuoti.
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. Riesegui l'abbinamento. 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 → Ruota il codice di abbinamento... sul PC, quindi reinserire il nuovo codice nella schermata Controllo PC del telefono.
4. Prova la connessione toccando Prova connessione nella schermata PC Control del telefono. Un ping riuscito risponde in <500 ms con la versione di Companion e il tempo di attività. Un errore significa che è interrotto il collegamento stesso, non il tuo comando.

4Il telefono dice "PC offline"

Companion si segnala come connesso per tutto il tempo in cui è in esecuzione, e il tuo telefono lo ricontrolla ogni pochi secondi finché la schermata PC Control è aperta. La causa più comune di un'etichetta offline è che il PC dormiva, che Companion è stato chiuso o che è caduta la connessione del PC.

1. Verifica che Companion sia in esecuzione. Cerca l'icona verde nell'area di notifica del PC. Se manca, fai doppio clic sul file .exe nella cartella Download per riavviarlo.
2. Sveglia il PC. Un PC addormentato non può segnalarsi. Muovi il mouse, poi lascia aperta la schermata PC Control per qualche secondo — l'etichetta torna verde da sola. Se non lo fa, riavvia Companion: si segnala nell'istante in cui parte.
3. Controlla la connessione del PC. Apri un browser sul PC e carica un sito qualsiasi. Se la pagina non si carica, Companion non riesce a raggiungere Firestore — sistema la rete e tornerà a segnalarsi.
4. Riapri la schermata PC Control. Torna indietro, poi tocca di nuovo PC Control per far ripartire il controllo dello stato. Se il PC è davvero online, l'etichetta si aggiorna in pochi secondi.

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
   • Qualsiasi file che inizia con WindowsHelperCompanion (ad es. 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 (Get-ChildItem ~\Downloads\WindowsHelperCompanion*.exe | Sort-Object LastWriteTime | Select-Object -Last 1)).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.