Fehlerbehebung
Was jede Meldung von Keebye bedeutet und wie Sie sie beheben, dazu das Zurücksetzen.
Die meisten Probleme liegen an einer Berechtigung, einem fehlenden Modell oder daran, dass das Diktat pausiert ist. Beginnen Sie mit den schnellen Prüfungen und suchen Sie dann Ihre Meldung unten.
Hotkey tut nichts? Prüfen Sie zuerst das
- "Enable Dictation" ist im Tray-Menü angehakt.
- Sie sind angemeldet und die Testphase ist nicht beendet (Settings › Account).
- Der Bedienungshilfen-Zugriff ist in Systemeinstellungen › Datenschutz & Sicherheit › Bedienungshilfen erteilt.
- Keine sichere Eingabe ist aktiv — zum Beispiel Secure Keyboard Entry im Terminal oder ein fokussiertes Passwortfeld.
Meldungen und was sie bedeuten
"Accessibility permission was revoked — reopen System Settings"
Die Bedienungshilfen-Freigabe fehlte beim Start der Aufnahme. Öffnen Sie Systemeinstellungen › Datenschutz & Sicherheit › Bedienungshilfen und schalten Sie Keebye ein. Keebye aktiviert den Hotkey innerhalb von 2 Sekunden neu.
"Failed to start the global hotkey listener"
macOS hat den Event Tap abgelehnt. Erteilen Sie den Bedienungshilfen-Zugriff und wählen Sie Ihre Taste in Settings erneut.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." oder "Could not switch to <Key>; still using <Key>."
Der Wechsel des Hotkeys wurde abgelehnt. Erteilen Sie den Bedienungshilfen-Zugriff und wählen Sie die Taste erneut; bis dahin nutzt Keebye weiter die vorherige Taste.
"Microphone capture failed: <error>"
Es gibt kein Standard-Eingabegerät, oder der Audio-Stream ist fehlgeschlagen. Prüfen Sie das Eingabegerät in Systemeinstellungen › Ton und dass der Mikrofon-Zugriff erteilt ist.
"Speech model still setting up — try again in a moment"
Das gewählte Modell liegt nicht auf der Festplatte oder ist noch nicht fertig geladen. Warten Sie, bis die Pille den Download-Zustand verlässt, oder drücken Sie "Download model" in Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Fünf Download-Versuche sind fehlgeschlagen (Netzwerk, HTTP-Fehler oder falsche Prüfsumme). Beenden Sie Keebye und öffnen Sie es erneut; der Download wird dort fortgesetzt, wo er stehen geblieben ist.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
Die Engine Native (Apple Speech) ist gewählt, ohne dass die Freigabe vorliegt. Erteilen Sie die Spracherkennung, oder wechseln Sie zu Parakeet oder Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" oder "Apple Speech timed out after 15s"
Probleme der Native-Engine. Das On-Device-Sprachmodell muss vielleicht über Systemeinstellungen › Tastatur › Diktat installiert werden; sprechen Sie andernfalls innerhalb von 15 Sekunden oder wechseln Sie die Engine.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" oder "Couldn't insert: A password field is focused — dictation is blocked"
Ein Passwortfeld ist fokussiert, oder eine App hat Secure Keyboard Entry aktiv (zum Beispiel Terminal). Klicken Sie in ein normales Textfeld oder schalten Sie Secure Keyboard Entry aus. Das ist so gewollt.
"Text left on clipboard — paste manually"
Das Synthetisieren von ⌘V oder der Tastenanschläge ist fehlgeschlagen. Das Transkript liegt in Ihrer Zwischenablage; drücken Sie selbst ⌘V.
"Dictation hit an internal error and was reset. Please try again."
Der Session-Worker hat sich von einem Absturz erholt. Diktieren Sie erneut.
Das Onboarding-Fenster ging nach einem Update oder einer Neuinstallation wieder auf
Eine veraltete Bedienungshilfen-Freigabe. Entfernen Sie Keebye mit der Taste − aus Systemeinstellungen › Datenschutz & Sicherheit › Bedienungshilfen, fügen Sie es wieder hinzu und schalten Sie es ein.
Keebye zurücksetzen
Beenden Sie Keebye, löschen Sie ~/Library/Application Support/com.keebye.app/settings.json und entfernen Sie den Keychain-Eintrag für den Service com.keebye.app, Account auth. Nach dem Neustart beginnt das Onboarding erneut. Diagnosemeldungen gehen nur nach stderr.