For AI agents: full index at https://keebye.com/llms.txt

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

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

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

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

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

  1. Το "Enable Dictation" είναι τσεκαρισμένο στο μενού της γραμμής μενού.
  2. Είσαι συνδεδεμένος και η δοκιμή δεν έχει λήξει (Settings › Account).
  3. Σε Mac, η προσβασιμότητα έχει δοθεί στο System Settings › Privacy & Security › Accessibility.
  4. Σε Mac, δεν είναι ενεργό κανένα 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 σε Mac) και ότι έχει δοθεί άδεια Μικροφώνου.

"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 (Ctrl+V στα Windows) ή των πλήκτρων απέτυχε. Η μεταγραφή είναι στο πρόχειρό σου· επικόλλησέ τη μόνος σου.

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

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

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

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

Το Windows SmartScreen λέει "Τα Windows προστάτευσαν τον υπολογιστή σας"

Το πρόγραμμα εγκατάστασης για Windows δεν έχει ακόμη ψηφιακή υπογραφή κώδικα. Επίλεξε "Περισσότερες πληροφορίες" και μετά "Εκτέλεση οπωσδήποτε" — μόνο για πρόγραμμα εγκατάστασης που κατέβασες από το keebye.com.

Στα Windows η υπαγόρευση δεν ηχογραφεί τίποτα

Τα Windows μπορεί να μπλοκάρουν την πρόσβαση στο μικρόφωνο για εφαρμογές υπολογιστή. Άνοιξε Settings › Privacy & security › Microphone, επίτρεψε στις εφαρμογές υπολογιστή να χρησιμοποιούν το μικρόφωνο και έλεγξε ότι έχει επιλεγεί η σωστή συσκευή εισόδου.

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

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