Cloudflare シールド回避アシスタント

Cloudflareの5秒シールド（またはより厳格なBot Fight Mode）が有効になっているアグリゲートプロキシステーションに適用され、プラグインがアカウント情報を認識できるだけでなく、リクエストが制限された際に自動でリトライできるようにします。

機能概要

• 自動検出: ページタイトルに Just a moment が含まれている、#cf-content が存在している、またはAPIが401/403/429などのステータスコードを返した場合に、自動的にシールド回避プロセスをトリガーします。
• 一時ウィンドウ: バックグラウンドでターゲットドメインと同じオリジンの仮のタブを開き、ブラウザのCookieを引き継いでCloudflareのJS/人間性チャレンジを完了させ、元のページに戻ります。
• リクエスト降格: 通常の fetch が失敗した場合、仮のウィンドウがCookieを保持してリクエストを再送することで、クロスドメイン/資格情報不足による無限リトライを回避します。
• 手動フォールバック: Cloudflareがユーザーのインタラクションが必要と判断した場合、20秒以内に検証を完了するよう促すポップアップウィンドウが自動的に表示されます。

使用手順

1. ターゲットサイトにログインし、プラグインでアカウントを新規追加 → サイトアドレスを入力 → 「自動認識」をクリックします。
2. Cloudflareのプロンプトが表示された場合、ブラウザが自動的にポップアップウィンドウを表示します。ウィンドウをフォアグラウンドに保ち、自動検証の完了を待つか、指示に従って選択してください。
3. 検証が完了すると、プラグインは自動的に認識プロセスに戻り、Access Token、残高、モデルリストなどのデータを引き続き読み取ります。
4. APIリクエスト段階でレート制限がトリガーされた場合（CC Switch/CherryStudioのエクスポートまたはNew APIの同期でよく発生します）、システムは自動的に仮のウィンドウを有効にして再送信します。追加の操作は不要です。

シールド回避履歴で原因を調べる

一時ページが開いた理由や、開かなかった理由を調べるには、設定 → データ更新 で サイト認証の補助 の見出し横にある シールド回避履歴 を選択します。履歴はダイアログで表示され、操作するまでは閉じています。

シールド回避に関するアカウントの警告、自動シールド回避が制限されている場合の通知、認証の失敗や一時ページの終了を示すチェックイン結果、一時ページ上のアシスタントからも シールド回避履歴を表示 を選択できます。

1. サイト、操作、診断情報で検索したり、処理状態で絞り込んだりできます。検索と絞り込みは、保存されているすべての記録が対象です。
2. 記録を展開すると、きっかけとなった操作とその実行元、取得できた HTTP ステータスやエラーコード、一時ページが新規作成されたか再利用されたかを確認できます。
3. 設定や権限によってリクエストが拒否された場合は、関連設定を表示 から該当する設定を開き、必要に応じて変更します。
4. 調査用の情報を残すには 診断の詳細をコピー を選択します。端末上の記録を削除するには、履歴ダイアログ右上のメニューから 履歴を消去 を選び、確認します。

履歴には、この端末の直近 100 件まで保存されます。新しく発生した一時ページのリクエストが記録され、アップグレード前の操作は追加されません。サイトのアドレスはオリジンのみを保存し、URL のパス、クエリパラメーター、トークン、Cookie、リクエストやレスポンスの本文は保存しません。

処理完了は、その一時ページのタスクが完了結果を返したことを示します。アカウントが再び利用できるかは、更新やチェックインなどの最終結果で確認してください。

注意事項

• IPの品質: 連続して通過できない場合は、ネットワークを変更するか、サイト側で一時的に保護を緩和する必要があります。デフォルトのタイムアウト時間は20秒です。
• ポップアップ権限: ブラウザのポップアップウィンドウを許可してください。そうしないと、プラグインは一時タブを作成できません。
• 繰り返しチャレンジ: 頻繁に429がトリガーされる場合は、New APIのチャネル管理でレートを下げたり、モデルのホワイトリストを有効にしたりして、無効なリクエストを減らすことができます。

よくある質問

関連ドキュメント

• サイトのクイックエクスポート
• セルフホスト型サイト管理
• 権限管理（オプションの権限）