SimplexityAI 自动更新机制源码解析：12 小时轮询、指数退避重试与版本比较的完整实现

SimplexityAI 自动更新机制源码解析：12 小时轮询、指数退避重试与版本比较的完整实现

【免费下载链接】simplexity-ai-appCommunity-driven P.... AI desktop app powered by Electron, bringing powerful AI language intelligence straight to your desktop.项目地址: https://gitcode.com/gh_mirrors/pe/simplexity-ai-app

SimplexityAI 是一款基于 Electron 的社区驱动 AI 桌面应用，将 Perplexity AI 的语言智能能力带到桌面。它的自动更新系统用不到 150 行代码实现了 12 小时轮询检查、指数退避重试和语义化版本比较，堪称轻量级桌面应用更新的最佳实践。

架构总览：三层协作的更新流程 🧩

整个自动更新机制分布在三个层中，职责清晰：

用户视角下的完整链路是：应用启动 → 等待 12 小时窗口 → 后台静默检查 → 发现新版本 → 弹出模态更新窗口 → 用户选择"立即下载"或"明天提醒"。

SimplexityAI 桌面应用主界面——更新检查就在这个窗口加载完成后静默启动

第一步：12 小时轮询周期是怎么实现的？

轮询的核心是一个简单但精妙的时间戳守卫，位于 main.js：

const UPDATE_CHECK_INTERVAL = 12 * 60 * 60 * 1000; // 每 12 小时检查一次

三个设计细节值得新手注意：

1. 时间戳持久化：lastUpdateCheck通过electron-store写入磁盘（main.js#L1124-L1126），并在应用启动时读回（main.js#L1522）。也就是说，即使你每天开 10 次应用，12 小时内只会在后台检查一次，不浪费流量。

2. 延迟触发：检查不放在启动关键路径上，而是等主窗口did-finish-load事件完成后才调用（main.js#L543），避免拖慢首屏加载。

3. 随机抖动：发起真正请求前有一个 0~5 秒的随机延迟（main.js#L1070-L1071），让成千上万用户的请求在时间轴上"散开"，避免整点请求风暴打满服务端。

if (lastUpdateCheck !== 0 && (currentTime - lastUpdateCheck < UPDATE_CHECK_INTERVAL)) { console.log('Skipping update check - checked recently'); return; }

💡新手要点：这种"时间戳守卫 + 持久化"模式是轮询类功能的通用解法，比setInterval更适合"应用可能随时被杀死"的桌面场景。

第二步：指数退避重试——网络不稳时的三道防线

真正的网络检查在performUpdateCheck函数中完成（main.js#L1074-L1149），它用 Electron 内置的net.request拉取远端仓库main分支的package.json，从中读取最新version字段。

针对网络世界的各种"意外"，代码设置了层层防线：

🛡️ 防线一：15 秒超时

let timeoutId = setTimeout(() => { request.abort(); // 超时就掐断请求 }, 15000);

请求 15 秒无响应直接中止，绝不卡死应用。

🛡️ 防线二：指数退避重试（核心亮点）

超时、HTTP 错误、网络异常，三种失败都会进入同一条重试路径：

const backoffTime = Math.pow(2, retryCount) * 3000; // 指数退避

• 第 1 次失败 → 等3 秒重试
• 第 2 次失败 → 等6 秒重试
• 第 3 次失败 → 等12 秒重试
• 仍失败 → 放弃，静默等待下一个 12 小时窗口

最多重试 3 次（main.js#L1075）。相比"固定间隔重试"，指数退避在服务端压力大时能迅速"退让"，给对方喘息空间——这也是整个互联网服务处理瞬时故障的标准姿势。

🛡️ 防线三：429 限流快速放弃

if (response.statusCode === 429) { console.log('Rate limited while checking for updates. Will try again later.'); return; }

收到限流信号时不重试、立即收手，把重试机会留给下个周期。这是一个很容易被忽略的细节：盲目重试限流接口只会让情况更糟。

另外，请求 URL 上附加了时间戳参数（main.js#L1077-L1078）用于绕过 CDN 缓存，确保拿到的永远是最新package.json；User-Agent中带上当前版本号（main.js#L1085），方便服务端统计各版本用户分布。

第三步：版本比较——几行代码胜过一堆依赖

拿到最新版本号后，用一个极简的语义化版本比较函数决定是否需要弹窗（main.js#L1151-L1163）：

function compareVersions(v1, v2) { const parts1 = v1.split('.').map(Number); const parts2 = v2.split('.').map(Number); for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) { const part1 = parts1[i] || 0; const part2 = parts2[i] || 0; if (part1 > part2) return 1; if (part1 < part2) return -1; } return 0; }

它把"5.0.0"这样的版本号按.拆开逐段比较，缺失段按 0 补齐，返回1（有新版本）、-1（旧版本）或0（相同）。只有返回1时才会触发更新弹窗（main.js#L1128-L1130）。

💡新手要点：对于只有major.minor.patch的数字版本，自写 10 行比较函数比引入semver这样的依赖更轻量——当然，如果你的版本带beta、rc等预发布标记，那就该请出专业库了。

第四步：更新弹窗与"明天提醒"的巧妙实现 ⏰

发现新版本后，showUpdateWindow会创建一个 550×520 的无边框模态窗口（main.js#L1165-L1194），加载 update.html。窗口启用了contextIsolation并关闭nodeIntegration，通过 preload_update.js 只暴露 4 个安全 API：接收版本号、关闭窗口、下载更新、明天提醒。

弹窗中的 Release Notes 由渲染进程拉取对应版本的 Markdown 文件，经marked渲染并用DOMPurify净化后才插入页面（src/js/renderer/update_renderer.js#L31-L59），防范 XSS 注入——远程内容渲染时的标准安全姿势。

三个按钮对应三种用户心态：

• Download Update：调用shell.openExternal打开最新版本发布页，由系统浏览器完成下载（main.js#L1047-L1057）。不接管下载过程，把选择权交给用户。
• Remind Me Tomorrow：最巧妙的一招——把lastUpdateCheck直接倒拨 23 小时（main.js#L1034-L1045）。下次启动时，12 小时守卫自然判定"早该检查了"，于是再次提醒。没有额外的定时器、没有新的字段，完全复用了已有的轮询机制。
• 关闭：本次会话不再打扰，12 小时后自然再来。

小结：这套机制值得你抄走的设计清单 ✅

对于正在开发 Electron 桌面应用的新手来说，这套"轻量轮询 + 指数退避 + 极简版本比较"的组合拳，比重量级自动更新框架更易理解、更易定制，完全可以作为你项目的起点参考。

【免费下载链接】simplexity-ai-appCommunity-driven P.... AI desktop app powered by Electron, bringing powerful AI language intelligence straight to your desktop.项目地址: https://gitcode.com/gh_mirrors/pe/simplexity-ai-app