# iOS 缺失项与待补全方向

> 仅列出当前未完成的项目。已完成内容见 [`已完成/[已完成]-已实现功能汇总.md`](./已完成/[已完成]-已实现功能汇总.md)
>
> 更新时间：2026-05-17

---

## 一、后端 API 对接（当前最优先）

Auth 已对接。以下页面仍使用静态 Mock 数据，待接后端：

| 页面 | 需对接的 API |
|------|-------------|
| LibraryHomeView | GET /api/knowledge-bases |
| LibraryDetailPage | GET /api/knowledge-bases/:id/items |
| StudyHomeView | GET /api/learning-sessions |
| DailyThinkingPage | POST /api/active-recall/answers |
| AIFeedbackPage | GET /api/ai-analysis/:id |
| ReviewPlanView | GET /api/reviews/due |
| AnalysisHomeView | GET /api/learning-activity/summary |

---

## 二、架构层待推进

### ViewModel 迁移（部分完成）

ReviewPlanViewModel、AIChatViewModel、StudyHomeViewModel 已完成。其余页面仍为 View 内聚状态，待逐步迁移。

### Repository 层

当需要本地缓存 + 网络切换时再建，当前阶段不紧急。

---

## 三、动效

计划要求（P0）：页面过渡、按钮反馈、加载状态、AI 分析中状态、学习完成反馈。当前仅有基础 SwiftUI 隐式动画。

---

## 四、无障碍

关键按钮添加 `.accessibilityLabel`，确保 Dynamic Type 下布局不破碎，重点页面 VoiceOver 测试。

---

## 五、测试

- ViewModel 单元测试
- Service 层单元测试（Mock Repository）
- 关键 UI 流程 Snapshot 测试

---

## 六、CI/CD

- GitHub Actions / Xcode Cloud 自动构建
- TestFlight 自动分发
- 崩溃监控（Firebase Crashlytics 或类似）

---

## 七、Tab 结构调整（待决策）

当前 5-Tab（AI | 知识库 | 学习 | 分析 | 我的），存在 AI/学习边界模糊、分析 Tab 内容单薄等问题。

建议 MVP 阶段保持现状，收集用户反馈后优先尝试"分析并入学习"（4 Tab）。

---

## 八、数据埋点

- 产品行为事件追踪（app_opened、knowledge_base_created、active_recall_submitted 等）
- 可先用 PostHog / Firebase

---

## 当前最应该推进

```text
1. 后端 API 对接（知识库列表 → 学习会话 → 复习 → 学习活跃）
2. ViewModel 层逐步迁移（不阻塞功能）
3. 动效补充（页面过渡 + AI 分析中状态）
4. 无障碍基础适配
```