# ADR-002 PWA 优先验证市场，再做 Capacitor 原生打包

**状态：** 已采纳 ✅  
**日期：** 2026-05-24

---

## 背景

App 需要在手机上使用，面临两个选择：直接打包成原生 App，或先做 PWA 验证需求。

## 决策

**Phase 2 先做 PWA**，让用户在手机浏览器「添加到主屏幕」使用。确认产品有市场价值后，**Phase 3 再用 Capacitor 打包** Android APK / iOS IPA。

## 原因

- PWA 只需加 `manifest.json` + Service Worker，改动极小
- Capacitor 打包需要引入 Vite、替换存储方案、配置 Android Studio / Xcode，成本高
- 先用 PWA 以最低成本验证：用户留存率、复盘频率、AI 功能使用率
- 验证有价值后再投入打包成本，避免过早优化

## 影响

- Artifact Storage API 是 Claude 平台专属，PWA 独立部署后需替换为 localStorage
- iOS Safari 对 PWA 支持有限，是已知限制，PWA 阶段接受
- Capacitor 打包触发条件：Phase 2 验证指标达标