Feilsøking
Hva hver melding Keebye viser betyr, hvordan du fikser den, og hvordan du tilbakestiller appen.
De fleste problemer handler om en tilgang, en manglende modell eller at dikteringen er satt på pause. Start med hurtigsjekkene, og finn meldingen din under.
Gjør hurtigtasten ingenting? Sjekk dette først
- "Enable Dictation" er avkrysset i menylinjemenyen.
- Du er logget inn, og prøveperioden er ikke over (Settings › Account).
- Accessibility er gitt i System Settings › Privacy & Security › Accessibility.
- Ingen sikker inndata er aktiv — for eksempel Secure Keyboard Entry i Terminal, eller et passordfelt som har fokus.
Meldinger og hva de betyr
"Accessibility permission was revoked — reopen System Settings"
Accessibility-tilliten manglet da opptaket startet. Åpne System Settings › Privacy & Security › Accessibility og slå på Keebye. Keebye aktiverer hurtigtasten på nytt innen 2 sekunder.
"Failed to start the global hotkey listener"
macOS avviste event tap-en. Gi Accessibility-tilgang, og velg tasten din på nytt i Settings.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." eller "Could not switch to <Key>; still using <Key>."
Endringen av hurtigtast ble avvist. Gi Accessibility-tilgang og velg tasten på nytt; Keebye fortsetter å bruke den forrige tasten til da.
"Microphone capture failed: <error>"
Det finnes ingen standard lydinngang, eller lydstrømmen feilet. Sjekk inngangsenheten i System Settings › Sound og at mikrofontilgang er gitt.
"Speech model still setting up — try again in a moment"
Den valgte modellen ligger ikke på disken eller er ikke ferdig lastet inn. Vent til pillen forlater nedlastingstilstanden, eller trykk "Download model" i Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Fem nedlastingsforsøk mislyktes (nettverk, HTTP-feil eller feil sjekksum). Avslutt og åpne Keebye igjen; nedlastingen fortsetter der den stoppet.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
Motoren Native (Apple Speech) er valgt uten tilgang. Gi tilgang til Speech Recognition, eller bytt 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. Språkmodellen på enheten må kanskje installeres via System Settings › Keyboard › Dictation; ellers må du snakke innen 15 sekunder eller bytte 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 passordfelt har fokus, eller en app har Secure Keyboard Entry slått på (for eksempel Terminal). Klikk i et vanlig tekstfelt, eller slå av Secure Keyboard Entry. Dette er med hensikt.
"Text left on clipboard — paste manually"
Synteseringen av ⌘V eller tastetrykkene mislyktes. Transkripsjonen ligger på utklippstavlen; trykk ⌘V selv.
"Dictation hit an internal error and was reset. Please try again."
Sesjonsarbeideren kom seg etter et krasj. Dikter på nytt.
Onboarding-vinduet åpnet seg igjen etter en oppdatering eller reinstallering
En utdatert Accessibility-tilgang. Fjern Keebye fra System Settings › Privacy & Security › Accessibility med −-knappen, legg den til igjen og slå den på.
Tilbakestille Keebye
Avslutt Keebye, slett ~/Library/Application Support/com.keebye.app/settings.json, og fjern nøkkelringoppføringen for tjenesten com.keebye.app, kontoen auth. Start appen igjen, og onboardingen begynner på nytt. Diagnostikk går bare til stderr.