Skip to content

Commit 4979757

Browse files
committed
docs: PWA 设计文档修订——移动端本轮仅布局+功能,不含 UI 视觉美化
1 parent dadce0c commit 4979757

1 file changed

Lines changed: 21 additions & 13 deletions

File tree

‎docs/superpowers/specs/2026-08-16-pwa-mobile-design.md‎

Lines changed: 21 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# 熵减移动端 PWA 版设计(MVP:课堂助手 + 空白笔记 + 番茄钟)
22

3-
> 日期:2026-08-16 | 状态:待评审 | 分支:dev
3+
> 日期:2026-08-16 | 状态:待评审(v2:移动端本轮仅布局+功能,不含 UI 视觉美化) | 分支:dev
44
> 背景:评估"把当前 Electron 桌面项目移植到 iOS/Android"的工作量后,确认走项目既定策略
55
> (PWA 优先,见 docs/product/requirements-pool.md EXP-006 与 docs/Foresight/innovation-features-catalog.md),
66
> 首批范围锁定三个功能 + 桌面↔移动数据同步。
@@ -24,6 +24,13 @@
2424
- 系统级"全局快捷键/侧边栏截屏识别"(移动浏览器平台禁止采集其他 App 画面)——Phase 2 用 iOS Share Extension / Android 分享意图近似替代
2525
- 端侧 WASM 流式转写——Phase 1.5 可选项(见 §5)
2626
- 其余 24 个功能模块的移动端适配
27+
- **移动端 UI 视觉设计/美化**(主题打磨、动效、设计系统细化)——本轮只保证**布局可用 + 功能完整**,视觉打磨放 Phase 2
28+
29+
### 1.3 布局与功能约束(本轮范围边界)
30+
31+
- **做**:响应式布局(360–430px 常见宽度下无横向溢出、无遮挡、可滚动)、触摸可用(点击目标、手势、虚拟键盘适配)、功能链路完整
32+
- **不做**:视觉美化(配色/字体/间距打磨、入场动效、3D 视觉降级之外的展示优化)、移动端专属视觉设计
33+
- 判定标准:移动端"能用、不破、功能通",视觉细节后续阶段补齐
2734

2835
## 2. 现状盘点(关键事实)
2936

@@ -96,14 +103,14 @@ StreamingAsrProvider 接口(新增,client/src/lib/asr/)
96103

97104
| 工作项 | 工期 | 说明 |
98105
|--------|------|------|
99-
| 横切基建(PWA 构建/部署、移动端导航与布局、iOS Safari 细节、音频手势解锁) | 1–1.5 周 | VitePWA 已配置 |
100-
| 番茄钟(UI 适配 + 通知流程) | 1–1.5 周 | 计时引擎已就绪(F3) |
101-
| 空白笔记(编辑器移动适配、存储验证、剪藏/PDF 浏览器替代) | 2.5–3.5 周 | 最大单项是编辑器触控/键盘适配 |
102-
| 课堂助手-录音转写(WebCaptureAdapter + 云端分段 ASR) | 3–4.5 周 | 60 处 IPC 中捕获链路需重写 |
106+
| 横切基建(PWA 构建/部署、移动端导航与响应式布局、iOS Safari 细节、音频手势解锁) | 1 周 | VitePWA 已配置;仅布局结构,无视觉打磨 |
107+
| 番茄钟(响应式布局 + 通知流程) | 0.5–1 周 | 计时引擎已就绪(F3),纯布局+功能验证 |
108+
| 空白笔记(编辑器布局适配、存储验证、剪藏/PDF 浏览器替代) | 2–3 周 | 编辑器触摸/虚拟键盘/溢出是功能性问题,必须处理;不做视觉 |
109+
| 课堂助手-录音转写(WebCaptureAdapter + 云端分段 ASR) | 3–4 周 | 60 处 IPC 中捕获链路需重写,功能为主 |
103110
| 课堂助手-视频转笔记(文件选择 + 上传 + 复用 analyze-video) | 0.5–1 周 | 后端现成(F6) |
104111
| 桌面 ↔ 移动同步(账号绑定 + 浏览器端验证) | 1–2 周 | 底子已具备(F8) |
105-
| 联调 + 移动端测试 + 打磨 | 1–1.5 周 | 双端回归 |
106-
| **合计** | **约 10–15 周(≈2.5–3.5 人月)** | 2 人并行约 6–8 周 |
112+
| 联调 + 移动端测试 + 打磨 | 1 周 | 双端回归;打磨仅限功能/布局缺陷 |
113+
| **合计** | **约 9–13 周(≈2–3 人月)** | 2 人并行约 5–7 周 |
107114

108115
可选项:
109116
- 端侧 WASM 流式转写(StreamingAsrProvider,§3.3):**+1.5–2.5 周**,体验追平 OPPO 实时感、可离线,桌面同时获得降级路径
@@ -121,12 +128,13 @@ StreamingAsrProvider 接口(新增,client/src/lib/asr/)
121128
## 6. 验收标准(MVP)
122129

123130
1. PWA 可在 iOS Safari / Android Chrome 添加到主屏幕,离线打开可用(SW 缓存)
124-
2. 番茄钟:切后台/锁屏 5 分钟再回来,计时不漂移(墙钟校准),到点通知可达
125-
3. 空白笔记:新建/编辑/搜索/文件夹/链接在移动端可用;数据持久化于 IndexedDB
126-
4. 课堂助手:麦克风录音 → 分段转写 → AI 生成结构化笔记全链路通;导入视频 → analyze-video → 笔记入库
127-
5. 桌面 ↔ 移动:同一账号登录后数据双向增量同步,离线操作入队,恢复网络后补齐
128-
6. 桌面端回归:Electron 现有功能不受影响(适配器模式,桌面路径不变)
129-
7. 仓库门禁:`npm run check` 通过(lint/typecheck×2/test)
131+
2. **布局可用**:360–430px 宽度下三个模块无横向溢出、无遮挡、可滚动,触摸/虚拟键盘可用(§1.3 标准;不含视觉美化)
132+
3. 番茄钟:切后台/锁屏 5 分钟再回来,计时不漂移(墙钟校准),到点通知可达
133+
4. 空白笔记:新建/编辑/搜索/文件夹/链接在移动端可用;数据持久化于 IndexedDB
134+
5. 课堂助手:麦克风录音 → 分段转写 → AI 生成结构化笔记全链路通;导入视频 → analyze-video → 笔记入库
135+
6. 桌面 ↔ 移动:同一账号登录后数据双向增量同步,离线操作入队,恢复网络后补齐
136+
7. 桌面端回归:Electron 现有功能不受影响(适配器模式,桌面路径不变)
137+
8. 仓库门禁:`npm run check` 通过(lint/typecheck×2/test)
130138

131139
## 7. 风险与缓解
132140

0 commit comments

Comments
 (0)