渐进式 Web 应用开发
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/alinaqi-maggy-pwa-development
技能介绍
要解决什么问题
把现有 Web 站点做成「可安装、可离线、首屏够快」的 PWA,容易卡在几块硬骨头:manifest 缺字段导致安装入口不出现、Service Worker 全站 cache-first 把 API 答旧数据、上线后 SW 版本不更新用户一直吃缓存。本技能按工程验收视角组织材料,而不是罗列 PWA 概念。
技能如何帮你落地
Web App Manifest 给出必填项与增强项清单:name/short_name、start_url(含统计 query)、display: standalone、192/512 图标与 Android maskable、theme_color/background_color 等,避免「能跑但装不上」。
Service Worker 与缓存策略 用表格对照五种模式:Cache First 给静态资源、Network First 给 API、Stale While Revalidate 给半静态内容,并区分 Network Only / Cache Only 的适用边界。推荐 Workbox:预缓存修订号、后台同步离线表单、ExpirationPlugin 控容量与过期。
离线与类原生体验 覆盖离线页、离线检测、Background Sync 排队;安装提示、独立窗口检测、推送与 Share Target。性能侧涉及关键渲染路径、图片与代码分割。测试含 Lighthouse 与逐项清单(可安装性、离线、Core Web Vitals、SW 更新、Manifest 展示)。
常见错误对照表 直接对应修复(无 maskable、无 offline fallback、缓存不过期、HTTPS 等)。附 Next.js、CRA、Vite+Workbox 的框架指引与上线前后 Checklist。
适用边界
技能侧重前端 PWA 实现与自测清单,不包含后端 API 设计、应用商店上架替代方案,也不替代你方生产环境的 SSL 与 CDN 运维决策。动态数据若误用 Cache First,表格中的「Stale API」项就是你该改策略的信号。
使用场景
- 现有 Vite/React 站点要加 manifest 与 Workbox,桌面 Chrome 能弹出「安装应用」
- 营销站需在弱网下仍能打开已访问页面,并为未缓存路由提供 offline.html
- 表单在断网时先本地排队,恢复网络后用 Background Sync 提交待处理请求
- 发版前按清单跑 Lighthouse PWA 项,核对 FCP/LCP 与 SW 更新是否通过
适合人员
- 负责把内部工具从纯网页升级为可装桌面的前端,需要逐项对照 manifest 与图标规范
- 维护内容站的全栈工程师,要为静态资源与 API 分别选型缓存策略避免答旧数据
- 准备在 Vite 流水线接入 Workbox 预缓存的同学,需要 revision 与过期插件的默认做法
- 上线前做 PWA 验收的 QA,要按离线、安装、Core Web Vitals 分栏打勾而非只看能打开