用途：为 Web 应用添加渐进式 Web 应用（PWA）配置，实现类原生浏览体验，支持用户将应用“安装”到主屏幕，并适配 iPhone 等刘海屏设备。
主要能力：提供 Web App Manifest 配置（应用元数据与图标、start_url、display 独立模式、主题色、快捷方式、分类）；移动端 meta 标签与 viewport 配置（含 appleWebApp、themeColor、viewportFit: 'cover'）；安全区域 CSS（safe-area-bottom、safe-area-top、safe-area-all 使用 env(safe-area-inset-*)）；安装提示 Hook 与横幅组件（监听 beforeinstallprompt，调用 prompt 获取用户选择）；移动导航安全区域适配；图标要求说明（icon-192、icon-512、maskable 图标、apple-touch-icon 180x180、favicon）及 maskable 图标安全区示意。
使用方式：以 Next.js + TypeScript 为例，创建 app/manifest.ts 导出 MetadataRoute.Manifest，在 app/layout.tsx 中配置 metadata 与 viewport，在 globals.css 中加入安全区域类，使用 useInstallPrompt Hook 与 InstallBanner 组件展示安装提示，MobileNav 组件配合 safe-area-bottom。测试可通过 Chrome DevTools → Application → Manifest、Lighthouse PWA 审计及移动端“添加到主屏幕”进行；可用 matchMedia('(display-mode: standalone)') 或 navigator.standalone 检测独立模式。
适用场景：希望用户安装 Web 应用到主屏幕、需要类原生行为、需适配刘海屏设备、需自定义安装提示体验的项目。
限制与注意：资料未提供具体安装命令、收费或价格信息，暂未提供。避免常见错误：缺失 maskable 图标、未处理安全区域、过早弹出安装提示、start_url 错误、缺少 apple-touch-icon；建议使用带安全区的 maskable 图标、主题色匹配品牌、在合适时机展示安装提示并在真实移动设备上测试。