Skip to content

[Feature] PWA 离线支持:移动端可安装与离线浏览缓存 #69

Description

@LC044

背景与目标

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 读取主题色,保持一致性

优先级

— 显著提升移动端体验,是自托管应用与原生应用竞争的关键能力

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions