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

Pereiti prie dokumentacijos turinio
Keebye dokumentacija

Nesklandumų sprendimas

Ką reiškia kiekvienas Keebye rodomas pranešimas ir kaip jį išspręsti, taip pat kaip viską atstatyti.

Dauguma problemų kyla dėl prieigos, dingusio modelio arba pristabdyto diktavimo. Pradėk nuo greitų patikrinimų, tada žemiau rask savo pranešimą.

Spartusis klavišas nieko nedaro? Pirmiausia patikrink šiuos dalykus

  1. Meniu juostos meniu pažymėta "Enable Dictation".
  2. Esi prisijungęs ir bandomasis laikotarpis nesibaigė (Settings › Account).
  3. Mac kompiuteryje Accessibility suteikta System Settings › Privacy & Security › Accessibility.
  4. Mac kompiuteryje neaktyvi jokia saugi įvestis — pavyzdžiui, Secure Keyboard Entry Terminal programoje arba fokusuotas slaptažodžio laukas.

Pranešimai ir ką jie reiškia

"Accessibility permission was revoked — reopen System Settings"

Prasidedant įrašymui nebuvo Accessibility patikimumo. Atverk System Settings › Privacy & Security › Accessibility ir įjunk Keebye. Keebye iš naujo paruošia spartųjį klavišą per 2 sekundes.

"Failed to start the global hotkey listener"

macOS atmetė įvykių gaudymą. Suteik Accessibility prieigą, tada Settings vėl pasirink savo klavišą.

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

Sparčiojo klavišo pakeitimas buvo atmestas. Suteik Accessibility prieigą ir vėl pasirink klavišą; iki tol Keebye toliau naudoja ankstesnį klavišą.

"Microphone capture failed: <error>"

Nėra numatytojo įvesties įrenginio arba nepavyko garso srautas. Patikrink įvesties įrenginį garso nustatymuose (Mac kompiuteryje System Settings › Sound) ir ar suteikta Microphone prieiga.

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

Pasirinkto modelio nėra diske arba jis dar neįkeltas. Palauk, kol piliulė paliks atsisiuntimo būseną, arba paspausk "Download model" Settings › Speech engine.

"Model download failed — reopen Keebye to retry"

Nepavyko penkios atsisiuntimo pastangos (tinklas, HTTP klaida arba nesutampanti kontrolinė suma). Užverk ir vėl atverk Keebye; atsisiuntimas tęsiamas nuo tos vietos, kur nutrūko.

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

Pasirinktas Native (Apple Speech) variklis be leidimo. Suteik Speech Recognition prieigą arba persijunk į Parakeet ar Canary.

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

Native variklio nesklandumai. Gali reikėti per System Settings › Keyboard › Dictation įdiegti įrenginyje veikiantį kalbos modelį; kitaip kalbėk per 15 sekundžių arba pakeisk variklį.

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

Fokusuotas slaptažodžio laukas arba programoje įjungtas Secure Keyboard Entry (pavyzdžiui, Terminal). Spustelėk įprastą teksto lauką arba išjunk Secure Keyboard Entry. Taip yra sąmoningai.

"Text left on clipboard — paste manually"

Nepavyko sugeneruoti ⌘V (Windows sistemoje Ctrl+V) arba klavišų paspaudimų. Transkripcija yra tavo iškarpinėje; įklijuok ją pats.

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

Sesijos vykdymo procesas atsigavo po avarijos. Padiktuok dar kartą.

Įvado langas vėl atsivėrė po atnaujinimo arba pakartotinio diegimo (Mac)

Pasenęs Accessibility leidimas. Pašalink Keebye iš System Settings › Privacy & Security › Accessibility mygtuku −, įtrauk jį atgal ir įjunk.

Windows SmartScreen rodo "Windows protected your PC"

Windows diegimo programa dar nepasirašyta kodo parašu. Pasirink More info, tada Run anyway — tik jei diegimo programą atsisiuntei iš keebye.com.

Windows sistemoje diktavimas nieko neįrašo

Windows gali blokuoti darbalaukio programų prieigą prie mikrofono. Atverk Settings › Privacy & security › Microphone, leisk darbalaukio programoms naudoti mikrofoną ir patikrink, ar pasirinktas tinkamas įvesties įrenginys.

Keebye atstatymas

Užverk Keebye, ištrink settings.json (Mac kompiuteryje — kataloge ~/Library/Application Support/com.keebye.app/, Windows sistemoje — %APPDATA%\com.keebye.app\) ir pašalink išsaugotus prisijungimo duomenis paslaugai com.keebye.app, paskyrai auth, iš macOS Keychain arba Windows Credential Manager. Paleisk iš naujo — įvadas prasidės nuo pradžių. Diagnostika rašoma tik į stderr.