Vianmääritys
Mitä Keebyen näyttämät ilmoitukset tarkoittavat ja miten ne korjataan, sekä miten teet nollauksen.
Useimmat ongelmat johtuvat oikeudesta, puuttuvasta mallista tai siitä, että sanelu on tauolla. Aloita pikatarkistuksista ja etsi sitten oma ilmoituksesi alta.
Eikö pikanäppäin tee mitään? Tarkista ensin nämä
- "Enable Dictation" on valittuna valikkopalkin valikossa.
- Olet kirjautunut sisään eikä kokeilu ole päättynyt (Settings › Account).
- Accessibility on myönnetty kohdassa System Settings › Privacy & Security › Accessibility.
- Mikään suojattu syöttö ei ole aktiivinen — esimerkiksi Secure Keyboard Entry Terminalissa tai fokusoitu salasanakenttä.
Ilmoitukset ja niiden merkitys
"Accessibility permission was revoked — reopen System Settings"
Accessibility-luottamus puuttui, kun tallennus alkoi. Avaa System Settings › Privacy & Security › Accessibility ja kytke Keebye päälle. Keebye aktivoi pikanäppäimen uudelleen 2 sekunnin sisällä.
"Failed to start the global hotkey listener"
macOS kieltäytyi tapahtumakuuntelijasta. Myönnä Accessibility-oikeus ja valitse näppäin uudelleen Settings-ikkunassa.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." tai "Could not switch to <Key>; still using <Key>."
Pikanäppäimen vaihto estettiin. Myönnä Accessibility-oikeus ja valitse näppäin uudelleen; siihen asti Keebye käyttää edellistä näppäintä.
"Microphone capture failed: <error>"
Oletussyöttölaitetta ei ole tai äänivirta epäonnistui. Tarkista syöttölaite kohdassa System Settings › Sound ja se, että mikrofonin oikeus on myönnetty.
"Speech model still setting up — try again in a moment"
Valittu malli ei ole levyllä tai sen lataus muistiin on kesken. Odota, kunnes pilleri poistuu lataustilasta, tai paina "Download model" kohdassa Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Viisi latausyritystä epäonnistui (verkko, HTTP-virhe tai tarkistussumman ristiriita). Sulje Keebye ja avaa se uudelleen; lataus jatkuu siitä, mihin se pysähtyi.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
Moottori Native (Apple Speech) on valittuna ilman oikeutta. Myönnä Speech Recognition -oikeus tai vaihda Parakeetiin tai Canaryyn.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" tai "Apple Speech timed out after 15s"
Native-moottorin ongelmia. Laitteella toimiva kielimalli voi vaatia asennuksen kohdassa System Settings › Keyboard › Dictation; muussa tapauksessa puhu 15 sekunnin sisällä tai vaihda moottoria.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" tai "Couldn't insert: A password field is focused — dictation is blocked"
Salasanakenttä on fokusoitu tai sovelluksessa on Secure Keyboard Entry päällä (esimerkiksi Terminal). Napsauta tavalliseen tekstikenttään tai kytke Secure Keyboard Entry pois. Tämä on tarkoituksellista.
"Text left on clipboard — paste manually"
⌘V:n tai näppäinpainallusten syntetisointi epäonnistui. Litterointi on leikepöydälläsi; paina ⌘V itse.
"Dictation hit an internal error and was reset. Please try again."
Istunnon työprosessi toipui kaatumisesta. Sanele uudelleen.
Käyttöönottoikkuna avautui uudelleen päivityksen tai uudelleenasennuksen jälkeen
Vanhentunut Accessibility-oikeus. Poista Keebye kohdasta System Settings › Privacy & Security › Accessibility −-painikkeella, lisää se takaisin ja kytke se päälle.
Keebyen nollaus
Sulje Keebye, poista tiedosto ~/Library/Application Support/com.keebye.app/settings.json ja poista avainnipun kohde palvelulle com.keebye.app, tili auth. Käynnistä sovellus uudelleen, niin käyttöönotto alkaa alusta. Diagnostiikka menee vain stderriin.