自动签到与签到监控

让支持签到的聚合账号每天按时签到、累计额度，并同步签到日志，避免人工忘记操作。

功能概览

• 站点检测：账号识别时自动判断站点是否带签到入口，可在账号详情里打开/关闭“签到检测”。
• 自定义签到入口：针对魔改站点，可配置 customCheckInUrl 与 customRedeemUrl，同时决定是否联动打开充值页面。
• 自动签到调度：autoCheckinScheduler 基于 chrome.alarms 执行 每日一次 的常规自动签到，并对 当日失败账号 通过独立闹钟进行重试（不会影响下一次每日计划）。
• 执行记录：每次运行会产生日志，包含成功/失败原因、最后运行时间、下次每日计划以及（如有）下次重试计划，可在「自动签到」页面查看。

使用前提

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() 在扩展启动时创建闹钟监听：
   • 每日闹钟：常规自动签到（每天最多一次）。
   • 重试闹钟：仅在当日常规运行存在失败账号时触发（只重试失败账号）。
3. 执行流程：
   • 读取账号并构建快照（启用检测的账号会显示在「账号检测状态」里）。
   • 过滤满足条件的账号（开启检测、允许自动签到、存在 provider 且可用）。
   • 不会使用 checkIn.siteStatus.isCheckedInToday 判断是否执行（该字段不可信）；由 provider 返回 already_checked 作为“已签到”的真实结果来源。
   • 并发调用对应 provider（目前内置 Veloera，可扩展），并记录成功/失败信息。
   • 成功或 already_checked 会写入 accountStorage.markAccountAsSiteCheckedIn()；失败会记录日志并进入当日重试队列（若已启用重试）。
   • 最终写入 autoCheckinStorage，供前端页面展示每个账号的状态与重试信息。
4. 重新调度：
   • 常规每日运行完成后，会为下一天重新计划每日闹钟（确保每日最多一次）。
   • 当日存在失败账号且启用重试时，会计划重试闹钟，并按账号维度记录当日尝试次数（达到 maxAttemptsPerDay 后停止重试）。

最佳实践

• 时间窗建议：设置在凌晨或站点低峰期（例如 02:00-05:00），提高成功率。
• 跨设备同步：结合 WebDAV 备份与自动同步，确保多设备共用同一份账号与签到设置，避免重复签到。
• 异常通知：暂未内置通知，可自行监听背景页 autoCheckinStorage 或查看「自动签到」页面发现失败记录。

常见问题

相关文档

• 自动刷新与实时数据
• WebDAV 备份与自动同步
• Cloudflare 过盾助手