Solução de problemas

1O companheiro não inicia

A causa mais comum é um processo de sessão anterior travado que mantém o arquivo da chave de emparelhamento aberto. O companheiro é de instância única – quando um já está em execução (mesmo sem uma janela visível), a nova inicialização sai silenciosamente.

1. Verifique primeiro a bandeja do sistema. Procure no canto inferior direito da tela, perto do relógio, um ícone verde em forma de “PC”. Se estiver lá, o complemento ESTÁ em execução – basta clicar duas vezes nele para trazer a janela de volta.
2. Mate qualquer instância travada. Imprensa Ctrl+Mudança+Esc para abrir o Gerenciador de Tarefas. No Detalhes guia, procure WindowsHelperCompanion.exe. 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 companheiro-AAAAMMDD.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 5 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. Fique atento aos personagens mais facilmente confundidos. 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 complementar dentro de um ou dois minutos depois de vê-lo em seu 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. Verifique a opção "Comandos ao vivo" seção na janela complementar – cada comando recebido é registrado lá com seu resultado. Se mostrar "Falha na pré-verificação" ou "Limite de taxa atingido", esse é o seu motivo. Aguarde 60 segundos para que a janela de taxa seja limpa.
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. Reparar. 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 → Novo código de emparelhamento no PC e digite novamente o novo código na tela de controle do PC do telefone.
4. Testar conectividade tocando Conexão de teste na tela de controle do PC do telefone. Um ping bem-sucedido responde em <500 ms com a versão complementar + tempo de atividade. Falha significa que o próprio fio está quebrado – não o seu comando.

4O telefone diz "PC offline"

O complemento grava uma pulsação no Firestore a cada 30 segundos. O telefone considera o PC offline se a pulsação mais recente tiver mais de aproximadamente 90 segundos. A causa mais comum é que o PC estava dormindo, o companheiro saiu ou a Internet do PC caiu.

1. Confirme se o complementar está em execução. Procure na bandeja do sistema do seu PC o ícone verde. Se estiver faltando, clique duas vezes no .exe na pasta Downloads para reiniciar.
2. Acorde o PC. Se o seu PC estava em suspensão, a pulsação para até que ele acorde. Mova o mouse e aguarde de 30 a 60 segundos até que o próximo batimento cardíaco chegue – a pílula do telefone volta para verde automaticamente.
3. Verifique a internet do PC. Abra um navegador no PC e carregue qualquer site. Uma falha no carregamento da página significa que a pulsação não pode alcançar o Firestore. Corrija a rede e a pulsação será retomada.
4. Toque em Atualizar no telefone. Puxar para atualizar na tela de controle do PC força uma nova verificação do documento de pulsação. Se o PC estiver realmente online, o tablet será atualizado imediatamente.

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
   • O nome do arquivo específico 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 ~\Downloads\WindowsHelperCompanion.exe).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.