Dokümantasyon içeriğine geç
Keebye Docs

Sorun giderme

Keebye'ın gösterdiği her mesajın anlamı, nasıl düzeltileceği ve nasıl sıfırlanacağı.

Sorunların çoğu bir izne, eksik bir modele ya da diktenin duraklatılmış olmasına bağlıdır. Hızlı kontrollerle başla, sonra aşağıdan mesajını bul.

Hotkey bir şey yapmıyor mu? Önce bunlara bak

  1. Menü çubuğu menüsünde "Enable Dictation" işaretli.
  2. Giriş yapmış durumdasın ve deneme bitmemiş (Settings › Account).
  3. System Settings › Privacy & Security › Accessibility içinde erişilebilirlik izni verilmiş.
  4. Etkin bir güvenli giriş yok — örneğin Terminal'de Secure Keyboard Entry ya da odaktaki bir parola alanı.

Mesajlar ve anlamları

"Accessibility permission was revoked — reopen System Settings"

Kayıt başladığında Accessibility güveni yoktu. System Settings › Privacy & Security › Accessibility'yi aç ve Keebye'ı aç. Keebye hotkey'i 2 saniye içinde yeniden devreye alır.

"Failed to start the global hotkey listener"

macOS event tap'i reddetti. Erişilebilirlik izni ver, sonra Settings'te tuşunu yeniden seç.

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

Hotkey değişikliği reddedildi. Erişilebilirlik izni ver ve tuşu yeniden seç; o zamana kadar Keebye önceki tuşu kullanmaya devam eder.

"Microphone capture failed: <error>"

Varsayılan bir giriş aygıtı yok ya da ses akışı başarısız oldu. System Settings › Sound içindeki giriş aygıtını ve Mikrofon izninin verildiğini kontrol et.

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

Seçili model diskte yok ya da yüklenmesi bitmedi. Kapsülün indirme durumundan çıkmasını bekle ya da Settings › Speech engine içinde "Download model" düğmesine bas.

"Model download failed — reopen Keebye to retry"

Beş indirme denemesi de başarısız oldu (ağ, HTTP hatası ya da sağlama toplamı uyuşmazlığı). Keebye'dan çık ve yeniden aç; indirme kaldığı yerden devam eder.

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

Native (Apple Speech) motoru izin olmadan seçili. Konuşma Tanıma izni ver ya da Parakeet veya Canary'ye geç.

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

Native motor sorunları. Cihaz üzerindeki dil modelinin System Settings › Keyboard › Dictation üzerinden kurulması gerekebilir; aksi hâlde 15 saniye içinde konuş ya da motor değiştir.

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

Odakta bir parola alanı var ya da bir uygulamanın Secure Keyboard Entry ayarı açık (örneğin Terminal). Normal bir metin alanına tıkla ya da Secure Keyboard Entry'yi kapat. Bu tasarım gereğidir.

"Text left on clipboard — paste manually"

⌘V'nin ya da tuş vuruşlarının sentezlenmesi başarısız oldu. Transkript panonda; ⌘V'ye kendin bas.

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

Oturum işçisi bir çökmeden kurtuldu. Yeniden dikte et.

Bir güncellemeden ya da yeniden kurulumdan sonra kurulum penceresi yine açıldı

Eski bir Accessibility izni. − düğmesiyle Keebye'ı System Settings › Privacy & Security › Accessibility içinden çıkar, geri ekle ve aç.

Keebye'ı sıfırla

Keebye'dan çık, ~/Library/Application Support/com.keebye.app/settings.json dosyasını sil ve com.keebye.app servisi ile auth hesabına ait Keychain kaydını kaldır. Yeniden başlat; kurulum akışı baştan başlar. Tanılama çıktısı yalnızca stderr'e gider.