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

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

機能概要

• バックグラウンドタイマー: autoRefreshService によって駆動され、ブラウザのバックグラウンドで定期的にアカウント更新APIを呼び出します。60秒から数時間のカスタム間隔をサポートします。
• オープン時即時更新: オプションの「プラグインオープン時に自動更新」スイッチ。バックグラウンドタイマーをオフにしているが、データの同期を保証したいシナリオに適しています。
• 最小間隔保護: 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 バックアップと自動同期
• 権限管理（オプション権限）