Fejlfinding
Hvad hver besked, Keebye viser, betyder, og hvordan du retter det, plus hvordan du nulstiller appen.
De fleste problemer skyldes en tilladelse, en manglende model eller at dikteringen er sat på pause. Start med de hurtige tjek, og find så din besked herunder.
Gør hotkeyen ingenting? Tjek disse først
- "Enable Dictation" er markeret i menubjælken.
- Du er logget ind, og prøveperioden er ikke slut (Settings › Account).
- Accessibility er givet i System Settings › Privacy & Security › Accessibility.
- Ingen sikker input er aktiv — for eksempel Secure Keyboard Entry i Terminal eller et adgangskodefelt med fokus.
Beskeder og hvad de betyder
"Accessibility permission was revoked — reopen System Settings"
Accessibility-tilladelsen manglede, da optagelsen startede. Åbn System Settings › Privacy & Security › Accessibility og slå Keebye til. Keebye aktiverer hotkeyen igen inden for 2 sekunder.
"Failed to start the global hotkey listener"
macOS afviste event tap-et. Giv Accessibility-adgang, og vælg så din tast igen i Settings.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." eller "Could not switch to <Key>; still using <Key>."
Skiftet af hotkey blev afvist. Giv Accessibility-adgang og vælg tasten igen; Keebye bruger den tidligere tast indtil da.
"Microphone capture failed: <error>"
Der er ingen standard-inputenhed, eller lydstrømmen fejlede. Tjek inputenheden i System Settings › Sound, og at Microphone-adgang er givet.
"Speech model still setting up — try again in a moment"
Den valgte model ligger ikke på disken eller er ikke indlæst færdig. Vent, til statusindikatoren forlader downloadtilstanden, eller tryk på "Download model" i Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Fem downloadforsøg fejlede (netværk, HTTP-fejl eller forkert checksum). Afslut og åbn Keebye igen; downloaden fortsætter, hvor den stoppede.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
Motoren Native (Apple Speech) er valgt uden tilladelse. Giv Speech Recognition-adgang, eller skift til Parakeet eller Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" eller "Apple Speech timed out after 15s"
Problemer med Native-motoren. Sprogmodellen on-device skal måske installeres via System Settings › Keyboard › Dictation; ellers: tal inden for 15 sekunder eller skift motor.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" eller "Couldn't insert: A password field is focused — dictation is blocked"
Et adgangskodefelt har fokus, eller en app har Secure Keyboard Entry slået til (for eksempel Terminal). Klik i et almindeligt tekstfelt eller slå Secure Keyboard Entry fra. Det er med vilje.
"Text left on clipboard — paste manually"
Syntetiseringen af ⌘V eller af tastetrykkene fejlede. Transskriptionen ligger i din udklipsholder; tryk selv ⌘V.
"Dictation hit an internal error and was reset. Please try again."
Sessions-workeren kom sig efter et nedbrud. Diktér igen.
Onboardingvinduet åbnede igen efter en opdatering eller geninstallation
En forældet Accessibility-tilladelse. Fjern Keebye fra System Settings › Privacy & Security › Accessibility med −-knappen, læg den tilbage, og slå den til.
Nulstil Keebye
Afslut Keebye, slet ~/Library/Application Support/com.keebye.app/settings.json, og fjern Keychain-posten for tjenesten com.keebye.app, kontoen auth. Start appen igen, og onboardingen begynder forfra. Diagnostik går kun til stderr.