Penyelesaian masalah

Maksud setiap mesej yang ditunjukkan Keebye dan cara membetulkannya, serta cara menetapkan semula aplikasi.

Kebanyakan masalah berpunca daripada sesuatu kebenaran, model yang belum ada, atau imlak yang sedang dijeda. Mulakan dengan semakan pantas, kemudian cari mesej anda di bawah.

Hotkey tidak berfungsi? Semak ini dahulu

"Enable Dictation" ditanda dalam menu tray.
Anda telah log masuk dan percubaan belum tamat (Settings › Account).
Accessibility telah diberikan dalam System Settings › Privacy & Security › Accessibility.
Tiada input selamat yang aktif — contohnya Secure Keyboard Entry dalam Terminal, atau medan kata laluan yang sedang fokus.

Mesej dan maksudnya

"Accessibility permission was revoked — reopen System Settings"

Kepercayaan Accessibility hilang apabila rakaman bermula. Buka System Settings › Privacy & Security › Accessibility dan hidupkan Keebye. Keebye menyiagakan semula hotkey dalam masa 2 saat.

"Failed to start the global hotkey listener"

macOS menolak event tap. Berikan akses Accessibility, kemudian pilih kekunci anda sekali lagi dalam Settings.

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

Perubahan hotkey ditolak. Berikan akses Accessibility dan pilih kekunci itu sekali lagi; sehingga itu Keebye terus menggunakan kekunci yang terdahulu.

"Microphone capture failed: <error>"

Tiada peranti input lalai atau stream audionya gagal. Semak peranti input dalam System Settings › Sound dan pastikan akses Microphone telah diberikan.

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

Model yang dipilih tiada pada cakera atau belum selesai dimuatkan. Tunggu sehingga pill meninggalkan keadaan muat turun, atau tekan "Download model" dalam Settings › Speech engine.

"Model download failed — reopen Keebye to retry"

Lima percubaan muat turun telah gagal (rangkaian, ralat HTTP, atau checksum tidak sepadan). Tutup dan buka semula Keebye; muat turun disambung dari tempat ia berhenti.

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

Enjin Native (Apple Speech) dipilih tanpa kebenaran. Berikan Speech Recognition, atau tukar kepada Parakeet atau Canary.

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

Masalah enjin Native. Model bahasa on-device-nya mungkin perlu dipasang melalui System Settings › Keyboard › Dictation; jika tidak, bercakap dalam masa 15 saat atau tukar enjin.

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

Sesuatu medan kata laluan sedang fokus atau ada aplikasi yang menghidupkan Secure Keyboard Entry (Terminal, contohnya). Klik ke dalam medan teks biasa atau matikan Secure Keyboard Entry. Ini memang direka begitu.

"Text left on clipboard — paste manually"

Mensintesis ⌘V atau ketikan kekunci itu gagal. Transkripnya ada pada clipboard anda; tekan ⌘V sendiri.

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

Worker sesi pulih daripada satu crash. Imlakkan semula.

Tetingkap onboarding terbuka semula selepas kemas kini atau pemasangan semula

Kebenaran Accessibility yang sudah lapuk. Buang Keebye daripada System Settings › Privacy & Security › Accessibility dengan butang −, tambah semula, dan hidupkannya.

Tetapkan semula Keebye

Tutup Keebye, padam ~/Library/Application Support/com.keebye.app/settings.json, dan buang item Keychain untuk service com.keebye.app, account auth. Lancarkan semula dan onboarding akan bermula lagi. Diagnostik keluar ke stderr sahaja.