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

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

機能概要

• サイト検出：アカウント認識時に、サイトにチェックインエントリポイントがあるかどうかを自動的に判断します。アカウント詳細で「チェックイン検出」をオン/オフできます。
• カスタムチェックインエントリポイント：カスタムサイト向けに、customCheckInUrl と customRedeemUrl を設定でき、同時にチャージページを連携して開くかどうかを決定できます。
• 自動チェックインスケジューリング：autoCheckinScheduler は chrome.alarms に基づいて、1日1回 の通常の自動チェックインを実行し、当日失敗したアカウント に対しては個別のアラームでリトライを実行します（次の毎日計画には影響しません）。
• 実行履歴：実行ごとにログが生成され、成功/失敗の理由、最終実行時間、次の毎日計画、および（もしあれば）次のリトライ計画が含まれます。「自動チェックイン」ページで確認できます。

使用前提

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

設定手順

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

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

2. グローバル時間枠

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

3. 実行状態の確認

• プラグインサイドバー → 自動チェックイン ページを開き、以下を確認できます。
  • 最新の実行結果（成功 / 部分成功 / 失敗）。
  • 次の毎日計画時間 nextDailyScheduledAt。
  • （もしあれば）次のリトライ計画時間 nextRetryScheduledAt。
  • アカウントごとのログ（処理時間、失敗理由など）。
• 「今すぐ実行」をクリックして、autoCheckin:runNow を手動で一度トリガーできます（デバッグ用）。

動作原理

1. 設定の書き込み：UserPreferencesContext は autoCheckin 設定をローカル設定に保存し、sendRuntimeMessage を通じてバックグラウンドに通知します。
2. スケジューリングの初期化：autoCheckinScheduler.initialize() は拡張機能の起動時にアラームリスナーを作成します。
   • 毎日アラーム：通常の自動チェックイン（1日最大1回）。
   • リトライアラーム：当日の通常実行で失敗したアカウントが存在する場合にのみトリガーされます（失敗したアカウントのみリトライ）。
3. 実行フロー：
   • アカウントを読み込みスナップショットを構築します（検出が有効なアカウントは「アカウント検出状態」に表示されます）。
   • 条件を満たすアカウントをフィルタリングします（検出がオン、自動チェックインが許可されている、プロバイダが存在し利用可能）。
   • 実行するかどうかを判断するために checkIn.siteStatus.isCheckedInToday は使用しません（このフィールドは信頼できません）。プロバイダから返される already_checked が「チェックイン済み」の真の結果ソースとなります。
   • 対応するプロバイダを並行して呼び出し（現在Veloeraが組み込まれており、拡張可能）、成功/失敗情報を記録します。
   • 成功または already_checked は accountStorage.markAccountAsSiteCheckedIn() に書き込まれます。失敗した場合はログを記録し、当日のリトライキューに入ります（リトライが有効な場合）。
   • 最終的に autoCheckinStorage に書き込まれ、フロントエンドページで各アカウントの状態とリトライ情報を表示するために使用されます。
4. 再スケジューリング：
   • 通常の毎日実行が完了すると、翌日のために毎日アラームを再計画します（1日最大1回を保証）。
   • 当日失敗したアカウントが存在し、リトライが有効な場合、リトライアラームが計画され、アカウントごとに当日の試行回数を記録します（maxAttemptsPerDay に達するとリトライを停止）。

ベストプラクティス

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

よくある質問

関連ドキュメント

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