Dépannage
Ce que veut dire chaque message affiché par Keebye et comment le corriger, plus la remise à zéro.
La plupart des problèmes tiennent à une autorisation, à un modèle manquant ou à une dictée en pause. Commencez par les vérifications rapides, puis trouvez votre message ci-dessous.
Le hotkey ne fait rien ? Vérifiez d'abord ceci
- "Enable Dictation" est coché dans le menu du tray.
- Vous êtes connecté et l'essai n'est pas terminé (Settings › Account).
- L'accessibilité est accordée dans Réglages Système › Confidentialité et sécurité › Accessibilité.
- Aucune saisie sécurisée n'est active — par exemple Secure Keyboard Entry dans Terminal, ou un champ de mot de passe qui a le focus.
Les messages et ce qu'ils veulent dire
"Accessibility permission was revoked — reopen System Settings"
L'autorisation d'accessibilité manquait au démarrage de l'enregistrement. Ouvrez Réglages Système › Confidentialité et sécurité › Accessibilité et activez Keebye. Keebye réarme le hotkey en moins de 2 secondes.
"Failed to start the global hotkey listener"
macOS a refusé l'event tap. Accordez l'accès à l'accessibilité, puis choisissez à nouveau votre touche dans Settings.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." ou "Could not switch to <Key>; still using <Key>."
Le changement de hotkey a été refusé. Accordez l'accès à l'accessibilité et choisissez la touche à nouveau ; d'ici là, Keebye continue avec la touche précédente.
"Microphone capture failed: <error>"
Il n'y a pas de périphérique d'entrée par défaut, ou le flux audio a échoué. Vérifiez le périphérique d'entrée dans Réglages Système › Son, et que l'accès au micro est accordé.
"Speech model still setting up — try again in a moment"
Le modèle sélectionné n'est pas sur le disque, ou il n'a pas fini de charger. Attendez que la pilule quitte l'état de téléchargement, ou appuyez sur "Download model" dans Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Cinq tentatives de téléchargement ont échoué (réseau, erreur HTTP ou somme de contrôle qui ne correspond pas). Quittez puis rouvrez Keebye ; le téléchargement reprend là où il s'était arrêté.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
Le moteur Native (Apple Speech) est sélectionné sans autorisation. Accordez la reconnaissance vocale, ou passez à Parakeet ou Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" ou "Apple Speech timed out after 15s"
Problèmes du moteur Native. Le modèle de langue on-device doit peut-être être installé via Réglages Système › Clavier › Dictée ; sinon, parlez dans les 15 secondes ou changez de moteur.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" ou "Couldn't insert: A password field is focused — dictation is blocked"
Un champ de mot de passe a le focus, ou une app a activé Secure Keyboard Entry (Terminal, par exemple). Cliquez dans un champ texte normal ou désactivez Secure Keyboard Entry. C'est voulu.
"Text left on clipboard — paste manually"
La synthèse de ⌘V ou des frappes a échoué. La transcription est dans votre presse-papiers ; faites ⌘V vous-même.
"Dictation hit an internal error and was reset. Please try again."
Le worker de session s'est remis d'un plantage. Redictez.
La fenêtre d'onboarding s'est rouverte après une mise à jour ou une réinstallation
Une autorisation d'accessibilité périmée. Retirez Keebye de Réglages Système › Confidentialité et sécurité › Accessibilité avec le bouton −, ajoutez-le à nouveau, puis activez-le.
Réinitialiser Keebye
Quittez Keebye, supprimez ~/Library/Application Support/com.keebye.app/settings.json, et retirez l'entrée de Keychain du service com.keebye.app, compte auth. Relancez : l'onboarding repart de zéro. Les diagnostics partent uniquement sur stderr.