よくある質問

プラグインの使用中に発生する可能性のある一般的な質問をいくつか集めました。

🔐 認証方法関連

CookieモードとAccess Tokenモードの違いは何ですか？

プラグインは2つの認証方法をサポートしています。

Access Tokenモードの使用を推奨します。ただし、以下のような状況では例外となります。

• サイトがアクセストークンをサポートしていない
• 改造版のプロキシサイトを使用している
• トークン機能が無効になっている

認証方法を切り替えるにはどうすればよいですか？

アカウントを追加する際に、アカウントダイアログで対応する認証方法を選択してください。

1. 「アカウントを追加」をクリックします。
2. サイトアドレスを入力します。
3. 「認証方法」ドロップダウンリストで Access Token または Cookie を選択します。
4. 「自動認識」をクリックします。

🔧 特殊サイトの問題

AnyRouter サイトでエラーが発生した場合はどうすればよいですか？

AnyRouter は改造版のプロキシサイトであり、標準のAccess Tokenモードはサポートしていません。

解決策：

1. アカウントを追加する際に、Cookieモードを選択します。
2. まずブラウザでAnyRouterサイトにログインします。
3. その後、プラグインの自動認識機能を使用してアカウントを追加します。

Sub2API（JWTサイト）はどうやって追加しますか？

Sub2APIサイトの一般的な特徴は以下の通りです。コンソールインターフェースは /api/v1/* にあり、短期JWT（auth_token）+ リフレッシュトークン（ローテーションあり） のログイン状態を使用します。コンソールはログイン情報をlocalStorageに書き込みます。

• auth_token：JWTアクセストークン（短期）
• auth_user：ユーザー情報（id などを含む）
• refresh_token：リフレッシュトークン（オプション；アクセストークンのリフレッシュに使用され、通常はローテーションされます）
• token_expires_at：アクセストークンの有効期限タイムスタンプ（ミリ秒、オプション）

プラグインは2つの動作モードをサポートしています。

モード1：コンソールセッションモード（デフォルト/互換）

このモードでは、プラグイン内にrefresh_tokenを保存しません。プラグインは、コンソールのlocalStorageからauth_token / auth_userを読み取ることで、残高の自動認識とリフレッシュを行う必要があります。したがって、必ず先にブラウザでサイトコンソールにログインしておく必要があります。

追加手順：

1. ブラウザで対象サイトのコンソールを開き、ログインします（ログインページにリダイレクトされないことを確認してください）。
2. プラグインを開き、「アカウントを追加」をクリックします。
3. サイトURLを入力し、「自動認識」をクリックします。

注意と制限事項：

• 同じサイト（同じオリジン）では、1つのブラウザセッションでlocalStorageに保存できるログイン状態は1つだけです。そのため、このモードでは同じサイトでの複数アカウントの利用体験は非常に悪くなります。コンソールのアカウントを切り替えるとlocalStorageが上書きされ、プラグインもそれに合わせて「人が変わった」ように動作します。
• リフレッシュ時に401エラーが発生した場合、プラグインはauth_tokenを再読み込みして再試行します。それでも失敗する場合は、サイトコンソールに再度ログインしてからリフレッシュ/再認識してください。

モード2：プラグインホストセッション（マルチアカウント、推奨）

有効にすると、プラグインはrefresh_tokenをアカウント固有の認証情報として保存します（エクスポート/WebDAVバックアップにも含まれます）。これにより、各Sub2APIアカウントがJWTを独立してリフレッシュできるようになり、同じサイトでの複数アカウントをサポートします。

推奨インポート手順（シークレット/プライベートウィンドウ、ローテーションの競合を減らす）：

1. シークレット/プライベートウィンドウを開き、対象のSub2APIコンソールにログインします。
2. プラグインでアカウントを追加/編集し、「現在のログインアカウントからインポート」（または「自動認識/再認識」）をクリックしてセッション情報をインポートします。
3. フォームで「プラグインホストセッション（マルチアカウント）」を有効にし、refresh_tokenが取り込まれていることを確認してから保存します。
4. シークレット/プライベートウィンドウを閉じます（このサイトのlocalStorage/cookiesをクリアします）。これにより、コンソールとプラグインが同じrefresh_tokenを並行してリフレッシュして互いに無効になるのを防ぎます。

セキュリティに関する注意：

• refresh_tokenは長期的な認証情報です。このモードを有効にすると、アカウントのエクスポート/WebDAVバックアップと一緒に保存されるため、バックアップファイルとWebDAV認証情報を適切に管理してください。
• ブラウザが必要な場合は、拡張機能管理で「シークレット/プライベートウィンドウでの実行を許可する」を有効にしてください。

トラブルシューティング：

• refresh_tokenが無効またはローテーションされたと表示された場合は、上記の手順で再度インポート（または新しいrefresh_tokenを手動で貼り付け）してから再試行してください。

その他の既知の制限事項：

• **アクセストークン（JWT）**モードのみをサポートし、Cookie認証はサポートしていません。
• サイトのサインイン機能は現在サポートされていません（サインイン検出は自動的に無効になります）。
• 現在のバージョンでは主に残高/クォータを同期しています。「今日の使用量/収益」などの統計は0になる可能性があります。

自動認識に失敗した場合はどうすればよいですか？

自動認識に失敗した場合は、以下の方法を試してください。

1. 認証方法の切り替え：Access TokenモードからCookieモードへの切り替えを試してください。
2. 手動追加：自動認識に失敗した後、以下の情報を手動で入力してください。
   • ユーザー名
   • ユーザーID
   • アクセストークン
   • チャージ倍率
3. ログイン状態の確認：ブラウザで対象サイトにログインしていることを確認してください。
4. サイトの互換性の確認：サイトがサポートされているプロジェクト（下記参照）に基づいているか確認してください。

どのサイトが互換性がない可能性がありますか？

サイトがディープな二次開発を行い、重要なインターフェース（例：/api/user）を変更した場合、プラグインが正常に動作しない可能性があります。

一般的な非互換性の状況：

• ユーザー情報インターフェースの変更
• アクセストークン機能の無効化
• カスタム認証方法
• APIレスポンス形式の変更

🐛 機能とバグ関連

機能の問題やバグに遭遇した場合はどうすればよいですか？

1. Issueの確認：GitHub Issues にアクセスして、同じ問題がないか検索してください。
2. 最新バージョンの使用：
   • ストア版の更新は遅いため、GitHub Release版の使用をお勧めします。
   • または、mainブランチの開発版を直接使用してください。

最新バージョンを入手するにはどうすればよいですか？

プラグインは複数のプラットフォームでリリースされており、更新速度が異なります。

⚙️ 機能使用に関する問題

WebDAVバックアップの使用方法を教えてください。

WebDAVバックアップを使用すると、複数のデバイス間でデータを同期できます。

1. WebDAVの設定：

   • 「設定」→「WebDAVバックアップ」を開きます。
   • WebDAVサーバーアドレス（完全なURL）を入力します。
   • ユーザー名とパスワードを入力します。

2. 同期ポリシーの選択：

   • マージ（推奨）：ローカルデータとリモートデータをインテリジェントにマージします。
   • アップロードのみ：ローカルデータをサーバーにのみアップロードします。
   • ダウンロードのみ：サーバーからのみデータをダウンロードします。

3. 自動同期の有効化：

   • 「自動同期を有効にする」にチェックを入れます。
   • 同期間隔を設定します（デフォルトは3600秒/1時間）。

CherryStudio / New APIへのエクスポート方法を教えてください。

クイックエクスポート機能を使用すると、サイト設定を他のプラットフォームにワンクリックでインポートできます。

設定手順：

1. New APIの場合：

   • 「設定」→「基本設定」を開きます。
   • New APIサーバーアドレスを設定します。
   • 管理者トークン（Admin Token）を入力します。
   • ユーザーIDを入力します。

2. CherryStudioの場合：

   • 追加の設定は不要です。
   • CherryStudioが実行されていることを確認してください。

エクスポート手順：

1. 「キー管理」ページに移動します。
2. エクスポートしたいサイトを見つけます。
3. 操作メニューをクリックします。
4. 「CherryStudioにエクスポート」または「New APIにエクスポート」を選択します。

より完全なエクスポートと統合の説明については、クイックサイト設定のエクスポートを参照してください。CLIProxyAPI管理インターフェースとの連携を希望する場合は、CLIProxyAPI統合を参照してください。

サイトサインイン機能の使用方法を教えてください。

一部のプロキシサイトでは、毎日のサインインで報酬を獲得できます。

1. サインイン検出の有効化：

   • アカウントを編集します。
   • 「サインイン検出を有効にする」にチェックを入れます。

2. カスタムサインインURL（オプション）：

   • サイトのサインインページが標準パスでない場合。
   • 「カスタムサインインURL」に入力できます。
   • 「カスタムチャージURL」（オプション）を入力します。

3. サインインの実行：

   • サインインが必要なアカウントには、サインインアイコンが表示されます。
   • アカウントカードのサインインボタンをクリックします。
   • サインインページが自動的に開きます。

アカウントの並べ替えをカスタマイズするにはどうすればよいですか？

プラグインは、さまざまな並べ替え方法の優先度設定をサポートしています。

1. 並べ替え設定に入る：

   • 「設定」→「並べ替え優先度設定」を開きます。

2. 優先度の調整：

   • 並べ替え条件をドラッグして優先度を調整します。
   • 条件をチェック/チェック解除して有効/無効にします。

3. 利用可能な並べ替え条件：

   • 📌 現在のサイトを最上位に表示
   • 🏥 健康状態による並べ替え（エラー > 警告 > 不明 > 正常）
   • ✅ サインインが必要なアカウントを最上位に表示
   • 🔗 カスタムサインインURLを持つアカウントを最上位に表示
   • 📊 ユーザー定義フィールドによる並べ替え（残高/消費/収益/名前）

各並べ替えルールの詳細な意味と設定例については、並べ替え優先度設定を参照してください。

自動リフレッシュの設定方法を教えてください。

自動リフレッシュにより、アカウントデータを最新の状態に保つことができます。

1. 自動リフレッシュの有効化：

   • 「設定」→「自動リフレッシュ」を開きます。
   • 「定期的な自動リフレッシュを有効にする」にチェックを入れます。

2. リフレッシュ間隔の設定：

   • デフォルト：360秒（6分）
   • 最小：60秒（1分）
   • サイト数に応じて調整します。

3. その他のオプション：

   • ✅ プラグインを開いたときに自動リフレッシュ
   • ✅ 健康状態を表示

残高履歴（Balance History）の使用方法を教えてください。

残高履歴は、アカウント残高の変化と日々の収支傾向を長期的に確認するために使用されます。有効にすると、ローカルに日ごとに集計されたスナップショットが記録され、グラフで表示されます。

記録内容（各アカウントにつき1日最大1件）：

• 残高/クォータ：quota
• 今日の収益：today_income（チャージ/システムログ統計から）
• 今日の支出：today_quota_consumption（消費ログ統計から）
• 記録時間：capturedAt
• ソース：source（リフレッシュ / 日末取得）

記録方法：

1. リフレッシュ駆動：アカウントのリフレッシュが成功すると、その日のスナップショットが更新されます。このプロセスは「今日の収支を表示」スイッチに従い、残高履歴のために追加でログを強制的に取得することはありません。
2. 日末取得（オプション）：有効にすると、毎日 23:55 頃にバックグラウンドで取得が行われ、その日の収支が強制的に含まれます。これにより、その日の収益/支出データをできるだけ補完します。

前提条件（重要）：

• 「今日の収支を表示」をオフにすると、リフレッシュ駆動の収益/支出フィールドは空になります。
• 収益/支出履歴を記録したい場合は、以下のいずれかを有効にしてください。
  • 「今日の収支を表示」（リフレッシュ時に今日の収支を計算）
  • 「日末取得」（毎日1回、今日の収支を強制的に取得）

制限と説明：

• Best-effort：ブラウザのスリープ、ネットワークの中断、サイトの制限により、一部の日付が欠落する可能性があります。グラフには断点/空白が表示されます。
• 履歴のバックフィルなし：過去の日付を補完するために、過去のログを遡って検索することはありません（大量のネットワークリクエストを避けるため）。
• 保持とクリア：最近N日間（デフォルト365日）のみ保持されます。書き込み時にウィンドウを超えるスナップショットは自動的にクリアされます。ページ内で手動で「クリア」を実行することもできます。
• ローカルストレージ：残高履歴はローカルにのみ保存されます（現在のバージョンでは、インポート/エクスポート / WebDAV同期と一緒に移行されません）。

📱 モバイルデバイスでの使用

スマートフォンでどのように使用できますか？

プラグインは、モバイルブラウザ（例：モバイル版 Edge、Firefox for Android、Kiwi など）で使用できます。実際の可用性は、ブラウザ自体の拡張機能サポート状況に依存します。

モバイルデバイスでの使用に関する推奨事項

1. 自動リフレッシュの無効化：モバイルデバイスのリソースは限られているため、自動リフレッシュ機能を無効にし、手動リフレッシュに切り替えることをお勧めします。また、過盾アシスタント（anti-bot helper）により、リフレッシュ時に一時的なタブが作成され、日常の使用体験に影響を与える可能性があります。
2. 過盾アシスタントの設定調整：サイトで過盾が頻繁にトリガーされる場合は、「設定」→「過盾アシスタント」でトリガー条件を調整してください。例えば、トリガー閾値を上げるか、一部のトリガー条件を無効にして、過盾ポップアップの頻度を減らします。
3. WebDAV同期の設定：PCとスマートフォン間でデータを同期します。

🔒 データセキュリティ

データはどこに保存されますか？

• ローカルストレージ：すべてのデータはブラウザのローカルストレージに保存されます。
• 完全オフライン：プラグインのコア機能はインターネット接続を必要としません。
• データのアップロードなし：第三者のサーバーにデータをアップロードすることはありません。

データは失われますか？

定期的なデータバックアップをお勧めします。

1. JSONエクスポート：

   • 「設定」→「データとバックアップ」に移動します。
   • 「データをエクスポート」をクリックします。
   • JSONファイルを保存します。

2. WebDAV同期（推奨）：

   • クラウドに自動バックアップします。
   • マルチデバイス同期をサポートします。

🆘 その他の質問

サイト重複検出とは何ですか？

サイトを追加する際、プラグインは既に同じサイトが存在するかどうかを自動的に検出します。

• サイトURLに基づいて判断します。
• 既に存在する場合、通知が表示され、クイック編集が可能です。
• 同じサイトの重複追加を防ぎます。

健康状態とはどういう意味ですか？

健康状態は、アカウントの可用性を示します。

プラグインはトラフィックを消費しますか？

• アカウントデータをリフレッシュする際にのみサイトAPIにアクセスします。
• リクエスト量は非常に少ないです（各サイトあたり約数KB）。
• 自動リフレッシュはWiFi環境での使用をお勧めします。

コードに貢献するにはどうすればよいですか？

Pull Requestを歓迎します。

1. プロジェクトリポジトリをフォークします。
2. 機能ブランチを作成します。
3. コードをコミットします。
4. Pull Requestを送信します。

詳細は：CONTRIBUTING.md を参照してください。

📚 関連ドキュメント

• 使い方ガイド
• GitHubリポジトリ
• 問題報告
• 更新ログ