自動チェックインとチェックイン監視

チェックインをサポートする集約アカウントが毎日定時にチェックインし、クォータを累積し、チェックインログを同期することで、手動操作の忘れを防ぎます。

機能概要

• サイト検出：アカウント識別時にサイトにチェックインエントリがあるかを自動で判断し、アカウント詳細で「チェックイン検出」をオン/オフできます。
• カスタムチェックインエントリ：カスタマイズされたサイト向けに、customCheckInUrl と customRedeemUrl を設定でき、同時にチャージページを連動して開くかどうかを決定します。
• 自動チェックインスケジューリング：autoCheckinScheduler は chrome.alarms に基づき、指定された時間枠内でランダムにチェックインをトリガーし、すべてのアカウントが同時にアクセスするのを防ぎます。
• 実行履歴：実行ごとにログが生成され、成功/失敗の理由、最終実行時間、次回の予定時間が含まれます。「自動チェックイン」ページで確認できます。

使用前提

1. アカウント管理 → アカウント編集 で「チェックイン検出」を有効にし、手動でチェックインが成功することを確認します。
2. 自動チェックインが必要なアカウントに対して「自動チェックイン」スイッチをチェックします（デフォルトで有効、個別のアカウントで無効にできます）。
3. 設定 → 自動チェックイン でグローバル自動チェックインを有効にし、時間枠を設定します。
4. ブラウザが chrome.alarms をサポートしている必要があります（Chrome、Edge、Kiwi ブラウザは正常に動作しますが、一部のFirefoxモバイル版ではサポートされていない場合があります）。

設定手順

1. アカウントレベルのスイッチ

• 任意のアカウント詳細 → 「その他の設定」を開きます。
• 「チェックイン検出」を有効にすると、以下を設定できます：
  • カスタムチェックインURL（サイトのデフォルトエントリが利用できない場合）。
  • カスタムチャージURLおよび「チェックイン時にチャージページも開く」。
  • 「自動チェックイン」スイッチ（オフにすると、グローバルで有効になっていても、そのアカウントは自動チェックインに参加しません）。

2. グローバル時間枠

設定 → 自動チェックイン パネルで：

3. 実行ステータスの確認

• プラグインサイドバー → 自動チェックイン ページを開くと、以下を確認できます：
  • 最近の実行結果（成功 / 部分成功 / 失敗）。
  • 次回のスケジュール時間 nextScheduledAt。
  • アカウントごとのログ（所要時間、失敗理由など）。
• 「今すぐ実行」をクリックすると、デバッグのために autoCheckin:runNow を手動で一度トリガーできます。

動作原理

1. 設定の書き込み：UserPreferencesContext は autoCheckin 設定をローカル設定に保存し、sendRuntimeMessage を介してバックグラウンドに通知します。
2. スケジューリングの初期化：autoCheckinScheduler.initialize() は拡張機能の起動時にアラームリスナーを作成し、ブラウザが chrome.alarms をサポートしていれば、次回の実行時間をランダムに設定します。
3. 実行フロー：
   • すべてのアカウントを読み込み、前日の isCheckedInToday ステータスをリセットします。
   • 条件を満たすアカウントをフィルタリングします（検出が有効、自動チェックインが許可されている、まだチェックインされていない、プロバイダが存在する）。
   • 対応するプロバイダ（現在Veloeraが内蔵されており、拡張可能）を一つずつ呼び出し、リクエスト間にランダムな遅延を挿入してレート制限のトリガーを回避します。
   • 成功後には accountStorage.markAccountAsCheckedIn() を呼び出し、失敗した場合はログを記録します。
   • 最終的に autoCheckinStorage に書き込み、フロントエンドページで各アカウントのステータスを表示します。
4. 再スケジューリング：実行完了後、再度 scheduleNextRun() を呼び出し、毎日一度だけ（または設定された頻度で）トリガーされることを保証します。

ベストプラクティス

• 時間枠の推奨：成功率を高めるため、深夜またはサイトのオフピーク時間帯（例：02:00-05:00）に設定することをお勧めします。
• デバイス間同期：WebDAV バックアップと自動同期 と組み合わせることで、複数のデバイスで同じアカウントとチェックイン設定を共有し、重複チェックインを避けます。
• 異常通知：現時点では通知機能は内蔵されていません。背景ページの autoCheckinStorage を自分で監視するか、「自動チェックイン」ページで失敗記録を確認してください。

よくある質問

関連ドキュメント

• 自動更新とリアルタイムデータ
• WebDAV バックアップと自動同期
• Cloudflare シールド回避アシスタント