Risoluzione dei problemi
Cosa significa ogni messaggio che Keebye mostra e come risolverlo, più come riportare l'app allo stato iniziale.
Quasi tutti i problemi si riducono a un permesso, a un modello mancante o alla dettatura in pausa. Parti dai controlli rapidi, poi cerca il tuo messaggio qui sotto.
L'hotkey non fa nulla? Controlla prima questo
- "Enable Dictation" è spuntato nel menu della barra.
- Hai fatto l'accesso e la prova non è finita (Settings › Account).
- L'accessibilità è concessa in Impostazioni di Sistema › Privacy e sicurezza › Accessibilità .
- Nessun input sicuro attivo — per esempio l'Inserimento tastiera sicuro nel Terminale, o un campo password che ha il focus.
Messaggi e cosa significano
"Accessibility permission was revoked — reopen System Settings"
L'autorizzazione all'accessibilità mancava all'avvio della registrazione. Apri Impostazioni di Sistema › Privacy e sicurezza › Accessibilità e attiva Keebye. Keebye riarma l'hotkey entro 2 secondi.
"Failed to start the global hotkey listener"
macOS ha rifiutato l'event tap. Concedi l'accesso all'accessibilità , poi scegli di nuovo il tasto in Settings.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." o "Could not switch to <Key>; still using <Key>."
Il cambio di hotkey è stato rifiutato. Concedi l'accesso all'accessibilità e scegli di nuovo il tasto; fino a quel momento Keebye continua a usare il tasto precedente.
"Microphone capture failed: <error>"
Non c'è un dispositivo di ingresso predefinito o il flusso audio è fallito. Controlla il dispositivo di ingresso in Impostazioni di Sistema › Suono e che l'accesso al microfono sia concesso.
"Speech model still setting up — try again in a moment"
Il modello selezionato non è su disco o non ha finito di caricarsi. Aspetta che la pillola esca dallo stato di download, o premi "Download model" in Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Cinque tentativi di download sono falliti (rete, errore HTTP o checksum non corrispondente). Chiudi e riapri Keebye; il download riprende da dove si era fermato.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
Il motore Native (Apple Speech) è selezionato senza autorizzazione. Concedi il Riconoscimento vocale, oppure passa a Parakeet o Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" o "Apple Speech timed out after 15s"
Problemi del motore Native. Può essere necessario installare il modello linguistico on-device da Impostazioni di Sistema › Tastiera › Dettatura; altrimenti parla entro 15 secondi o cambia motore.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" o "Couldn't insert: A password field is focused — dictation is blocked"
Un campo password ha il focus o un'app ha l'Inserimento tastiera sicuro attivo (il Terminale, per esempio). Fai clic in un campo di testo normale o disattiva l'Inserimento tastiera sicuro. È voluto.
"Text left on clipboard — paste manually"
La sintesi di ⌘V o delle battute è fallita. La trascrizione è nei tuoi appunti; premi ⌘V tu.
"Dictation hit an internal error and was reset. Please try again."
Il worker della sessione si è ripreso da un errore grave. Detta di nuovo.
La finestra di onboarding si è riaperta dopo un aggiornamento o una reinstallazione
Un'autorizzazione all'accessibilità obsoleta. Rimuovi Keebye da Impostazioni di Sistema › Privacy e sicurezza › Accessibilità con il pulsante −, aggiungilo di nuovo e attivalo.
Riportare Keebye allo stato iniziale
Chiudi Keebye, elimina ~/Library/Application Support/com.keebye.app/settings.json e rimuovi la voce del Portachiavi per il servizio com.keebye.app, account auth. Riavvia e l'onboarding ricomincia. La diagnostica va solo su stderr.