自动签到与签到监控

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

功能概览

• 站点检测：账号识别时自动判断站点是否带签到入口，可在账号详情里打开/关闭“签到检测”。
• 自定义签到入口：针对魔改站点，可配置 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 状态。
   • 过滤满足条件的账号（开启检测、允许自动签到、尚未签到、存在 provider）。
   • 逐个调用对应 provider（目前内置 Veloera，可扩展），并在请求间插入随机延迟避免触发限流。
   • 成功后调用 accountStorage.markAccountAsCheckedIn()，失败则记录日志。
   • 最终写入 autoCheckinStorage，供前端页面展示每个账号的状态。
4. 重新调度：执行完成后再次调用 scheduleNextRun()，保证每天仅触发一次（或按配置频率触发）。

最佳实践

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

常见问题

相关文档

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