自動更新とリアルタイムデータ

アカウント残高、使用量、モデルリストを常に最新の状態に保ち、毎回手動で「更新」をクリックする必要はありません。バックグラウンドタイマーとポップアップオープン時の即時更新という二重の戦略を提供します。

機能概要

• バックグラウンドタイマー：autoRefreshService によって駆動され、ブラウザのバックグラウンドで定期的にアカウント更新APIを呼び出します。10秒から数時間までのカスタム間隔をサポートします。
• 開くと同時に更新：オプションの「プラグインを開いたときに自動更新」スイッチは、バックグラウンドタイマーをオフにしているが、データの同期を保証したいシナリオに適しています。
• 最小間隔保護：minInterval を個別に設定することで、頻繁な手動更新がサイトのリスク管理をトリガーするのを防ぎます。
• 即時更新：「今すぐ更新」をいつでも実行し、すべてのサイトの最新の残高/クォータ（額度）を即座に取得します。

前提条件

1. 少なくとも1つのサイトアカウントが正常に追加されていること。
2. ブラウザは拡張機能を実行し続ける必要があります（モバイル版のKiwi/Firefoxでも可能ですが、ブラウザがシステムによって強制終了されていないことを確認する必要があります）。
3. サイトにCloudflare保護がある場合は、まずCloudflare シールドアシスタントを参照して検証を完了してください。

設定エントリ

1. プラグインを開く → 設定。
2. **「基本設定 → 自動更新」**タブを選択し、RefreshSettings パネルに入ります。

主要設定項目

動作原理

1. ユーザーが設定を保存すると、UserPreferencesContext を介して accountAutoRefresh がローカル設定に書き込まれます。
2. バックグラウンドページが RuntimeActionIds.AutoRefreshUpdateSettings（wire: autoRefresh:updateSettings）メッセージを受信すると、autoRefreshService.setupAutoRefresh() を呼び出します。
   • スイッチがオフになっているか、設定が不完全な場合はタイマーを停止します。
   • それ以外の場合は、間隔に基づいて setInterval を作成し、定期的に accountStorage.refreshAllAccounts(false) を実行します。
3. 更新結果（成功/失敗）は AUTO_REFRESH_UPDATE メッセージを介してフロントエンドにブロードキャストされ、ポップアップが開いていない場合はサイレントに無視されます。

推奨戦略

• 高頻度チェック：主要なアカウントは300～600秒に設定し、残高アラートがタイムリーに届くようにすることをお勧めします。
• 低頻度 + 開くと同時に更新：サイトのレート制限が心配な場合は、バックグラウンドタイマーをオフにし、「開くと同時に更新」のみを保持できます。
• 通知との連携：ブラウザの通知またはスクリプトと連携し、AUTO_REFRESH_UPDATE をリッスンして二次開発によるリマインダーを実装します。

よくある質問

関連ドキュメント

• Cloudflare シールドアシスタント
• 自動チェックイン
• WebDAV バックアップと自動同期
• 権限管理（オプション権限）