Μετάβαση στο περιεχόμενο της τεκμηρίωσης
Keebye Docs

Επίλυση προβλημάτων

Τι σημαίνει κάθε μήνυμα που δείχνει το Keebye και πώς διορθώνεται, μαζί με το πώς κάνεις επαναφορά.

Τα περισσότερα προβλήματα καταλήγουν σε μια άδεια, σε ένα μοντέλο που λείπει ή στο ότι η υπαγόρευση είναι σε παύση. Ξεκίνα με τους γρήγορους ελέγχους, μετά βρες το μήνυμά σου παρακάτω.

Το hotkey δεν κάνει τίποτα; Έλεγξε πρώτα αυτά

  1. Το "Enable Dictation" είναι τσεκαρισμένο στο μενού της γραμμής μενού.
  2. Είσαι συνδεδεμένος και η δοκιμή δεν έχει λήξει (Settings › Account).
  3. Η προσβασιμότητα έχει δοθεί στο System Settings › Privacy & Security › Accessibility.
  4. Δεν είναι ενεργό κανένα secure input — για παράδειγμα Secure Keyboard Entry στο Terminal, ή εστιασμένο πεδίο κωδικού.

Μηνύματα και τι σημαίνουν

"Accessibility permission was revoked — reopen System Settings"

Η εμπιστοσύνη Accessibility έλειπε όταν ξεκίνησε η εγγραφή. Άνοιξε System Settings › Privacy & Security › Accessibility και ενεργοποίησε το Keebye. Το Keebye οπλίζει ξανά το hotkey μέσα σε 2 δευτερόλεπτα.

"Failed to start the global hotkey listener"

Το macOS απέρριψε το event tap. Δώσε άδεια προσβασιμότητας, μετά διάλεξε ξανά το πλήκτρο σου στο Settings.

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

Η αλλαγή του hotkey απορρίφθηκε. Δώσε άδεια προσβασιμότητας και διάλεξε ξανά το πλήκτρο· μέχρι τότε το Keebye συνεχίζει με το προηγούμενο.

"Microphone capture failed: <error>"

Δεν υπάρχει προεπιλεγμένη συσκευή εισόδου ή απέτυχε η ροή ήχου. Έλεγξε τη συσκευή εισόδου στο System Settings › Sound και ότι έχει δοθεί άδεια Μικροφώνου.

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

Το επιλεγμένο μοντέλο δεν είναι στον δίσκο ή δεν έχει φορτώσει ακόμη. Περίμενε να βγει η κάψουλα από την κατάσταση κατεβάσματος, ή πάτα "Download model" στο Settings › Speech engine.

"Model download failed — reopen Keebye to retry"

Πέντε προσπάθειες κατεβάσματος απέτυχαν (δίκτυο, σφάλμα HTTP ή ασυμφωνία checksum). Βγες και άνοιξε ξανά το Keebye· το κατέβασμα συνεχίζει από εκεί που σταμάτησε.

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

Η μηχανή Native (Apple Speech) είναι επιλεγμένη χωρίς εξουσιοδότηση. Δώσε άδεια Αναγνώρισης Ομιλίας, ή άλλαξε σε Parakeet ή Canary.

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

Θέματα της μηχανής Native. Μπορεί να χρειάζεται εγκατάσταση του on-device γλωσσικού μοντέλου από το System Settings › Keyboard › Dictation· αλλιώς μίλα μέσα σε 15 δευτερόλεπτα ή άλλαξε μηχανή.

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

Είναι εστιασμένο ένα πεδίο κωδικού ή μια εφαρμογή έχει ενεργό το Secure Keyboard Entry (το Terminal, για παράδειγμα). Κάνε κλικ σε κανονικό πεδίο κειμένου ή απενεργοποίησε το Secure Keyboard Entry. Είναι σχεδιασμένο έτσι.

"Text left on clipboard — paste manually"

Η σύνθεση του ⌘V ή των πλήκτρων απέτυχε. Η μεταγραφή είναι στο πρόχειρό σου· πάτα ⌘V μόνος σου.

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

Ο worker της συνεδρίας ανέκαμψε από crash. Υπαγόρευσε ξανά.

Το παράθυρο αρχικής ρύθμισης άνοιξε ξανά μετά από ενημέρωση ή επανεγκατάσταση

Παλιά άδεια Accessibility. Αφαίρεσε το Keebye από το System Settings › Privacy & Security › Accessibility με το κουμπί −, πρόσθεσέ το ξανά και ενεργοποίησέ το.

Επαναφορά του Keebye

Βγες από το Keebye, σβήσε το ~/Library/Application Support/com.keebye.app/settings.json και αφαίρεσε το στοιχείο Keychain για την υπηρεσία com.keebye.app, λογαριασμός auth. Ξεκίνα το ξανά και η αρχική ρύθμιση αρχίζει από την αρχή. Τα διαγνωστικά πάνε μόνο στο stderr.