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

Siirry dokumentaation sisältöön
Keebye Docs

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ä

  1. "Enable Dictation" on valittuna valikkopalkin valikossa.
  2. Olet kirjautunut sisään eikä kokeilu ole päättynyt (Settings › Account).
  3. Macilla Accessibility on myönnetty kohdassa System Settings › Privacy & Security › Accessibility.
  4. Macilla 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 ääniasetuksista (Macilla 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 (Windowsissa Ctrl+V:n) tai näppäinpainallusten syntetisointi epäonnistui. Litterointi on leikepöydälläsi; liitä se 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 (Mac)

Vanhentunut Accessibility-oikeus. Poista Keebye kohdasta System Settings › Privacy & Security › Accessibility −-painikkeella, lisää se takaisin ja kytke se päälle.

Windows SmartScreen näyttää ilmoituksen "Windows suojasi tietokonettasi"

Windows-asennusohjelmaa ei ole vielä allekirjoitettu koodiallekirjoituksella. Valitse Lisätietoja ja sitten Suorita silti — mutta vain, jos latasit asennusohjelman osoitteesta keebye.com.

Sanelu ei tallenna Windowsissa mitään

Windows saattaa estää työpöytäsovelluksia käyttämästä mikrofonia. Avaa Settings › Privacy & security › Microphone, salli työpöytäsovellusten käyttää mikrofonia ja tarkista, että oikea syöttölaite on valittuna.

Keebyen nollaus

Sulje Keebye, poista settings.json (Macilla hakemistossa ~/Library/Application Support/com.keebye.app/, Windowsissa hakemistossa %APPDATA%\com.keebye.app\) ja poista tallennettu tunnistetieto palvelulle com.keebye.app, tili auth, macOS:n avainnipusta tai Windowsin Tunnistetietojen hallinnasta. Käynnistä sovellus uudelleen, niin käyttöönotto alkaa alusta. Diagnostiikka menee vain stderriin.