cc-bridge Handler

アプリを入れ替えたときに起きます。古い版の許可記録が新しい版と衝突していて、 許可しても反映されません。アプリを完全に終了してから、記録を消してやり直してください。

tccutil reset ScreenCapture com.gameagelayer.ccbridge.handler

そのあとアプリを起動し、出てきたダイアログで許可し、 もう一度終了して起動し直します。許可の反映には再起動が必要です。

アプリのコピーが複数あると、片方に許可してももう片方には効きません。 /Applications 以外のコピーは削除してください。

このアプリはメニューバー常駐型で、Dock アイコンもウインドウも出ません。 設定が済んでいれば、起動しても画面上は何も起こらないのが正常です。 画面右上に橋のマークがあれば動いています。

マークが見当たらないときは、起動しているか確かめてください。

pgrep -fl "cc-bridge Handler" || echo "起動していない"

プロセスが見つかるのにマークが無い場合は、メニューバーの項目が多すぎて macOS が隠しています（ノッチ付きの Mac で起きます）。他のアイコンを減らしてください。

起動していない場合は、直接起動すると普段は隠れる起動時のエラーが表示されます。

"/Applications/cc-bridge Handler.app/Contents/MacOS/cc-bridge Handler"

何も出ずに止まったままなら正常に起動しています（Ctrl+C で終了）。

まず、この Mac の構成を控えてください。アプリは Apple Silicon 専用です。

uname -m; sw_vers; sysctl -n machdep.cpu.brand_string

アプリ側の対応アーキテクチャと突き合わせます。uname -m が x86_64 なのにアプリが arm64 だけなら、それが原因です。

file "/Applications/cc-bridge Handler.app/Contents/MacOS/cc-bridge Handler"

lipo ではなく file を使います。 lipo は Xcode のコマンドラインツールが要るので、入っていない Mac では インストールを促すダイアログが出るだけで結果が得られません。

クラッシュレポートから原因を抜き出す

落ちた理由だけを取り出します。これが最も手がかりになります。

f=$(ls -t ~/Library/Logs/DiagnosticReports/*cc-bridge*.ips | head -1); tr "," "
" < "$f" | grep -E '"(exception|termination|asi|signal|type|subtype)"|EXC_|SIG|dyld|Symbol|Library' | head -30

落ちた場所（どのライブラリの中で止まったか）も見ます。

f=$(ls -t ~/Library/Logs/DiagnosticReports/*cc-bridge*.ips | head -1); tr "{" "
" < "$f" | grep -E "imageIndex|symbol|CFBundleIdentifier" | head -20

レポート全体が要るときは f=$(ls -t ~/Library/Logs/DiagnosticReports/*cc-bridge*.ips | head -1); head -c 4000 "$f" で先頭を取れます。ファイル名に空白が入るので、変数に入れて引用符で囲むのが確実です。

アプリ自身のログにも記録が残っていることがあります。 空なら、Python が動き出す前に落ちています。

tail -40 ~/.config/cc-pc-handler/app.log

出力をメモで送ってください。原因を特定します。 なお DYLD_PRINT_LIBRARIES は使えません — 署名済みアプリでは macOS が DYLD_* を無視するため、何も出ません。

失敗の理由が通知でしか出ないため、通知が未許可だと画面上は無反応に見えます。 まずアプリのログを見てください。

tail -40 ~/.config/cc-pc-handler/app.log

次に、この PC からブリッジに届いているかを確かめます。 200 が返れば通信は問題ありません。

curl -s -o /dev/null -w "%{http_code}\n" "https://cc-bridge.elc-gateway.com/client/eula"

接続先が正しく入力されているか確認します。空欄や別のブリッジのままだと、 このブリッジにはペアリングできません。上の https://cc-bridge.elc-gateway.com になっているか見てください。

cat ~/.config/cc-pc-handler/handler.json

出力をメモで送ってください。 なお承認は別の PC からでもできます。手元のブラウザで 承認ページ を開き、アプリに出ている 8 桁を入力してください。

まずアプリを完全に終了して起動し直してください。許可の反映には プロセスの再起動が必要で、メニューバー常駐のためウインドウを閉じるだけでは終了しません。

それでも変わらない場合、システム設定 → プライバシーとセキュリティ → アクセシビリティ に cc-bridge Handler が複数並んでいないか見てください。 アプリを入れ替えると古い項目が残り、そちらに許可が付いたままになります。 すべて削除（−）してからアプリを再起動すると、登録し直されます。

アプリから見えている状態はこれで確認できます。

tail -5 ~/.config/cc-pc-handler/app.log; echo "---"; ls -d /Applications/"cc-bridge Handler.app"

自動化と通知は「判定しません」と出ます。これは異常ではありません。 自動化は状態を調べるだけで確認画面が出て操作が止まってしまうため、 通知は状態取得に必要な仕組みを同梱していないため、どちらも意図的に調べていません。 自動化は初回の実利用時に macOS が確認します。

画面収録が未許可です。システム設定 → プライバシーとセキュリティ → 画面収録で許可し、 アプリを再起動してください。エラーにならず成功したように見えるのが厄介な点です。

相手のアプリが管理者として実行中の場合、同じ権限がないと操作できません（OS の仕様）。 このアプリはユーザー単位インストールで管理者権限を持たないため、 管理者として動いているアプリは操作対象外になります。

ブリッジ側でペアリングが解除されています。セットアップ画面からもう一度ペアリングしてください。

メニューの ログを表示 から開けます。ファイルの場所は次のとおりです。

• macOS — ~/.config/cc-pc-handler/app.log
• Windows — %APPDATA%\cc-pc-handler\app.log