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).
- Su Mac, l'accessibilità è concessa in Impostazioni di Sistema › Privacy e sicurezza › Accessibilità .
- Su Mac, 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 nelle impostazioni audio (Impostazioni di Sistema › Suono su Mac) 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 (Ctrl+V su Windows) o delle battute è fallita. La trascrizione è nei tuoi appunti; incollala 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 (Mac)
Un'autorizzazione all'accessibilità obsoleta. Rimuovi Keebye da Impostazioni di Sistema › Privacy e sicurezza › Accessibilità con il pulsante −, aggiungilo di nuovo e attivalo.
Windows SmartScreen dice "Windows ha protetto il PC"
Il programma di installazione per Windows non ha ancora la firma del codice. Scegli Ulteriori informazioni, poi Esegui comunque — solo per un programma di installazione scaricato da keebye.com.
Su Windows la dettatura non registra nulla
Windows potrebbe bloccare l'accesso al microfono per le app desktop. Apri Impostazioni › Privacy e sicurezza › Microfono, consenti alle app desktop di usare il microfono e verifica che sia selezionato il dispositivo di ingresso giusto.
Riportare Keebye allo stato iniziale
Chiudi Keebye, elimina settings.json (in ~/Library/Application Support/com.keebye.app/ su Mac, in %APPDATA%\com.keebye.app\ su Windows) e rimuovi la credenziale salvata per il servizio com.keebye.app, account auth, dal Portachiavi di macOS o da Gestione credenziali di Windows. Riavvia e l'onboarding ricomincia. La diagnostica va solo su stderr.