Hibaelhárítás
Mit jelent a Keebye egyes üzenete, hogyan javítható, és hogyan állítható vissza az alapállapot.
A legtöbb probléma egy engedélyre, egy hiányzó modellre vagy a felfüggesztett diktálásra vezethető vissza. Kezdd a gyors ellenőrzésekkel, majd keresd meg lentebb a saját üzenetedet.
A hotkey nem tesz semmit? Ellenőrizd először ezeket
- Az "Enable Dictation" be van pipálva a menüsormenüben.
- Be vagy jelentkezve, és a próba nem járt le (Settings › Account).
- Az Accessibility meg van adva a System Settings › Privacy & Security › Accessibility alatt.
- Nem aktív biztonságos bevitel — például a Secure Keyboard Entry a Terminalban, vagy egy fókuszban lévő jelszómező.
Üzenetek és jelentésük
"Accessibility permission was revoked — reopen System Settings"
A felvétel indulásakor hiányzott az Accessibility-jogosultság. Nyisd meg a System Settings › Privacy & Security › Accessibility panelt, és kapcsold be a Keebye-t. A Keebye 2 másodpercen belül újraélesíti a hotkey-t.
"Failed to start the global hotkey listener"
A macOS visszautasította az event tapot. Adj Accessibility-engedélyt, majd válaszd ki újra a billentyűt a Settingsben.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." vagy "Could not switch to <Key>; still using <Key>."
A hotkey módosítását visszautasította a rendszer. Adj Accessibility-engedélyt, és válaszd ki újra a billentyűt; addig a Keebye a korábbi billentyűt használja.
"Microphone capture failed: <error>"
Nincs alapértelmezett bemeneti eszköz, vagy a hangfolyam elhalt. Ellenőrizd a bemeneti eszközt a System Settings › Sound alatt, és hogy megvan-e a mikrofon-engedély.
"Speech model still setting up — try again in a moment"
A kiválasztott modell nincs a lemezen, vagy még nem töltődött be. Várd meg, míg a buborék kilép a letöltési állapotból, vagy nyomd meg a "Download model" gombot a Settings › Speech engine alatt.
"Model download failed — reopen Keebye to retry"
Öt letöltési kísérlet hiúsult meg (hálózat, HTTP-hiba vagy ellenőrzőösszeg-eltérés). Lépj ki a Keebye-ból, és indítsd el újra; a letöltés onnan folytatódik, ahol megállt.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
A Native (Apple Speech) motor van kiválasztva engedély nélkül. Adj Speech Recognition engedélyt, vagy válts Parakeetre vagy Canaryra.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" vagy "Apple Speech timed out after 15s"
A Native motor gondjai. Az eszközön futó nyelvi modellt esetleg telepíteni kell a System Settings › Keyboard › Dictation alatt; egyébként beszélj 15 másodpercen belül, vagy válts motort.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" vagy "Couldn't insert: A password field is focused — dictation is blocked"
Jelszómező van fókuszban, vagy egy appban be van kapcsolva a Secure Keyboard Entry (például a Terminalban). Kattints egy normál szövegmezőbe, vagy kapcsold ki a Secure Keyboard Entryt. Ez szándékos.
"Text left on clipboard — paste manually"
A ⌘V vagy a leütések szintetizálása nem sikerült. Az átirat a vágólapodon van; nyomd meg te a ⌘V-t.
"Dictation hit an internal error and was reset. Please try again."
A munkamenet-futtató összeomlás után visszaállt. Diktálj újra.
Az onboarding-ablak egy frissítés vagy újratelepítés után újra megnyílt
Elavult Accessibility-jogosultság. Vedd ki a Keebye-t a System Settings › Privacy & Security › Accessibility listából a − gombbal, add vissza, és kapcsold be.
A Keebye visszaállítása
Lépj ki a Keebye-ból, töröld a ~/Library/Application Support/com.keebye.app/settings.json fájlt, és távolítsd el a Keychain-elemet a com.keebye.app service-hez, auth fiókkal. Indítsd újra, és az onboarding elölről kezdődik. A diagnosztika csak a stderrre megy.