Solução de problemas

1O Companion não inicia

A causa mais comum é um processo travado de uma sessão anterior mantendo o arquivo da chave de pareamento aberto. O Companion roda em uma única instância — se já houver uma em execução (mesmo sem janela visível), a nova inicialização se encerra silenciosamente.

1. Confira primeiro a bandeja do sistema. Olhe no canto inferior direito da tela, perto do relógio, procurando um ícone verde em forma de "PC". Se estiver lá, o Companion ESTÁ rodando — é só dar dois cliques para trazer a janela de volta.
2. Mate qualquer instância travada. Pressione Ctrl+Shift+Esc para abrir o Gerenciador de Tarefas. No Detalhes guia, procure um processo começando com WindowsHelperCompanion. Clique com o botão direito em → Finalizar tarefa. Repita até que nenhum esteja listado.
3. Execute o .exe novamente. Clique duas vezes na pasta Downloads. Dentro de 2 a 3 segundos, a janela aparece e o ícone da bandeja fica verde.
4. Ainda nada? Verifique o log de diagnóstico contínuo em %APPDATA%\WindowsHelper\logs\ - o mais recente companion-YYYYMMDD.ndjson arquivo contém o registro de inicialização (ou o erro que o impediu). Abra o Bloco de Notas → Arquivo → Abra e cole esse caminho para vê-lo.

2O código de pareamento foi rejeitado

Os códigos de emparelhamento são válidos por 10 minutos a partir do momento em que seu telefone os mostra. Se você demorou mais para digitar ou se seu telefone atualizou o código (algumas telas alternam os códigos a cada visita), o código que seu PC vê não corresponde mais.

1. Obtenha um novo código do seu telefone. Abra WindowsHelper no seu telefone → toque Controle de PC na navegação inferior. Um novo código de 8 caracteres aparece (ou é mostrado o código existente).
2. Preste atenção aos caracteres mais fáceis de confundir. Os códigos usam letras maiúsculas e dígitos – mas excluem I, O, 0, and 1 por design. Se você digitou alguma dessas coisas, você digitou errado.
3. Digite o código na janela do Companion em um ou dois minutos depois de vê-lo no telefone.
4. Verificação da Internet. Tanto o telefone quanto o PC precisam de uma conexão funcional com a Internet (o handshake de emparelhamento passa pelo Firestore). Um WiFi doméstico instável pode causar o mesmo sintoma – tente desativar e reativar o WiFi no dispositivo que for mais fraco.

3Os comandos não estão sendo executados no meu PC

Três causas comuns: limite de taxa (10 comandos por minuto é o limite em ambas as extremidades), uma verificação de segurança pré-voo que recusou o comando antes da execução ou uma incompatibilidade de assinatura de uma chave de emparelhamento obsoleta após um novo emparelhamento no lado do telefone.

1. Veja a seção "Comandos ao vivo" na janela do Companion — cada comando recebido é registrado ali com o resultado. Se aparecer "Falha na verificação prévia" ou "Limite de taxa atingido", esse é o motivo. Espere 60 segundos até a janela de taxa esvaziar.
2. Se o companheiro nunca registrou o comando, o telefone nunca o entregou. Abra o visualizador de registros WindowsHelper Companion (clique com o botão direito no ícone da bandeja → Ver registros...) e verifique se há erros de conexão do Firestore nas entradas mais recentes.
3. Emparelhe novamente. Se a verificação de assinatura rejeitar seus comandos, as teclas do telefone e do PC estão fora de sincronia. Clique com o botão direito no ícone da bandeja → Girar código de pareamento... no PC e digite novamente o novo código na tela de controle do PC do telefone.
4. Teste a conectividade tocando em Testar conexão na tela PC Control do telefone. Um ping bem-sucedido responde em <500 ms com a versão do Companion e o tempo de atividade. Falha significa que o próprio enlace está rompido — não o seu comando.

4O telefone diz "PC offline"

O Companion se marca como conectado enquanto está em execução, e seu telefone confere isso de novo a cada poucos segundos enquanto a tela PC Control está aberta. A causa mais comum de uma etiqueta off-line é o PC ter entrado em suspensão, o Companion ter sido fechado ou a internet do PC ter caído.

1. Confirme que o Companion está em execução. Procure o ícone verde na bandeja do sistema do PC. Se ele sumiu, dê dois cliques no .exe na pasta Downloads para iniciá-lo de novo.
2. Acorde o PC. Um PC em suspensão não consegue dar notícias de si. Mexa o mouse e deixe a tela PC Control aberta por alguns segundos — a etiqueta volta ao verde sozinha. Se não voltar, inicie o Companion de novo: ele dá notícias no instante em que abre.
3. Verifique a internet do PC. Abra um navegador no PC e carregue qualquer site. Se a página não carregar, o Companion não está conseguindo chegar ao Firestore — conserte a rede e ele voltará a dar notícias.
4. Abra a tela PC Control de novo. Volte e toque em PC Control outra vez para reiniciar a verificação de estado. Se o PC realmente estiver online, a etiqueta se atualiza em poucos segundos.

5O antivírus colocou o .exe em quarentena

.exes .NET independentes são um falso positivo comum para heurísticas AV - eles agrupam todo o tempo de execução do .NET + seu código em um arquivo, que é estatisticamente semelhante a empacotadores de malware para mecanismos que não reconhecem o editor. A assinatura de código elimina isso; estamos trabalhando nisso. Enquanto isso:

1. Adicione uma exclusão ANTES de baixar novamente. Abra as configurações do seu antivírus (Windows Defender: Configurações → Privacidade e segurança → Windows Segurança → Proteção contra vírus e ameaças → Gerenciar configurações → Adicionar ou remover exclusões). Adicione uma exclusão para:
   • A pasta na qual você salvará o .exe (por exemplo, C:\Users\YourName\Downloads), ou
   • Qualquer arquivo começando com WindowsHelperCompanion (por exemplo WindowsHelperCompanion-*.exe).
2. Restaure da quarentena se ela já tiver sido removida. A maioria dos produtos AV tem uma visualização de quarentena (Defender: proteção contra vírus e ameaças → Histórico de proteção). Encontre a entrada, clique nela e depois Permitir ou Restaurar.
3. Verifique o SHA-256 do seu download. Se você baixou novamente, confirme se o hash corresponde ao publicado em /companion-version.json:

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

4. Último recurso: experimente temporariamente um produto AV diferente. Alguns AVs baratos sinalizam quase tudo; o padrão ouro Windows Defender é geralmente o mais preciso. Se o seu AV for o único sinalizando isso, é muito provável que seja um falso positivo.