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).
- En un Mac, l'accessibilitat està concedida a System Settings › Privacy & Security › Accessibility.
- En un Mac, 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 la configuració de so (System Settings › Sound en un Mac) 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 (Ctrl+V a Windows) o de les pulsacions ha fallat. La transcripció és al teu porta-retalls; enganxa-la 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ó (Mac)
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.
Windows SmartScreen diu "Windows protected your PC"
L'instal·lador de Windows encara no està signat digitalment. Tria More info i després Run anyway — només amb un instal·lador que hagis baixat de keebye.com.
A Windows, el dictat no grava res
És possible que Windows estigui bloquejant l'accés al micròfon per a les aplicacions d'escriptori. Obre Settings › Privacy & security › Microphone, permet que les aplicacions d'escriptori facin servir el micròfon i comprova que tens seleccionat el dispositiu d'entrada correcte.
Reiniciar el Keebye
Surt del Keebye, esborra settings.json (a ~/Library/Application Support/com.keebye.app/ en un Mac, a %APPDATA%\com.keebye.app\ a Windows) i elimina la credencial guardada del servei com.keebye.app, compte auth, del Keychain de macOS o de Windows Credential Manager. Torna a obrir-lo i l'onboarding comença de nou. Els diagnòstics van només a stderr.