Řešení potíží
Co znamená každá zpráva, kterou Keebye zobrazuje, jak ji vyřešit a jak provést reset.
Většina potíží se dá vysvětlit oprávněním, chybějícím modelem nebo pozastaveným diktováním. Začněte rychlými kontrolami, pak si níže najděte svou zprávu.
Klávesa nic nedělá? Zkontrolujte nejdřív tohle
- "Enable Dictation" je v nabídce v liště zaškrtnuté.
- Jste přihlášení a zkušební verze neskončila (Nastavení › Account).
- Zpřístupnění je udělené v Nastavení systému › Soukromí a zabezpečení › Zpřístupnění.
- Není aktivní zabezpečený vstup — například Secure Keyboard Entry v Terminálu nebo pole s heslem, které má fokus.
Zprávy a co znamenají
"Accessibility permission was revoked — reopen System Settings"
Při startu nahrávání chybělo oprávnění Zpřístupnění. Otevřete Nastavení systému › Soukromí a zabezpečení › Zpřístupnění a zapněte Keebye. Keebye klávesu znovu aktivuje do 2 sekund.
"Failed to start the global hotkey listener"
macOS odmítl event tap. Udělte přístup ke Zpřístupnění a pak v Nastavení znovu zvolte svou klávesu.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." nebo "Could not switch to <Key>; still using <Key>."
Změna klávesy byla odmítnuta. Udělte přístup ke Zpřístupnění a klávesu zvolte znovu; do té doby Keebye používá předchozí klávesu.
"Microphone capture failed: <error>"
Není nastavené výchozí vstupní zařízení nebo selhal zvukový stream. Zkontrolujte vstupní zařízení v Nastavení systému › Zvuk a to, že je udělený přístup k mikrofonu.
"Speech model still setting up — try again in a moment"
Zvolený model není na disku nebo se ještě nedonačetl. Počkejte, až pilulka opustí stav stahování, nebo stiskněte "Download model" v Nastavení › Speech engine.
"Model download failed — reopen Keebye to retry"
Pět pokusů o stažení selhalo (síť, chyba HTTP nebo neshoda kontrolního součtu). Ukončete Keebye a spusťte ho znovu; stahování bude pokračovat od místa, kde skončilo.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
Je zvolený engine Native (Apple Speech) bez uděleného oprávnění. Udělte Rozpoznávání řeči, nebo přepněte na Parakeet či Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" nebo "Apple Speech timed out after 15s"
Potíže s nativním enginem. Může být potřeba doinstalovat jazykový model pro rozpoznávání na zařízení přes Nastavení systému › Klávesnice › Diktování; jinak mluvte do 15 sekund nebo přepněte engine.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" nebo "Couldn't insert: A password field is focused — dictation is blocked"
Fokus má pole s heslem nebo má nějaká aplikace zapnutý Secure Keyboard Entry (například Terminál). Klikněte do běžného textového pole nebo Secure Keyboard Entry vypněte. Je to záměr.
"Text left on clipboard — paste manually"
Syntéza ⌘V nebo stisků kláves selhala. Přepis máte ve schránce; stiskněte ⌘V sami.
"Dictation hit an internal error and was reset. Please try again."
Pracovní proces relace se zotavil z pádu. Nadiktujte to znovu.
Okno onboardingu se po aktualizaci nebo přeinstalaci otevřelo znovu
Zastaralé udělení Zpřístupnění. Odeberte Keebye z Nastavení systému › Soukromí a zabezpečení › Zpřístupnění tlačítkem −, přidejte ho zpět a zapněte.
Reset Keebye
Ukončete Keebye, smažte ~/Library/Application Support/com.keebye.app/settings.json a odstraňte položku Klíčenky pro službu com.keebye.app, účet auth. Po opětovném spuštění začne onboarding znovu. Diagnostika jde jen na stderr.