Lewati ke konten dokumentasi
Keebye Docs

Pemecahan masalah

Arti setiap pesan yang ditampilkan Keebye dan cara memperbaikinya, plus cara mereset aplikasi.

Sebagian besar masalah berujung pada sebuah izin, model yang belum ada, atau dikte yang sedang dijeda. Mulai dari pemeriksaan cepat, lalu cari pesanmu di bawah.

Hotkey tidak berfungsi? Periksa ini dulu

  1. "Enable Dictation" tercentang di menu tray.
  2. Kamu sudah masuk dan uji coba belum berakhir (Settings › Account).
  3. Accessibility sudah diberikan di System Settings › Privacy & Security › Accessibility.
  4. Tidak ada input aman yang sedang aktif — misalnya Secure Keyboard Entry di Terminal, atau kolom kata sandi yang sedang fokus.

Pesan dan artinya

"Accessibility permission was revoked — reopen System Settings"

Kepercayaan Accessibility hilang saat perekaman dimulai. Buka System Settings › Privacy & Security › Accessibility dan aktifkan Keebye. Keebye mengaktifkan ulang hotkey dalam 2 detik.

"Failed to start the global hotkey listener"

macOS menolak event tap. Berikan akses Accessibility, lalu pilih tombolmu lagi di 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 lalu pilih tombolnya lagi; sampai itu Keebye tetap memakai tombol sebelumnya.

"Microphone capture failed: <error>"

Tidak ada perangkat input default atau stream audionya gagal. Periksa perangkat input di System Settings › Sound dan pastikan akses Microphone sudah diberikan.

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

Model yang dipilih belum ada di disk atau belum selesai dimuat. Tunggu sampai pill keluar dari status unduhan, atau tekan "Download model" di Settings › Speech engine.

"Model download failed — reopen Keebye to retry"

Lima kali percobaan unduhan gagal (jaringan, error HTTP, atau checksum tidak cocok). Tutup lalu buka lagi Keebye; unduhannya dilanjutkan dari titik terakhir.

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

Engine Native (Apple Speech) dipilih tanpa otorisasi. Berikan izin Speech Recognition, atau beralih ke Parakeet atau Canary.

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

Masalah pada engine Native. Model bahasa on-device-nya mungkin perlu dipasang lewat System Settings › Keyboard › Dictation; kalau tidak, bicaralah dalam 15 detik atau ganti engine.

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

Sebuah kolom kata sandi sedang fokus, atau ada aplikasi dengan Secure Keyboard Entry aktif (Terminal, misalnya). Klik ke kolom teks biasa atau matikan Secure Keyboard Entry. Ini memang dirancang begitu.

"Text left on clipboard — paste manually"

Sintesis ⌘V atau ketukan tombolnya gagal. Transkripnya ada di clipboard kamu; tekan ⌘V sendiri.

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

Worker sesi pulih dari sebuah crash. Diktekan lagi.

Jendela onboarding terbuka lagi setelah pembaruan atau pemasangan ulang

Izin Accessibility yang basi. Hapus Keebye dari System Settings › Privacy & Security › Accessibility dengan tombol −, tambahkan kembali, lalu aktifkan.

Reset Keebye

Tutup Keebye, hapus ~/Library/Application Support/com.keebye.app/settings.json, dan hapus item Keychain untuk service com.keebye.app, account auth. Jalankan ulang dan onboarding akan mulai lagi. Diagnostik hanya keluar ke stderr.