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

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

Υπαγόρευση

Το πλήκτρο push-to-talk, κράτημα ή πάτημα, τι δείχνει η κάψουλα, πώς εισάγεται το κείμενο και πού αρνείται να γράψει το Keebye.

Πάτα το πλήκτρο push-to-talk, μίλα, άφησέ το. Η μεταγραφή τρέχει πάνω σε ολόκληρη την εκφορά αφού αφήσεις το πλήκτρο, και το κείμενο εισάγεται σε όποια εφαρμογή είναι μπροστά.

Το πλήκτρο push-to-talk

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Οι αλλαγές ισχύουν άμεσα.

  • Fn / Globe (δεξί Ctrl στα Windows)
  • Αριστερό ⌘ (αριστερό πλήκτρο Windows στα Windows)
  • Δεξί ⌘, η προεπιλογή (δεξί πλήκτρο Windows στα Windows)
  • Αριστερό ⌥ (αριστερό Alt στα Windows)
  • Δεξί ⌥ (δεξί Alt στα Windows)

Κράτημα ή πάτημα

  • Το πάτημα του πλήκτρου ξεκινά αμέσως την εγγραφή.
  • Άφησέ το στα 400 ms ή αργότερα: κράτημα για ομιλία. Η εγγραφή σταματά και το κείμενο εισάγεται.
  • Άφησέ το πριν τα 400 ms: πάτημα. Η εγγραφή μένει ανοιχτή. Ένα δεύτερο πάτημα σταματά και εισάγει.
  • Το Esc ακυρώνει μια εγγραφή σε εξέλιξη. Δεν εισάγεται τίποτα.
  • Μια μεμονωμένη εκφορά έχει όριο 300 δευτερόλεπτα (5 λεπτά)· μετά σταματά και εισάγεται αυτόματα.

Η κάψουλα

Η κάψουλα είναι ένα μικρό πάνελ που φαίνεται πάντα, αφήνει τα κλικ να περάσουν και κάθεται κάτω-κέντρο στην κύρια οθόνη σου, 96 pt πάνω από την κάτω άκρη. Σε Mac εμφανίζεται σε όλα τα Spaces και δεν παίρνει ποτέ το focus.

  • Σε ηρεμία: ένα εικονίδιο μικροφώνου.
  • "Downloading speech model… NN%" όσο κατεβαίνει ένα μοντέλο, ή "Model download failed — reopen Keebye to retry".
  • "Listening…" → "Transcribing…" → "Inserting…" κατά την υπαγόρευση.
  • Σύντομα μηνύματα για περίπου 2,6 δευτερόλεπτα: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" ή "Dictation paused: secure input on (<App>)".

Πώς εισάγεται το κείμενο

Επικόλληση (γρήγορη), η προεπιλογή: το Keebye κρατά στιγμιότυπο του πρόχειρου, γράφει τη μεταγραφή, συνθέτει ⌘V (Ctrl+V στα Windows) και μετά από 250 ms επαναφέρει το προηγούμενο πρόχειρο, αν ανήκει ακόμη στο Keebye. Σε Mac η μεταγραφή είναι προσωρινό στοιχείο πρόχειρου που οι διαχειριστές πρόχειρου προσπερνούν· στα Windows επαναφέρεται μόνο απλό κείμενο. Το "Restore clipboard after paste" είναι ενεργό από προεπιλογή.

Στα Terminal.app, iTerm2, Warp, WezTerm και kitty σε Mac, και στα Windows Terminal, Command Prompt και PowerShell στα Windows, η επικόλληση σπάει σε τμήματα έως 2000 bytes με κενά 50 ms.

Πληκτρολόγηση (τερματικά / SSH / κάθε διάταξη): το Keebye στέλνει πλήκτρα Unicode χωρίς να αγγίξει το πρόχειρο, σε Mac σε τμήματα 16 χαρακτήρων, ανά 4 ms. Είναι ανεξάρτητη από τη διάταξη και δουλεύει μέσω SSH και tmux. Αν η πληκτρολόγηση αποτύχει, το κείμενο πάει στο πρόχειρο και η κάψουλα δείχνει "Text left on clipboard — paste manually".

Πεδία κωδικού και secure input

Σε Mac, αν το secure input είναι ενεργό, ή το εστιασμένο στοιχείο είναι πεδίο κωδικού, το Keebye δεν γράφει τίποτα στο πρόχειρο και δείχνει "Couldn't insert: Secure input is active (<App>) — dictation is blocked" ή "Couldn't insert: A password field is focused — dictation is blocked". Τέτοιες υπαγορεύσεις δεν αποθηκεύονται ποτέ στο ιστορικό. Ένας έλεγχος κάθε 5 δευτερόλεπτα προειδοποιεί επίσης "Dictation paused: secure input on (<App>)" όσο το secure input παραμένει ενεργό.

Το ζεστό μικρόφωνο

Η ροή του μικροφώνου ξεκινά στην πρώτη σου υπαγόρευση και μετά μένει ανοιχτή για όλη τη ζωή της εφαρμογής, γι' αυτό και η ένδειξη χρήσης μικροφώνου του συστήματός σου μένει αναμμένη μετά την πρώτη χρήση. Στην αρχή κάθε εκφοράς μπαίνει ένα κυλιόμενο προ-διάστημα 500 ms. Η πρώτη υπαγόρευση μιας συνεδρίας μπορεί και πάλι να πληρώσει την καθυστέρηση εκκίνησης της ροής, και λέξεις που ειπώθηκαν πριν από αυτό το διάστημα των 500 ms μπορεί και πάλι να κοπούν. Ο ήχος μετατρέπεται σε 16 kHz mono και μια αλλαγή συσκευής εντοπίζεται μέσα σε ένα δευτερόλεπτο.