Resolució de problemes
Què vol dir cada missatge que mostra el Keebye i com arreglar-ho, i com reiniciar-ho tot.
La majoria de problemes es redueixen a un permís, un model que falta o el dictat en pausa. Comença per les comprovacions ràpides i després busca el teu missatge aquí sota.
La hotkey no fa res? Comprova primer això
- "Enable Dictation" està marcat al menú de la safata.
- Has iniciat sessió i la prova no s'ha acabat (Settings › Account).
- L'accessibilitat està concedida a System Settings › Privacy & Security › Accessibility.
- No hi ha cap entrada segura activa — per exemple Secure Keyboard Entry al Terminal, o un camp de contrasenya amb focus.
Missatges i què volen dir
"Accessibility permission was revoked — reopen System Settings"
Faltava la confiança d'accessibilitat quan ha començat la gravació. Obre System Settings › Privacy & Security › Accessibility i activa el Keebye. El Keebye torna a armar la hotkey en menys de 2 segons.
"Failed to start the global hotkey listener"
macOS ha refusat l'event tap. Concedeix l'accés d'accessibilitat i després torna a triar la teva tecla a Settings.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." o "Could not switch to <Key>; still using <Key>."
El canvi de hotkey s'ha refusat. Concedeix l'accés d'accessibilitat i torna a triar la tecla; fins aleshores el Keebye continua fent servir la tecla anterior.
"Microphone capture failed: <error>"
No hi ha cap dispositiu d'entrada per defecte o el flux d'àudio ha fallat. Comprova el dispositiu d'entrada a System Settings › Sound i que l'accés al micròfon estigui concedit.
"Speech model still setting up — try again in a moment"
El model seleccionat no és al disc o no ha acabat de carregar-se. Espera que la píndola surti de l'estat de baixada, o prem "Download model" a Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Han fallat cinc intents de baixada (xarxa, error HTTP o suma de verificació que no quadra). Surt del Keebye i torna a obrir-lo; la baixada continua des d'on s'havia aturat.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
El motor Native (Apple Speech) està seleccionat sense autorització. Concedeix el reconeixement de veu, o canvia a Parakeet o Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" o "Apple Speech timed out after 15s"
Problemes del motor Native. Pot ser que calgui instal·lar el model de llengua on-device a System Settings › Keyboard › Dictation; si no, parla dins dels 15 segons o canvia de motor.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" o "Couldn't insert: A password field is focused — dictation is blocked"
Hi ha un camp de contrasenya amb focus o una app té activada la Secure Keyboard Entry (el Terminal, per exemple). Fes clic en un camp de text normal o desactiva la Secure Keyboard Entry. És així per disseny.
"Text left on clipboard — paste manually"
La síntesi de ⌘V o de les pulsacions ha fallat. La transcripció és al teu porta-retalls; prem ⌘V tu mateix.
"Dictation hit an internal error and was reset. Please try again."
El worker de la sessió s'ha recuperat d'un error greu. Torna a dictar.
La finestra d'onboarding s'ha tornat a obrir després d'una actualització o una reinstal·lació
Un permís d'accessibilitat obsolet. Treu el Keebye de System Settings › Privacy & Security › Accessibility amb el botó −, torna a afegir-l'hi i activa'l.
Reiniciar el Keebye
Surt del Keebye, esborra ~/Library/Application Support/com.keebye.app/settings.json i elimina l'element del Keychain del servei com.keebye.app, compte auth. Torna a obrir-lo i l'onboarding comença de nou. Els diagnòstics van només a stderr.