トラブルシューティング
Keebye が表示する各メッセージの意味と直し方、そしてリセットの方法。
ほとんどの問題は、権限、モデルの不足、音声入力が一時停止していることのいずれかに行き着きます。まず簡単な確認から始め、次に自分に表示されたメッセージを下から探してください。
ホットキーが反応しない？ まずここを確認
- トレイメニューで "Enable Dictation" にチェックが入っている。
- サインインしていて、トライアルが終了していない（設定 › Account）。
- システム設定 › プライバシーとセキュリティ › アクセシビリティ で、アクセシビリティが許可されている。
- セキュア入力が有効になっていない — たとえばターミナルの Secure Keyboard Entry や、フォーカス中のパスワード欄。
メッセージとその意味
"Accessibility permission was revoked — reopen System Settings"
録音を始めたときに、アクセシビリティの信頼が失われていました。システム設定 › プライバシーとセキュリティ › アクセシビリティ を開いて Keebye をオンにしてください。Keebye は 2 秒以内にホットキーを再登録します。
"Failed to start the global hotkey listener"
macOS がイベントタップを拒否しました。アクセシビリティへのアクセスを許可し、設定でキーをもう一度選んでください。
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." または "Could not switch to <Key>; still using <Key>."
ホットキーの変更が拒否されました。アクセシビリティへのアクセスを許可し、もう一度キーを選んでください。それまで Keebye は以前のキーを使い続けます。
"Microphone capture failed: <error>"
既定の入力デバイスがない、またはオーディオストリームが失敗しました。システム設定 › サウンド で入力デバイスを確認し、マイクへのアクセスが許可されているかも確認してください。
"Speech model still setting up — try again in a moment"
選択したモデルがディスクに無い、または読み込みが終わっていません。ピルがダウンロード状態を抜けるまで待つか、設定 › Speech engine で "Download model" を押してください。
"Model download failed — reopen Keebye to retry"
ダウンロードが 5 回失敗しました（ネットワーク、HTTP エラー、チェックサムの不一致）。Keebye を終了して開き直すと、ダウンロードは止まったところから再開します。
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
権限がないまま Native (Apple Speech) エンジンが選ばれています。音声認識を許可するか、Parakeet か Canary に切り替えてください。
"Apple Speech recognizer is not available for locale …"、"Apple Speech recognized no speech"、"Apple Speech timed out after 15s"
Native エンジンの問題です。オンデバイスの言語モデルを システム設定 › キーボード › 音声入力 からインストールする必要があるかもしれません。そうでなければ、15 秒以内に話すか、エンジンを切り替えてください。
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" または "Couldn't insert: A password field is focused — dictation is blocked"
パスワード欄がフォーカスされている、またはアプリで Secure Keyboard Entry が有効になっています（たとえばターミナル）。通常のテキストフィールドをクリックするか、Secure Keyboard Entry をオフにしてください。これは設計どおりの動作です。
"Text left on clipboard — paste manually"
⌘V またはキーストロークの合成が失敗しました。書き起こしはクリップボードにあります。自分で ⌘V を押してください。
"Dictation hit an internal error and was reset. Please try again."
セッションのワーカーがクラッシュから復帰しました。もう一度音声入力してください。
アップデートや再インストールのあとに、オンボーディングウィンドウが開いた
アクセシビリティの許可が古くなっています。システム設定 › プライバシーとセキュリティ › アクセシビリティ から − ボタンで Keebye を削除し、追加し直してオンにしてください。
Keebye をリセットする
Keebye を終了し、~/Library/Application Support/com.keebye.app/settings.json を削除して、サービス com.keebye.app、アカウント auth のキーチェーン項目を削除します。もう一度起動すると、オンボーディングが始まります。診断情報は stderr にのみ出力されます。