Pular para o conteúdo principal

Solução de Problemas

Problemas comuns e como resolvê-los.

Nada acontece quando pressiono o atalho​

  1. Certifique-se de que o SpokenCode está em execução. Procure o ícone do SpokenCode na bandeja do sistema (canto inferior direito da barra de tarefas do Windows). Se não estiver lá, inicie o SpokenCode pelo Menu Iniciar.

  2. Verifique se o microfone está conectado e funcionando. Tente gravar algo em outro aplicativo (como o Gravador de Voz do Windows) para confirmar que o microfone está funcionando.

  3. Re-registre o atalho. Abra o SpokenCode, vá para Configurações → Teclado, altere o Modo de Gravação, clique em Salvar Configurações, depois mude de volta e salve novamente. Isso atualiza o registro do atalho.

O aplicativo está pedindo uma chave de API​

Você precisa de uma chave de API do SpokenCode para usar o aplicativo.

  1. Acesse spokencode.dev e crie uma conta gratuita
  2. Copie sua chave de API — ela é exibida apenas uma vez no registro
  3. Abra o SpokenCode, vá para Configurações → Configurações da API SpokenCode → Chave de API
  4. Cole a chave e clique em Salvar Configurações
  5. Clique em Testar Conexão para verificar se a chave é válida

Minha transcrição está imprecisa​

  • Fale com clareza e posicione o microfone próximo à sua boca
  • Defina seu idioma explicitamente em Configurações → Configurações da API SpokenCode → Idioma em vez de usar a detecção automática
  • Mude para o Whisper Large V3 em Configurações → Configurações da API SpokenCode → Modelo de Transcrição para a maior precisão

Minha palavra-chave de comando de voz não está sendo reconhecida​

  • A palavra-chave deve estar no início da sua frase — dizer "eu preciso de uma função javascript" não funcionará; diga "javascript criar uma função" em vez disso
  • Verifique se Configurações → Idioma da Interface corresponde ao idioma que você está falando. As palavras-chave são diferentes para cada idioma (por exemplo, o português usa "comando" em vez de "command")
  • Fale em um ritmo normal — fala rápida ou pouco clara pode ser reconhecida incorretamente

Fiquei sem créditos​

Seu saldo de créditos é exibido no canto superior direito da janela do aplicativo. Quando chegar a 0, a transcrição e a geração de código param de funcionar.

Compre mais créditos em spokencode.dev.

A janela flutuante está atrapalhando​

Vá para Configurações → Configurações de Comportamento e desmarque Mostrar Janela Flutuante, depois clique em Salvar Configurações. Você ainda pode usar todos os atalhos normalmente — a única diferença é que nenhum indicador visual aparece durante a gravação.

O aplicativo desapareceu e não consigo encontrá-lo​

O SpokenCode minimiza para a bandeja do sistema quando você fecha a janela. Procure o ícone do SpokenCode no canto inferior direito da barra de tarefas do Windows (talvez seja necessário clicar na seta para cima ^ para ver os ícones ocultos na bandeja).

Clique com o botão direito no ícone e selecione Abrir Interface para trazer a janela de volta.

Obtendo Mais Ajuda​

Se nenhuma das etapas acima resolver seu problema:

  1. Abra um relatório de bug em GitHub Issues

Ao reportar, inclua:

  • Sua versão do SpokenCode (visível na aba Sobre)
  • Sua versão do Windows (ex.: Windows 11 23H2)
  • Uma descrição do problema e o que você tentou
  • Quaisquer mensagens de erro visíveis na tela