macOS の権限に関する問題

概要

macOS の権限が付与されている（トグルがオンになっている）のに、Whisperer がまるで付与されていないかのように動作することがあります。相手の声が聞こえない、ホットキーが反応しない、スクリーンショットが撮影されない、といった具合です。これらは macOS のプライバシー機構（TCC）にありがちな挙動です。TCC は決定をキャッシュし、アプリの再起動後にのみそれを適用します。また、アップデート後にアプリへの「信頼」を失ってしまうこともあります。

ここでは、トグルはオンなのに動作しない場合、アプリが「プライバシー」一覧に表示されない場合、そして権限ウィザードがループしてしまう場合の対処法を説明します。最後に、3 つの権限それぞれについての短いチェックリストをまとめます。

こんなときに

トグルはオンなのに、機能が動作しない。
該当する「プライバシーとセキュリティ」のセクションに Whisperer が表示されない。
権限ウィザード（PermissionWizard）が何度も開き、権限が付与済みとして認識されない。
macOS のアップデート後、再インストール後、またはアプリの移動後に問題が現れた。

手順

トグルはオンなのに動作しない

アプリを再起動する。 Whisperer を完全に終了し（Cmd+Q）、再度開きます。ほとんどの権限、特に「画面収録」は、再起動後にのみ適用されます。
権限を付与し直す。 システム設定 → プライバシーとセキュリティ → 該当するセクション → Whisperer のトグルをオフにし、そのあと再度オンにします。アプリを再起動してください。
削除して追加し直す。 付与し直しても解決しない場合は、同じセクションで Whisperer を選択し、「−」（マイナス）ボタンで一覧から削除します。その後 Whisperer を再び起動すると、改めてアクセス権が要求されるので、許可してアプリを再起動します。
正しい権限を直しているか確認する。 下のチェックリストの表（症状 → 権限）と照らし合わせてください。
TCC をリセットする（注意、最終手段）。 どうしても解決しない場合は、ターミナルでコマンドを使ってそのアプリのプライバシーキャッシュをリセットできます。全体に対してではなく、特定のサービスを対象に行うのが最も安全です。
- tccutil reset ScreenCapture — 「画面収録」をリセット（全アプリ対象）。
- tccutil reset Microphone — マイクへのアクセスをリセット。
- tccutil reset Accessibility — 「アクセシビリティ」をリセット。 警告： このコマンドはそのカテゴリのすべてのアプリの権限をリセットするため、再度それらを付与し直す必要があります。慎重に実行し、そのあと Whisperer を再起動して権限ウィザードをもう一度進めてください。

アプリが「プライバシー」一覧に表示されない

セクションを閉じて Whisperer を起動します — アプリ自身がアクセス権を要求し、その後一覧に表示されるはずです。
それでも表示されない場合は、アクセス権を必要とする操作をアプリ内で行ってください（画面収録／マイクのためにセッションを開始する、アクセシビリティのためにホットキーを押す）。これでシステムのプロンプトが起動します。
アプリを「アプリケーション」フォルダから起動しているか確認してください。「ダウンロード」フォルダ内の一時的なコピーから起動していないか注意してください。さもないと「間違った」コピーが一覧に登録されてしまうことがあります。

権限ウィザードがループから抜けられない

ウィザードは、システムが実際に権限を適用したあとにのみ、権限を付与済みとして数えます。付与したトグルが「見えていない」場合は、アプリを再起動してください（ウィザードも一緒に再起動されます）。
ループが「画面収録」で起きている場合、これが最も多いケースです。macOS はこの権限を認識するために再起動を必要とします。Whisperer を終了して再度開いてください。
それでもウィザードがループする場合は、権限を付与し直し（オフ／オンを切り替え）、そのあと再起動してください。最終手段として、該当サービスの TCC をリセットします（上記参照）。

3 つの権限のチェックリスト

症状	権限	システム設定のセクション
相手の声が聞こえない、スクリーンショットが撮れない	画面収録	プライバシーとセキュリティ → 画面収録
自分の声が録音されない（`[Me]` が空）	マイク	プライバシーとセキュリティ → マイク
ホットキーが効かない	アクセシビリティ	プライバシーとセキュリティ → アクセシビリティ

スクリーンショット

📸 [スクリーンショット：「プライバシーとセキュリティ」で「−」ボタンを使って一覧から Whisperer を削除し、追加し直す様子]

📸 [スクリーンショット：tccutil reset ScreenCapture コマンドを入力したターミナル（注意の警告つき）]

📸 [スクリーンショット：「画面収録」のステップで止まり、再起動を促す権限ウィザード]

よくある間違い

アプリの再起動を忘れる。 「付与済み」の権限が動作しない最大の原因 — 特に「画面収録」。
不要なときの全体的な tccutil reset。 カテゴリのリセットはすべてのアプリに影響します。最終手段としてのみ、特定のサービスを対象に使ってください。
アプリのコピーが複数ある。 「ダウンロード」内のコピーと「アプリケーション」内のコピーは別々の TCC エントリを持ちます。コピーは 1 つ — 「アプリケーション」内に — だけ残してください。
間違った権限を直している。 チェックリストと照らし合わせてください。症状は正しいトグルを一意に指し示します。

ベストプラクティス

常に最もシンプルな方法から試してください。まずアプリを再起動し、次にトグルを付与し直し、それでもダメなときにだけ一覧から削除したり tccutil を使ったりします。
macOS のアップデート後は、3 つのトグルすべてを事前に確認してください。OS のアップデートで信頼がリセットされることがあります。
Whisperer のコピーは「アプリケーション」フォルダに 1 つだけ保持してください。
tccutil は最後の最後まで取っておき、全体ではなく特定のサービス（ScreenCapture／Microphone／Accessibility）に対して適用してください。