トラブルシューティング
症状に沿って確認してください。図は英語ラベルの操作の概念図で、実際の外観は App と macOS によります。
開始前の情報
Section titled “開始前の情報”macOS、VoiceHotkey 版（設定 → 情報）、認識エンジン、ローカルのみの状態、Finder のアプリパス。キーや機密の全文は公開しないでください。連絡先 へ。
ホットキーが無反応
Section titled “ホットキーが無反応”録音表示やメニューバー状態が変わらないとき。
チェックリスト
Section titled “チェックリスト”起動中、現在パスのアクセシビリティ、/Applications／~/Applications から起動、キー競合なし、ショートカットに権限警告なし。
アイコンからメニューを開けるか確認し、なければアプリケーションから起動し直します。システム設定 → プライバシーとセキュリティ → アクセシビリティ で現在パスだけを有効化。古い重複を消し完全終了・再起動します。固定パス を使い、設定のショートカットで衝突しにくいキーへ変更します。入力 右 Command、コマンド マウスの中ボタン と競合するツールを終了します。
録音するがテキストが出ない
Section titled “録音するがテキストが出ない”チェックリスト
Section titled “チェックリスト”マイク／デバイス、モデル資源／クラウド認証、ローカルのみ、通信／残量／キー、編集可能なカーソル。安全入力欄はキー注入を止める場合があります。
新規は実 ASR、Demo スイッチはありません。一般でマイクとデバイスを確認し、旧／テスト状態は セットアップ と BYOK を確認します。メニューバーの不足権限・モデル・端点警告を読み、ボイスメモで機器を試します。準備済み Apple を比較用に使い、Apple 成功・クラウド失敗ならキー／通信／残量を確認。ローカルのみは公開 ASR を遮断します。
設定 → 一般 → 出力動作 で挿入を選び編集欄へフォーカス。コピーのみはクリップボード、無編集欄も既定でコピーできます。履歴専用は内部で選択肢ではありません。Terminal／Secure Input ではメモで比較してください。
権限がすぐ外れる
Section titled “権限がすぐ外れる”Downloads の移動、異なるビルドパス、差し替えによる署名変更、古い重複登録など。
アプリケーションに 1 コピーを置き、完全終了して古いアクセシビリティを消します。現在のマイク許可スイッチを確認し、固定パスから起動して再許可。以後同じコピーを使います。
整形／翻訳が変わらない
Section titled “整形／翻訳が変わらない”オン／翻訳キー、処理エンジン、ローカルのみ、履歴と状態を確認。失敗で原文が出るのはフォールバックです。クラウドはキー／モデル／端点、Spark は導入を確認。Apple 翻訳は macOS 26+ と言語資源 で LLM キー不要、旧 OS は使えません。公開 LLM は遮断するためローカル／ループバック、必要ならモードをオフにします。アプリ適応は Trial/Pro。先に未整形の入力を成功させます。
音声コマンドが反応しない
Section titled “音声コマンドが反応しない”設定 → 音声コマンド → 音声コマンドを有効にする、キー、アクセシビリティ、能力許可、有効な辞書の正確／あいまい一致を確認。内蔵口令はなく自分で登録します。意図／選択書き換えは Trial/Pro とモデル、ウインドウはアクセシビリティ、リマインダー／予定はフルアクセス。音声コマンド へ。
Shell が実行されない
Section titled “Shell が実行されない”Shell 実行・許可・確認・環境は削除済みです。ライセンスを変えても復活しません。辞書動作、準備した Shortcuts、システム操作へ置換します。Shell の現状 へ。
ライセンス機能や有効化が使えない
Section titled “ライセンス機能や有効化が使えない”Free は基本整形と辞書、意図／選択／適応／GUI 転写／履歴変更は Trial/Pro。フォームは Free と試用中の両方に表示されいつでも有効化可能、Pro はキー変更です。台数超過は旧 Mac をオンライン無効化。失敗時は席が残ることがあります。通信／サーバー障害ならローカル署名へ戻れ、明示的無効／失効／超過は戻れません。ライセンス へ。
初回は固定パス・両権限・マイク・準備モデル・メモ。更新後は新コピーをアプリケーションから起動、古い権限を整理、再許可、情報で版確認。職場ネットは公開 API を到達可能にするか Apple／ローカル／ループバックを使います。ローカルのみは公開 ASR/LLM と更新を止めますが、ライセンス通信は可能です。
まだ直らない場合
Section titled “まだ直らない場合”セットアップ を再実行し、上の情報と再現手順／期待結果を 連絡先 に送ります。インストール でパスと権限も確認してください。