Prejsť na obsah dokumentácie
Keebye Docs

Riešenie problémov

Čo znamená každá správa, ktorú Keebye zobrazuje, ako ju vyriešiť a ako urobiť reset.

Väčšina problémov sa dá vysvetliť povolením, chýbajúcim modelom alebo pozastaveným diktovaním. Začnite rýchlymi kontrolami, potom si nižšie nájdite svoju správu.

Hotkey nič nerobí? Skontrolujte najskôr toto

  1. "Enable Dictation" je v ponuke v lište zaškrtnuté.
  2. Ste prihlásení a skúšobná verzia neskončila (Nastavenia › Account).
  3. Prístupnosť je udelená v Nastaveniach systému › Súkromie a bezpečnosť › Prístupnosť.
  4. Nie je aktívny zabezpečený vstup — napríklad Secure Keyboard Entry v Termináli alebo pole s heslom, ktoré má fokus.

Správy a čo znamenajú

"Accessibility permission was revoked — reopen System Settings"

Pri štarte nahrávania chýbalo povolenie Prístupnosť. Otvorte Nastavenia systému › Súkromie a bezpečnosť › Prístupnosť a zapnite Keebye. Keebye hotkey znovu aktivuje do 2 sekúnd.

"Failed to start the global hotkey listener"

macOS odmietol event tap. Udeľte prístup k Prístupnosti a potom v Nastaveniach znovu zvoľte svoju klávesu.

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

Zmena klávesy bola odmietnutá. Udeľte prístup k Prístupnosti a klávesu zvoľte znovu; dovtedy Keebye používa predchádzajúcu klávesu.

"Microphone capture failed: <error>"

Nie je nastavené predvolené vstupné zariadenie alebo zlyhal zvukový stream. Skontrolujte vstupné zariadenie v Nastaveniach systému › Zvuk a to, že je udelený prístup k mikrofónu.

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

Zvolený model nie je na disku alebo sa ešte nedonačítal. Počkajte, kým pilulka opustí stav sťahovania, alebo stlačte "Download model" v Nastaveniach › Speech engine.

"Model download failed — reopen Keebye to retry"

Päť pokusov o stiahnutie zlyhalo (sieť, chyba HTTP alebo nezhoda kontrolného súčtu). Ukončite Keebye a spustite ho znovu; sťahovanie bude pokračovať od miesta, kde skončilo.

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

Je zvolený engine Native (Apple Speech) bez udeleného povolenia. Udeľte Rozpoznávanie reči, alebo prepnite na Parakeet či Canary.

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

Problémy s natívnym enginom. Môže byť potrebné doinštalovať jazykový model na rozpoznávanie na zariadení cez Nastavenia systému › Klávesnica › Diktovanie; inak hovorte do 15 sekúnd alebo prepnite engine.

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

Fokus má pole s heslom alebo má niektorá aplikácia zapnutý Secure Keyboard Entry (napríklad Terminál). Kliknite do bežného textového poľa alebo Secure Keyboard Entry vypnite. Je to zámer.

"Text left on clipboard — paste manually"

Syntéza ⌘V alebo stlačení klávesov zlyhala. Prepis máte v schránke; stlačte ⌘V sami.

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

Pracovný proces relácie sa zotavil z pádu. Nadiktujte to znovu.

Okno onboardingu sa po aktualizácii alebo preinštalovaní otvorilo znovu

Zastarané udelenie Prístupnosti. Odstráňte Keebye z Nastavení systému › Súkromie a bezpečnosť › Prístupnosť tlačidlom −, pridajte ho späť a zapnite.

Reset Keebye

Ukončite Keebye, vymažte ~/Library/Application Support/com.keebye.app/settings.json a odstráňte položku Kľúčenky pre službu com.keebye.app, účet auth. Po opätovnom spustení sa onboarding začne znovu. Diagnostika ide len na stderr.