はじめに

New APIなどのAI中継サイトアカウントの管理体験を最適化するために設計されたオープンソースのブラウザ拡張機能です。ユーザーはアカウント残高、モデル、キーを簡単に一元管理・確認でき、新しいサイトを自動で追加できます。Kiwiブラウザまたはモバイル版Firefoxブラウザを介してモバイルデバイスでも利用可能です。

1. ダウンロード

チャネル版の比較

チャネル	ダウンロードリンク	現在のバージョン
GitHub Release	Release ダウンロード
Chrome ストア	Chrome ストア
Edge ストア	Edge ストア
Firefox ストア	Firefox ストア

ヒント

ストア版は審査プロセスにより1〜3日遅延する場合があります。新機能や修正をいち早く体験したい場合は、GitHub Release版を優先するか、リポジトリのソースコードからビルドすることをお勧めします。

2. サポートされているサイト

以下のプロジェクトに基づいてデプロイされた中継サイトをサポートしています：

注意

サイトが二次開発され、一部の重要なAPI（例：/api/user）が変更された場合、プラグインはこのサイトを正常に追加できない可能性があります。

3. サイトの追加

ヒント

プラグインの自動認識機能がCookieを介してアカウントのアクセストークンを取得できるように、まずブラウザで目的の中継サイトにログインする必要があります。

3.1 自動認識による追加

プラグインのメインページを開き、アカウントを追加 をクリックします。

中継サイトのアドレスを入力し、自動認識 をクリックします。

自動認識が正しいことを確認したら、追加を確定 をクリックします。

ヒント

プラグインは、以下のようなアカウントの様々な情報を自動的に認識します：

ユーザー名
ユーザーID
アクセストークン
チャージ金額レート

ターゲットサイトがCloudflareの5秒シールドを有効にしている場合、プラグインは自動的に独立したウィンドウをポップアップしてシールドを通過するのを助けます。通過後、認識プロセスを続行できます。 IPの品質が悪い、またはその他の理由により、タイムアウト前にポップアップウィンドウで手動でシールドを通過する必要があります。

3.2 Cloudflareシールドアシスタントの概要

Cloudflareの5秒シールドが認識されると、プラグインは自動的に一時ウィンドウを起動して検証を完了するのを助けます。チャレンジに手動介入が必要な場合は、ポップアップ内で検証をクリックしてください。
検証が成功すると、元のプロセスに自動的に戻り、アクセストークンとサイト情報の取得を続行します。
詳細については、Cloudflare保護と一時ウィンドウのダウングレードを参照してください。

3.3 手動追加

ヒント

自動認識が成功しなかった場合、手動でサイトアカウントを追加できます。以下の情報を事前に取得する必要があります。（各サイトでUIが異なる場合があるため、ご自身で探してください）

用户信息

ターゲットサイトがカスタマイズ版（例：AnyRouter）の場合、アカウント追加時に手動でCookieモードに切り替えてから、自動認識または手動入力を実行してください。厳重な保護が施されたサイトに遭遇した場合は、Cloudflareシールドアシスタントと組み合わせて使用することもできます。詳細については、よくある質問を参照してください。

4. サイトのクイックエクスポート

このプラグインは、追加済みのサイトAPI設定をCherryStudio、CC Switch、およびNew APIへワンクリックでエクスポートすることをサポートしており、これらのプラットフォームでのアップストリームプロバイダーの追加プロセスを簡素化します。

4.1 設定

クイックエクスポート機能を使用する前に、プラグインの基本設定ページで、ターゲットプラットフォーム（New API）のサーバーアドレス、管理者トークン、およびユーザーIDを設定する必要があります。

4.2 エクスポート手順

キー管理へ移動：プラグインのキー管理ページで、エクスポートしたいサイトに対応するAPIキーを見つけます。
エクスポートをクリック：キー操作メニューで、**「CherryStudio / CC Switch / New APIへエクスポート」**を選択します。
自動処理：
- New APIの場合：プラグインは、ターゲットプラットフォームに同じBase URLのチャネルが既に存在するかどうかを自動的に検出し、重複追加を回避します。存在しない場合は、新しいチャネルを作成し、サイト名、Base URL、APIキー、および利用可能なモデルリストを自動的に入力します。
- CherryStudio / CC Switchの場合：プラグインは、ターゲットアプリケーションのプロトコルに基づいて、サイトとキーをローカルプログラムまたはクリップボードに直接送信し、項目ごとの貼り付けの手間を省きます。

この機能により、APIプロバイダーの設定を他のプラットフォームに手動でコピー＆ペーストすることなく簡単にインポートでき、作業効率が向上します。

5. 機能の概要

5.1 自動更新とヘルスステータス

設定 → 自動更新を開くと、アカウントデータの定期的な更新を有効にできます。デフォルトの間隔は6分（360秒）で、最短60秒をサポートしています。
**「プラグインを開いたときに自動更新」**にチェックを入れると、ポップアップを開いたときにデータが同期されます。
**「ヘルスステータスを表示」**を有効にすると、アカウントカードにヘルスステータスインジケーター（正常/警告/エラー/不明）が表示されます。

5.2 チェックイン検出

アカウント情報で**「チェックイン検出を有効にする」**にチェックを入れると、サイトのチェックインステータスを追跡できます。
カスタムチェックインURLとカスタムチャージURLの設定をサポートしており、カスタマイズされたサイトにも対応します。
チェックインが必要なアカウントはリストにヒントが表示され、クリックするとチェックインページにジャンプします。

5.3 WebDAVバックアップと複数端末同期

設定 → WebDAVバックアップに進み、WebDAVアドレス、ユーザー名、パスワードを設定します。
同期ポリシー（マージ/アップロードのみ/ダウンロードのみ）を選択し、自動同期間隔を設定できます。
JSONインポート/エクスポートと組み合わせて、二重バックアップを実現することをお勧めします。

5.4 ソート優先度

設定 → ソート優先度設定でアカウントのソートロジックを調整します。
現在のサイト、ヘルスステータス、チェックイン要件、カスタムフィールドなどの条件を組み合わせて並べ替えることをサポートしています。
ドラッグ＆ドロップで優先度を調整でき、不要なソートルールはいつでも無効にできます。

5.5 データインポート/エクスポート

設定 → データとバックアップの「インポートとエクスポート」エリアで、現在のアカウント設定すべてをJSONとしてワンクリックでエクスポートできます。
旧バージョンまたは他のデバイスからエクスポートされたデータのインポートをサポートしており、迅速な移行や復元に便利です。

認識またはAPI呼び出しがCloudflareによってブロックされた場合（一般的なステータスコード401/403/429）、自動的に一時ウィンドウに切り替えて再試行し、ターゲットドメインのCookieを保持します。通常、手動操作は不要です。原理についてはCloudflareシールドアシスタントを参照してください。
人間による検証が必要なシナリオに遭遇した場合は、ポップアップ表示されるアシスタントウィンドウでチャレンジを完了してください。頻繁に失敗する場合は、ネットワークを変更するか、リクエスト頻度を下げてみてください。

6. 詳細ドキュメント

7. よくある質問とサポート

認証方法、AnyRouterへの対応、機能の使用方法など、より詳細なよくある質問をご覧ください。
問題が発生した場合や新機能が必要な場合は、GitHub Issuesまでフィードバックをお寄せください。
過去の更新については、更新履歴をご確認ください。

次のステップ

基本設定が完了したら、自動更新、チェックイン検出、またはWebDAV同期を引き続き設定して、より完全な使用体験を得ることができます。