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

Към съдържанието на документацията
Документация на Keebye

Диктуване

Клавишът за 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 минути), след което записът спира и текстът се вмъква автоматично.

Индикаторът (pill)

Индикаторът е малък, винаги видим панел, през който щракванията минават, разположен долу в средата на основния ви екран, на 96 pt над долния край. На Mac се появява във всички Spaces и никога не взема фокуса.

  • В покой: символ на микрофон.
  • "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>)".

Как се вмъква текстът

Paste (fast), по подразбиране: 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 байта с интервали от 50 ms.

Typing (terminals / SSH / any layout): Keebye изпраща Unicode натискания на клавиши, без да докосва клипборда, като на Mac ги праща на части от 16 знака през 4 ms. Не зависи от клавиатурната подредба и работи през SSH и tmux. Ако писането се провали, текстът остава в клипборда и индикаторът показва "Text left on clipboard — paste manually".

Полета за пароли и защитено въвеждане

На Mac, ако защитеното въвеждане е включено или елементът на фокус е поле за парола, 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>)", докато защитеното въвеждане остава включено.

Загретият микрофон

Микрофонният вход се включва при първата ви диктовка и след това остава активен, докато приложението работи, затова системният индикатор за използван микрофон остава включен след първата употреба. В началото на всяко изказване се добавя плъзгащ буфер от 500 ms. Първата диктовка в дадена сесия пак може да плати забавянето при стартиране на входа, а думи, изречени преди този буфер от 500 ms, пак могат да се отрежат. Звукът се преобразува към 16 kHz моно, а смяна на устройството се засича в рамките на секунда.