pwa更新策略核心是“静默准备+智能切换”，通过禁用index.html强缓存、sw安装即生效（skipwaiting+clients.claim）、版本比对静默预检三步实现无感更新。
要让用户无感知获取最新版本代码，PWA 更新策略的核心不是“强制刷新”，而是“静默准备 + 智能切换”。关键在于把更新动作拆解到用户不感知的环节：资源预加载、缓存原子替换、页面生命周期协同。下面分三块说清楚。
确保 index.html 永远不被强缓存
这是最容易被忽略却最致命的一环。如果用户浏览器本地缓存了旧版 index.html，哪怕 Service Worker 已更新、新 JS/CSS 都已缓存，页面加载时仍会执行旧 HTML 中的脚本，导致整个应用卡在旧版本。
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 给 /index.html 设置响应头：
Cache-Control: no-cache, must-revalidate或max-age=0 - 若使用 CDN 或 Nginx，单独配置该路径的缓存策略，禁止长缓存
- 避免在 HTML 中硬编码资源路径；推荐用构建时注入 hash 的文件名（如
app.a1b2c3.js），让静态资源可长期缓存，而 HTML 始终走服务器校验
Service Worker 版本升级要“安装即生效”，不等下次访问
默认情况下，新注册的 SW 会在下次页面打开时才激活。要实现“当前页就用新版”，需主动触发跳过等待（skipWaiting）并控制客户端更新时机。
- 在 SW 的
install事件中调用self.skipWaiting() - 在
activate事件中调用clients.claim()，让当前页面立即受控 - 页面内监听
controllerchange事件，在检测到控制器切换后，可选择局部重载模块（如 React.lazy 动态组件），而非整页location.reload()
用“版本号+静默预检”替代弹窗强制刷新
真正的无感，是连提示都不出现。可通过构建时注入版本号 + 后台比对，只在必要时才干预。
- 构建时将版本写入全局变量：
window.APP_VERSION = '2.4.1' - 页面启动后，向服务端请求当前最新版本（如
/api/version），对比不一致则后台静默拉取新资源到 Cache Storage - 仅当检测到关键逻辑变更（如 API 协议升级、路由结构变化）或用户处于空闲状态（
document.hidden === true）时，才触发一次轻量级更新（例如重新 fetch 当前页面数据、热替换部分模块） - 完全避免在用户输入中、动画进行时、表单未提交等敏感时刻执行 reload
