WangDL
0eb5f53873
- iOS integration readiness audit (blocker list, module map, deployment check) - CAPI contract for iOS (15 modules, 80+ endpoints) - CAPI error codes and status enums - iOS auth flow, file upload import flow, learning review flow - Web product page nginx fix (reenable longde.cloud) Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
134 lines
4.6 KiB
Markdown
134 lines
4.6 KiB
Markdown
# iOS 学习与复习流程
|
||
|
||
> 版本：0.1.0 | 更新：2026-05-24
|
||
|
||
## 整体流程
|
||
|
||
```
|
||
创建知识库 → 上传资料 → 导入知识点 → 开始学习 → 主动回忆 → AI 分析 → 复习巩固
|
||
```
|
||
|
||
## 1. 学习会话
|
||
|
||
```
|
||
POST /api/learning-sessions
|
||
{ mode: "active_recall", knowledgeBaseId: "kb-1" }
|
||
────────────────────────► 创建会话 (status=active)
|
||
◄─────────────────────── { id, startedAt, mode }
|
||
|
||
...学习过程...
|
||
|
||
POST /api/learning-sessions/:id/end
|
||
────────────────────────► 结束会话 (status=completed)
|
||
记录 durationSeconds
|
||
◄─────────────────────── { id, durationSeconds }
|
||
```
|
||
|
||
**mode 枚举：** `active_recall` | `feynman` | `review` | `reading`
|
||
|
||
## 2. 主动回忆
|
||
|
||
```
|
||
GET /api/active-recalls?page=1&limit=20
|
||
◄─────────────────────── 题目列表（含问题/选项）
|
||
|
||
POST /api/active-recalls/:id/submit
|
||
{ answer: "用户答案" }
|
||
────────────────────────► 记录回答 → 触发 AI 分析
|
||
(异步：BullMQ ai-analysis 队列)
|
||
◄─────────────────────── { success: true }
|
||
```
|
||
|
||
## 3. AI 分析
|
||
|
||
```
|
||
POST /api/ai-analysis
|
||
{ ... }
|
||
────────────────────────► 创建分析作业
|
||
|
||
GET /api/ai-analysis/jobs/:id
|
||
◄─────────────────────── { status: "pending|processing|completed|failed" }
|
||
|
||
GET /api/ai-analysis/:id
|
||
◄─────────────────────── 分析结果（强项/弱项/建议）
|
||
```
|
||
|
||
**分析完成后自动生成：**
|
||
- ReviewCard（复习卡片，SM-2 算法调度）
|
||
- FocusItem（薄弱项，待巩固）
|
||
|
||
## 4. 复习（SM-2 间隔重复）
|
||
|
||
```
|
||
GET /api/reviews/due
|
||
◄─────────────────────── 今日待复习卡片列表
|
||
[{
|
||
id, frontText, difficulty,
|
||
scheduleState, intervalDays,
|
||
repetitionCount, lapseCount
|
||
}]
|
||
|
||
POST /api/reviews/:id/submit
|
||
{ quality: 4 }
|
||
────────────────────────► 提交复习质量评分 (0-5)
|
||
SM-2 算法更新:
|
||
- easeFactor
|
||
- intervalDays
|
||
- nextReviewAt
|
||
- scheduleState
|
||
◄─────────────────────── { id, nextReviewAt, intervalDays }
|
||
```
|
||
|
||
**scheduleState：** `new` → `learning` → `review` → `relearning`
|
||
|
||
**quality 评分指南：**
|
||
|
||
| 评分 | 含义 |
|
||
|------|------|
|
||
| 0 | 完全忘记 |
|
||
| 1 | 错误，有印象 |
|
||
| 2 | 错误，但正确答案看起来很熟悉 |
|
||
| 3 | 正确，但费了很大劲 |
|
||
| 4 | 正确，有些犹豫 |
|
||
| 5 | 完美，毫不费力 |
|
||
|
||
## 5. 薄弱项跟踪
|
||
|
||
```
|
||
GET /api/focus-items?status=open
|
||
◄─────────────────────── [{ id, title, priority, status }]
|
||
|
||
POST /api/focus-items/:id/complete
|
||
────────────────────────► 标记为已掌握
|
||
◄─────────────────────── { id, status: "completed" }
|
||
```
|
||
|
||
**priority 枚举：** `high` | `normal` | `low`
|
||
|
||
## 6. 学习统计
|
||
|
||
```
|
||
GET /api/activity/heatmap
|
||
◄─────────────────────── [{ date, count }] 365 天热力图数据
|
||
|
||
GET /api/activity/streak
|
||
◄─────────────────────── { currentStreak, longestStreak }
|
||
|
||
GET /api/activity/summary
|
||
◄─────────────────────── { totalSessions, totalDuration, ... }
|
||
```
|
||
|
||
## 完整学习主链路
|
||
|
||
```
|
||
1. 创建/选择知识库 POST /api/knowledge-bases
|
||
2. 上传资料 POST /api/files/upload-url → PUT COS → POST /api/files/complete
|
||
3. 创建来源 + 导入 POST /api/knowledge-bases/:id/sources
|
||
4. 轮询导入状态 GET /api/imports/:id/status
|
||
5. 开始学习会话 POST /api/learning-sessions
|
||
6. 主动回忆练习 GET/POST /api/active-recalls
|
||
7. AI 分析 POST /api/ai-analysis
|
||
8. 每日复习 GET /api/reviews/due → POST /api/reviews/:id/submit
|
||
9. 跟踪薄弱项 GET → POST /api/focus-items/:id/complete
|
||
```
|