Hoppa till dokumentationens innehåll
Keebye Docs

Felsökning

Vad varje meddelande Keebye visar betyder och hur du åtgärdar det, plus hur du återställer appen.

De flesta problem beror på en behörighet, en modell som saknas eller på att dikteringen är pausad. Börja med snabbkontrollerna och hitta sedan ditt meddelande nedan.

Gör hotkeyn ingenting? Kontrollera det här först

  1. "Enable Dictation" är markerat i menyraden.
  2. Du är inloggad och provperioden har inte tagit slut (Settings › Account).
  3. Accessibility är beviljad i System Settings › Privacy & Security › Accessibility.
  4. Ingen säker inmatning är aktiv — till exempel Secure Keyboard Entry i Terminal, eller ett lösenordsfält med fokus.

Meddelanden och vad de betyder

"Accessibility permission was revoked — reopen System Settings"

Accessibility-behörigheten saknades när inspelningen startade. Öppna System Settings › Privacy & Security › Accessibility och slå på Keebye. Keebye aktiverar hotkeyn igen inom 2 sekunder.

"Failed to start the global hotkey listener"

macOS nekade event tap-en. Ge Accessibility-behörighet och välj sedan din tangent igen i Settings.

"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." eller "Could not switch to <Key>; still using <Key>."

Bytet av hotkey nekades. Ge Accessibility-behörighet och välj tangenten igen; Keebye fortsätter använda den tidigare tangenten till dess.

"Microphone capture failed: <error>"

Det finns ingen standardenhet för ljudingång, eller ljudströmmen misslyckades. Kontrollera ingången i System Settings › Sound och att Microphone-behörighet är beviljad.

"Speech model still setting up — try again in a moment"

Den valda modellen finns inte på disk eller har inte laddats färdigt. Vänta tills statusindikatorn lämnar nedladdningsläget, eller tryck på "Download model" i Settings › Speech engine.

"Model download failed — reopen Keebye to retry"

Fem nedladdningsförsök misslyckades (nätverk, HTTP-fel eller felaktig kontrollsumma). Avsluta och öppna Keebye igen; nedladdningen fortsätter där den stannade.

"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"

Motorn Native (Apple Speech) är vald utan behörighet. Ge Speech Recognition-behörighet, eller byt till Parakeet eller Canary.

"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" eller "Apple Speech timed out after 15s"

Problem med Native-motorn. Språkmodellen på enheten kan behöva installeras via System Settings › Keyboard › Dictation; i övrigt: prata inom 15 sekunder eller byt motor.

"Couldn't insert: Secure input is active (<App>) — dictation is blocked" eller "Couldn't insert: A password field is focused — dictation is blocked"

Ett lösenordsfält har fokus eller en app har Secure Keyboard Entry på (till exempel Terminal). Klicka i ett vanligt textfält eller stäng av Secure Keyboard Entry. Det här är avsiktligt.

"Text left on clipboard — paste manually"

Syntetiseringen av ⌘V eller av tangenttrycken misslyckades. Transkriptet ligger i ditt urklipp; tryck ⌘V själv.

"Dictation hit an internal error and was reset. Please try again."

Sessionsarbetaren återhämtade sig från en krasch. Diktera igen.

Onboardingfönstret öppnades igen efter en uppdatering eller ominstallation

En gammal Accessibility-behörighet. Ta bort Keebye från System Settings › Privacy & Security › Accessibility med −-knappen, lägg tillbaka appen och slå på den.

Återställ Keebye

Avsluta Keebye, ta bort ~/Library/Application Support/com.keebye.app/settings.json och ta bort Keychain-posten för tjänsten com.keebye.app, kontot auth. Starta appen igen och onboardingen börjar om. Diagnostik går bara till stderr.