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

Langkau ke kandungan dokumentasi
Keebye Docs

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

  1. "Enable Dictation" ditanda dalam menu tray.
  2. Anda telah log masuk dan percubaan belum tamat (Settings › Account).
  3. Pada Mac, Accessibility telah diberikan dalam System Settings › Privacy & Security › Accessibility.
  4. Pada Mac, 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 tetapan bunyi anda (System Settings › Sound pada Mac) 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 (Ctrl+V pada Windows) atau ketikan kekunci itu gagal. Transkripnya ada pada clipboard anda; tampalkannya 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 (Mac)

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

Windows SmartScreen menunjukkan "Windows protected your PC"

Pemasang Windows belum ditandatangani kod. Pilih More info, kemudian Run anyway — hanya untuk pemasang yang anda muat turun dari keebye.com.

Pada Windows, imlak tidak merakam apa-apa

Windows mungkin menyekat akses mikrofon untuk aplikasi desktop. Buka Settings › Privacy & security › Microphone, benarkan aplikasi desktop menggunakan mikrofon, dan semak bahawa peranti input yang betul dipilih.

Tetapkan semula Keebye

Tutup Keebye, padam settings.json (dalam ~/Library/Application Support/com.keebye.app/ pada Mac, %APPDATA%\com.keebye.app\ pada Windows), dan buang kelayakan tersimpan untuk service com.keebye.app, account auth, daripada Keychain macOS atau Windows Credential Manager. Lancarkan semula dan onboarding akan bermula lagi. Diagnostik keluar ke stderr sahaja.