Rozwiązywanie problemów
Co znaczy każdy komunikat Keebye i jak go naprawić, a także jak przywrócić stan początkowy.
Większość problemów sprowadza się do uprawnienia, brakującego modelu albo wstrzymanego dyktowania. Zacznij od szybkich sprawdzeń, a potem znajdź swój komunikat poniżej.
Klawisz nic nie robi? Sprawdź to najpierw
- "Enable Dictation" jest zaznaczone w menu w pasku menu.
- Jesteś zalogowany, a okres próbny się nie skończył (Settings › Account).
- Dostępność jest nadana w Ustawieniach systemowych › Prywatność i ochrona › Dostępność.
- Nie jest aktywne zabezpieczone wprowadzanie — na przykład Secure Keyboard Entry w Terminalu albo pole hasła z fokusem.
Komunikaty i ich znaczenie
"Accessibility permission was revoked — reopen System Settings"
Przy starcie nagrywania brakowało zaufania w Dostępności. Otwórz Ustawienia systemowe › Prywatność i ochrona › Dostępność i włącz Keebye. Keebye uzbroi klawisz ponownie w ciągu 2 sekund.
"Failed to start the global hotkey listener"
macOS odmówił utworzenia event tapa. Nadaj dostęp w Dostępności, a potem wybierz swój klawisz jeszcze raz w Settings.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." albo "Could not switch to <Key>; still using <Key>."
Zmiana klawisza została odrzucona. Nadaj dostęp w Dostępności i wybierz klawisz ponownie; do tego czasu Keebye korzysta z poprzedniego klawisza.
"Microphone capture failed: <error>"
Nie ma domyślnego urządzenia wejściowego albo strumień audio się nie udał. Sprawdź urządzenie wejściowe w Ustawieniach systemowych › Dźwięk oraz to, czy dostęp do mikrofonu jest nadany.
"Speech model still setting up — try again in a moment"
Wybrany model nie jest na dysku albo jeszcze się nie wczytał. Poczekaj, aż pigułka wyjdzie ze stanu pobierania, albo naciśnij "Download model" w Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Pięć próśb o pobranie zakończyło się niepowodzeniem (sieć, błąd HTTP albo niezgodna suma kontrolna). Zamknij i otwórz Keebye ponownie; pobieranie wznowi się od miejsca, w którym stanęło.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
Wybrany jest silnik Native (Apple Speech), a nie ma uprawnienia. Nadaj Rozpoznawanie mowy albo przełącz się na Parakeet lub Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" albo "Apple Speech timed out after 15s"
Problemy silnika Native. Model językowy działający lokalnie może wymagać instalacji przez Ustawienia systemowe › Klawiatura › Dyktowanie; w innym razie zacznij mówić w ciągu 15 sekund albo zmień silnik.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" albo "Couldn't insert: A password field is focused — dictation is blocked"
Fokus ma pole hasła albo któraś aplikacja ma włączone Secure Keyboard Entry (na przykład Terminal). Kliknij w zwykłe pole tekstowe albo wyłącz Secure Keyboard Entry. Tak ma być.
"Text left on clipboard — paste manually"
Symulacja ⌘V albo naciśnięć klawiszy się nie udała. Transkrypcja jest w schowku; naciśnij ⌘V samodzielnie.
"Dictation hit an internal error and was reset. Please try again."
Proces obsługujący sesję podniósł się po awarii. Podyktuj jeszcze raz.
Okno wdrożenia otworzyło się ponownie po aktualizacji albo reinstalacji
Nieaktualne zaufanie w Dostępności. Usuń Keebye z Ustawień systemowych › Prywatność i ochrona › Dostępność przyciskiem −, dodaj go z powrotem i włącz.
Reset Keebye
Zamknij Keebye, usuń ~/Library/Application Support/com.keebye.app/settings.json i usuń wpis Keychaina dla usługi com.keebye.app, konto auth. Uruchom aplikację ponownie — wdrożenie zacznie się od nowa. Diagnostyka trafia wyłącznie na stderr.