让账号余额、用量、模型列表保持最新，无需每次手动点击“刷新”。同时提供后台定时器与弹窗打开时的即时刷新双重策略。
- 后台定时器：由
autoRefreshService 驱动，在浏览器后台定时调用账号刷新接口，支持 10 秒～数小时的自定义间隔。 - 打开即刷新：可选的“打开插件时自动刷新”开关，适合关闭后台定时器但仍想保证数据同步的场景。
- 最小间隔保护：独立设置
minInterval 防止过于频繁的手动刷新触发站点风控。 - 即时刷新：随时执行“立即刷新”，立刻获取所有站点最新余额/额度。
- 至少已成功添加一个站点账号。
- 浏览器需保持扩展运行（移动端 Kiwi/Firefox 亦可，但需确保浏览器未被系统杀死）。
- 若站点存在 Cloudflare 防护，请先参考 Cloudflare 过盾助手 完成校验。
- 打开插件 → 设置。
- 选择 “基础设置 → 自动刷新” 选项卡，进入
RefreshSettings 面板。
| 选项 | 说明 |
|---|
| 启用自动刷新 | 控制后台定时器的开关；关闭后仅保留手动刷新。 |
| 刷新间隔（秒） | 定时器运行周期，对应 accountAutoRefresh.interval。输入 <10 秒会被拦截提示。 |
| 打开插件时自动刷新 | 每次点击浏览器图标打开弹窗时自动执行一次 refreshNow()。 |
| 最小刷新间隔（秒） | 限制用户频繁点击“刷新”按钮；默认 60 秒。 |
| 恢复默认 | 调用 resetAutoRefreshConfig()，恢复到 360s/60s/启用状态。 |
- 用户保存设置后，通过
UserPreferencesContext 将 accountAutoRefresh 写入本地偏好。 - 背景页收到
updateAutoRefreshSettings 消息，调用 autoRefreshService.setupAutoRefresh()： - 若开关关闭或配置不完整则停止定时器。
- 否则根据间隔创建
setInterval，周期性执行 accountStorage.refreshAllAccounts(false)。
- 刷新结果（成功/失败）会通过
AUTO_REFRESH_UPDATE 消息广播到前端，若弹窗未打开则静默忽略。
- 高频检查：核心账号建议设置 300～600 秒，保证余额告警及时。
- 低频 + 打开刷新：若担心站点限流，可将后台定时器关闭，仅保留“打开即刷新”。
- 配合通知：结合浏览器自身通知或脚本，监听
AUTO_REFRESH_UPDATE 以二次开发提醒。
| 问题 | 解决方案 |
|---|
| 定时刷新未触发 | 可能是浏览器被系统休眠，重新打开扩展或手动点击“立即刷新”；必要时尝试降低间隔。 |
| 频繁触发 Cloudflare 限流 | 适当增大刷新间隔，并确保 Cloudflare 过盾助手 能正常弹窗校验。 |
| 刷新失败且提示 401/403 | 登录状态已失效，重新在浏览器访问对应站点并刷新插件。 |
| 多设备冲突 | 建议配合 WebDAV 备份与自动同步 统一账号数据，避免重复刷新同一站点。 |
