PWA 客户端

Magicmail 前端是一个完整的 渐进式 Web 应用 (PWA)，提供接近原生应用的使用体验。

安装到设备

桌面浏览器

• Chrome / Edge：点击地址栏右侧的「安装」图标（或在菜单中选择「安装 Magicmail」）
• 系统要求：Chrome 70+、Edge 79+

移动浏览器

• iOS Safari：点击分享按钮 → 「添加到主屏幕」
• Android Chrome：系统会自动弹出安装提示

安装后 Magicmail 会作为独立应用运行，没有浏览器地址栏干扰。

离线访问

Service Worker 会缓存以下资源：

• HTML 入口和核心 JS/CSS
• 图标和字体资源
• 已加载过的页面

::: note 离线限制 离线模式下可以浏览已缓存的邮件内容，但无法进行需要网络的操作（如发送邮件、同步新邮件）。 :::

深色模式

自动跟随系统

默认情况下，PWA 会跟随操作系统的深色/浅色模式设置自动切换。

手动切换

在设置中心可以固定使用浅色或深色主题，不受系统影响。

主题色定制

在设置中心可以自定义主题色（Accent Color），会影响：

• 按钮、链接、选中状态的高亮颜色
• 浏览器地址栏的主题色
• PWA 启动画面的背景色

响应式适配

设备宽度	布局行为
≥ 1024px (桌面)	双栏布局：左侧导航 + 右侧内容区
768px ~ 1023px (平板)	可折叠侧边栏 + 内容区
< 768px (手机)	单栏布局，底部导航，全屏邮件详情

浏览器兼容性

浏览器	最低版本
Chrome	90+
Firefox	90+
Safari	15+
Edge	90+
Samsung Internet	15+