Depanare
Ce înseamnă fiecare mesaj afișat de Keebye și cum îl rezolvi, plus cum readuci totul la zero.
Majoritatea problemelor se reduc la o permisiune, la un model lipsă sau la dictarea pusă pe pauză. Începe cu verificările rapide, apoi caută mesajul tău mai jos.
Hotkey-ul nu face nimic? Verifică mai întâi astea
- "Enable Dictation" e bifat în meniul din bara de meniu.
- Ești autentificat și perioada de probă nu s-a încheiat (Settings › Account).
- Accesibilitatea e acordată în System Settings › Privacy & Security › Accessibility.
- Nu e activă nicio intrare securizată — de exemplu Secure Keyboard Entry în Terminal, sau un câmp de parolă cu focus.
Mesajele și ce înseamnă
"Accessibility permission was revoked — reopen System Settings"
Permisiunea de accesibilitate lipsea când a început înregistrarea. Deschide System Settings › Privacy & Security › Accessibility și activează Keebye. Keebye rearmează hotkey-ul în 2 secunde.
"Failed to start the global hotkey listener"
macOS a refuzat event tap-ul. Acordă accesul de accesibilitate, apoi alege din nou tasta în Settings.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." sau "Could not switch to <Key>; still using <Key>."
Schimbarea hotkey-ului a fost refuzată. Acordă accesul de accesibilitate și alege tasta din nou; până atunci Keebye rămâne pe tasta anterioară.
"Microphone capture failed: <error>"
Nu există niciun dispozitiv de intrare implicit sau fluxul audio a eșuat. Verifică dispozitivul de intrare în System Settings › Sound și dacă accesul la microfon e acordat.
"Speech model still setting up — try again in a moment"
Modelul selectat nu e pe disc sau nu s-a încărcat complet. Așteaptă până când pastila iese din starea de descărcare sau apasă "Download model" în Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Cinci încercări de descărcare au eșuat (rețea, eroare HTTP sau sumă de control care nu corespunde). Închide și redeschide Keebye; descărcarea continuă din punctul în care s-a oprit.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
Motorul Native (Apple Speech) e selectat fără autorizare. Acordă Speech Recognition sau comută pe Parakeet ori pe Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" sau "Apple Speech timed out after 15s"
Probleme ale motorului Native. Poate fi nevoie să instalezi modelul de limbă on-device din System Settings › Keyboard › Dictation; în rest, vorbește în cele 15 secunde sau schimbă motorul.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" sau "Couldn't insert: A password field is focused — dictation is blocked"
Un câmp de parolă are focus sau o aplicație are Secure Keyboard Entry activ (Terminal, de exemplu). Dă clic într-un câmp de text normal sau dezactivează Secure Keyboard Entry. Așa e gândit.
"Text left on clipboard — paste manually"
Sintetizarea ⌘V sau a tastelor a eșuat. Transcrierea e în clipboard; apasă ⌘V tu.
"Dictation hit an internal error and was reset. Please try again."
Procesul sesiunii și-a revenit după o cădere. Dictează din nou.
Fereastra de onboarding s-a redeschis după o actualizare sau o reinstalare
O permisiune de accesibilitate învechită. Scoate Keebye din System Settings › Privacy & Security › Accessibility cu butonul −, adaugă-l din nou și activează-l.
Resetarea Keebye
Închide Keebye, șterge ~/Library/Application Support/com.keebye.app/settings.json și scoate elementul de Keychain pentru serviciul com.keebye.app, contul auth. Repornește aplicația și onboarding-ul începe din nou. Diagnosticele merg doar în stderr.