chore: sync local changes (2026-03-12)

mengyanote-frontend/PWA.md

@@ -0,0 +1,28 @@
+# 萌芽笔记 PWA 说明
+
+本前端已配置为 **PWA（渐进式 Web 应用）**，支持：
+
+- **安装到桌面/主屏**：浏览器中可“安装应用”，像原生应用一样打开
+- **离线可用**：静态资源与部分 API 会被缓存，弱网/离线时可继续使用
+- **独立窗口**：安装后以独立窗口运行（无浏览器地址栏）
+
+## 图标
+
+请将应用图标放在 **`public/logo.png`**。建议尺寸：
+
+- 至少 **192×192** 像素（用于主屏图标）
+- 若有 **512×512** 像素，可同时用于启动画面等
+
+若未放置 `logo.png`，PWA 仍可正常工作，但安装图标可能为默认或空白。
+
+## 构建与部署
+
+```bash
+npm run build
+```
+
+构建产物在 `dist/`，部署后通过 **HTTPS** 访问即可使用 PWA 能力（本地预览可用 `npm run preview`）。
+
+## 开发时
+
+`vite.config.js` 中已开启 `devOptions: { enabled: true }`，开发时也会注册 Service Worker，便于调试离线与安装行为。不需要时可改为 `enabled: false`。