Solução de problemas
O que significa cada mensagem que o Keebye mostra e como resolver, além de como zerar tudo.
A maioria dos problemas se resume a uma permissão, a um modelo ausente ou ao ditado estar pausado. Comece pelas verificações rápidas e depois encontre a sua mensagem abaixo.
A hotkey não faz nada? Verifique isto primeiro
- O "Enable Dictation" está marcado no menu da barra de menus.
- Você está com a conta conectada e o teste não terminou (Settings › Account).
- A acessibilidade está concedida em System Settings › Privacy & Security › Accessibility.
- Nenhuma entrada segura está ativa — por exemplo o Secure Keyboard Entry no Terminal, ou um campo de senha em foco.
As mensagens e o que elas significam
"Accessibility permission was revoked — reopen System Settings"
A permissão de acessibilidade estava ausente quando a gravação começou. Abra System Settings › Privacy & Security › Accessibility e ative o Keebye. O Keebye rearma a hotkey em 2 segundos.
"Failed to start the global hotkey listener"
O macOS recusou o event tap. Conceda o acesso de acessibilidade e escolha a sua tecla de novo no Settings.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." ou "Could not switch to <Key>; still using <Key>."
A troca de hotkey foi recusada. Conceda o acesso de acessibilidade e escolha a tecla de novo; até então o Keebye continua usando a tecla anterior.
"Microphone capture failed: <error>"
Não há dispositivo de entrada padrão ou o fluxo de áudio falhou. Verifique o dispositivo de entrada em System Settings › Sound e se o acesso ao microfone está concedido.
"Speech model still setting up — try again in a moment"
O modelo selecionado não está em disco ou ainda não terminou de carregar. Espere a pílula sair do estado de download ou pressione "Download model" em Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Cinco tentativas de download falharam (rede, erro HTTP ou checksum divergente). Feche e abra o Keebye de novo; o download continua de onde parou.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
O motor Native (Apple Speech) está selecionado sem autorização. Conceda o Speech Recognition ou troque para o Parakeet ou o Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" ou "Apple Speech timed out after 15s"
Problemas do motor Native. Pode ser necessário instalar o modelo de idioma on-device em System Settings › Keyboard › Dictation; fora isso, fale dentro de 15 segundos ou troque de motor.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" ou "Couldn't insert: A password field is focused — dictation is blocked"
Um campo de senha está em foco ou um app tem o Secure Keyboard Entry ativo (o Terminal, por exemplo). Clique em um campo de texto normal ou desligue o Secure Keyboard Entry. Isso é intencional.
"Text left on clipboard — paste manually"
A síntese do ⌘V ou das teclas falhou. A transcrição está na sua área de transferência; pressione ⌘V você mesmo.
"Dictation hit an internal error and was reset. Please try again."
O processo da sessão se recuperou de uma falha. Dite de novo.
A janela de onboarding reabriu depois de uma atualização ou reinstalação
Uma permissão de acessibilidade desatualizada. Remova o Keebye de System Settings › Privacy & Security › Accessibility com o botão −, adicione de novo e ative.
Redefinir o Keebye
Feche o Keebye, apague ~/Library/Application Support/com.keebye.app/settings.json e remova o item do Keychain do serviço com.keebye.app, conta auth. Abra o app de novo e o onboarding começa outra vez. Os diagnósticos vão só para o stderr.