PWA 实现

Purpose

让 Web 应用具备可安装、离线兜底和可控更新能力。

Procedure

1. 确认 PWA 是否值得做：面向移动端/桌面安装、弱网离线、重复访问场景时优先；纯内部后台、强实时流媒体或只需要普通缓存时不要强行 PWA。
2. 先补齐 manifest、图标、主题色和 HTML 引用；图标至少覆盖 192/512，Android 需 maskable，iOS 需 apple touch icon。
3. 注册 Service Worker，并设计更新提示；不要静默 skipWaiting() 后强刷用户页面。
4. 用 Workbox 或框架插件管理 precache/runtime cache；登录、支付、权限变更等敏感请求必须走网络。
5. 提供 offline fallback 页面和安装提示 UI，并验证首次加载、离线访问、更新激活、卸载重装。

Detailed References

• Load references/manifest-and-icons.md for manifest fields, HTML links, icon requirements, screenshots, and iOS notes.
• Load references/service-worker-workbox.md for Service Worker registration, Workbox strategies, Vite integration, offline fallback, and update flow.

Constraints

• Service Worker 仅在 HTTPS 下工作（localhost 除外）。
• 缓存策略必须区分页面、静态资源、API 与敏感操作；不要把登录、支付、权限接口缓存起来。
• Service Worker 更新有生命周期延迟；用户可见刷新提示优先于强制刷新。
• iOS PWA 能力弱于 Android，安装、推送和生命周期都要单独验证。
• 缓存有配额和逐出机制，必须设置 max entries / max age。

Expected Output

产出可安装的 Web 应用、离线 fallback、可见更新提示和明确缓存策略。验证 Lighthouse PWA、DevTools Application 面板、离线模式、更新发布和移动端安装流程。