背景与目标
TrailSnap 是自托管应用,用户通常从 NAS 或家庭服务器访问。当前无 PWA 支持,导致:
- 手机浏览器无法"安装"到桌面,每次需手动输入地址
- 弱网或断网时完全不可用
- 移动端体验不如原生应用
功能范围
- 添加 Web App Manifest(应用名、图标、主题色)
- 注册 Service Worker 缓存静态资源和 API 响应
- 支持添加到主屏幕(Add to Home Screen)
- 离线模式:缓存已浏览的缩略图,离线时可查看
- 安装提示:首次访问时引导用户安装
技术方案
- 使用
vite-plugin-pwa 集成 PWA 能力
- 缓存策略:静态资源 Cache First,API 请求 Network First,缩略图 Stale While Revalidate
- Manifest 配置从
useTheme 读取主题色,保持一致性
优先级
高 — 显著提升移动端体验,是自托管应用与原生应用竞争的关键能力
背景与目标
TrailSnap 是自托管应用,用户通常从 NAS 或家庭服务器访问。当前无 PWA 支持,导致:
功能范围
技术方案
vite-plugin-pwa集成 PWA 能力useTheme读取主题色,保持一致性优先级
高 — 显著提升移动端体验,是自托管应用与原生应用竞争的关键能力