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

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

機能概要

• サイト検出：アカウント認識時にサイトにチェックインエントリがあるかを自動で判断します。アカウント詳細で「チェックイン検出」をオン/オフできます。
• カスタムチェックインURL：カスタマイズされたサイト向けに、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. 実行フロー：
   • アカウントを読み込み、スナップショットを構築します（検出が有効なアカウントは「アカウント検出ステータス」に表示されます）。
   • 条件を満たすアカウントをフィルタリングします（検出が有効、自動チェックインが許可されている、providerが存在し利用可能）。
   • checkIn.siteStatus.isCheckedInToday は実行判断に使用しません（このフィールドは信頼できません）。providerから返される already_checked が「チェックイン済み」の真の結果ソースとなります。
   • 対応するprovider（現在Veloeraが組み込まれており、拡張可能）を並行して呼び出し、成功/失敗情報を記録します。
   • 成功または already_checked は accountStorage.markAccountAsSiteCheckedIn() に書き込まれます。失敗はログに記録され、当日の再試行キューに入ります（再試行が有効な場合）。
   • 最終的に autoCheckinStorage に書き込まれ、フロントエンドページで各アカウントのステータスと再試行情報が表示されます。
4. 再スケジュール：
   • 通常のデイリー実行完了後、翌日のデイリーアラームが再計画されます（1日最大1回を保証）。
   • 当日失敗したアカウントがあり、再試行が有効な場合、再試行アラームが計画され、アカウントごとに当日の試行回数が記録されます（maxAttemptsPerDay に達すると再試行は停止します）。

ベストプラクティス

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

よくある質問

関連ドキュメント

• 自動認識トラブルシューティングガイド
• 自動更新とリアルタイムデータ
• WebDAVバックアップと自動同期
• Cloudflareシールド回避アシスタント