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

Přejít na obsah dokumentace
Keebye Docs

Ř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

  1. "Enable Dictation" je v nabídce v liště zaškrtnuté.
  2. Jste přihlášení a zkušební verze neskončila (Nastavení › Account).
  3. Na Macu je Zpřístupnění udělené v Nastavení systému › Soukromí a zabezpečení › Zpřístupnění.
  4. Na Macu 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í zvuku (na Macu 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 (na Windows Ctrl+V) nebo stisků kláves selhala. Přepis máte ve schránce; vložte ho 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 (Mac)

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.

Windows SmartScreen hlásí "Systém Windows ochránil váš počítač"

Instalátor pro Windows zatím není podepsaný certifikátem. Zvolte Další informace a pak Přesto spustit — ale jen u instalátoru staženého z keebye.com.

Na Windows diktování nic nenahraje

Windows možná desktopovým aplikacím blokují přístup k mikrofonu. Otevřete Nastavení › Ochrana osobních údajů a zabezpečení › Mikrofon, povolte desktopovým aplikacím přístup k mikrofonu a zkontrolujte, že je vybrané správné vstupní zařízení.

Reset Keebye

Ukončete Keebye, smažte settings.json (na Macu v ~/Library/Application Support/com.keebye.app/, na Windows v %APPDATA%\com.keebye.app\) a odstraňte uložené pověření pro službu com.keebye.app, účet auth, z Klíčenky macOS nebo ze Správce pověření systému Windows. Po opětovném spuštění začne onboarding znovu. Diagnostika jde jen na stderr.