# iOS — 进行中

> 更新时间：2026-05-18
> 关联：[总待完成清单](../总待完成清单.md)

---

## 🔴 I18 — 学习页面（核心缺失）

**状态**：待设计
**决策**：🔴 需你决策

**现状**：当前没有真正的学习交互页面。StudyHomeView 有会话列表/入口，但没有「开始学习」的完整流程。

**需要你决策**：
1. 竞品参考：选 1-2 个学习 App 作为交互参考（多邻国/Anki/得到/极客时间？）
2. 学习流程定义：单次学习会话的步骤（选择知识点 → 看内容 → 主动回忆 → AI 评估 → 复习卡片？）
3. 是否先做一个最简版本（只有"看内容+回答问题"）再迭代？

**技术侧待架构**：
- [ ] 学习状态机设计（idle / learning / recalling / reviewing / done）
- [ ] 进度可视化组件
- [ ] 会话中 AI 实时反馈交互

---

## 🔵 I19 — 知识库预览页

**状态**：待设计
**决策**：🔵 需架构设计

**现状**：LibraryHomeView 有知识库列表，LibraryDetailPage 有知识点列表，但没有「知识点内容预览/浏览」页面。

**子任务**：
- [ ] 知识点详情/预览页交互设计（卡片式/全屏阅读/脑图？）
- [ ] 知识点间导航（上一条/下一条/相关）
- [ ] 与学习会话的入口衔接

---

## 🔵 I32 — 知识库创建页面

**状态**：待设计
**决策**：🔵 需架构设计

**背景**：用户提到"目前还没有创建知识库"。LibraryHomeView 可能有入口，但创建流程不完整。

**子任务**：
- [ ] 知识库创建表单（命名/描述/封面图/方向选择）
- [ ] 创建后自动跳转 + 导入引导
- [ ] 与后端 POST /api/knowledge-bases 对接

---

## 🔵 I20 — 模块功能审计

**状态**：待开始
**决策**：🔵 需架构设计

**背景**：用户反馈"每个页面都有了，但是页面功能还是不太对"。

**子任务**：
- [ ] 逐个页面走查，记录"当前实际功能"vs"预期功能"
- [ ] AI 对话页：消息发送/接收/流式渲染状态
- [ ] 知识库页：创建/编辑/删除/搜索
- [ ] 学习页：会话创建/进行中/完成
- [ ] 分析页：数据展示/趋势图
- [ ] 个人页：设置/通知/反馈
- [ ] 输出差距清单 → 逐项排期

---

## 🔵 I21 — 多邻国式动画体系

**状态**：待设计
**决策**：🔵 需架构设计

**子任务**：
- [ ] 拆解多邻国核心动画模式（正确/错误反馈、升级动画、连胜动画、进度环）
- [ ] 设计 ZXAnimation 组件库扩展方案
- [ ] 现有 ZXAnimations.swift（6 个组件）差距分析

---

## 🔵 I22 — AI 页面优化

**状态**：待设计
**决策**：🔵 需架构设计

**子任务**：
- [ ] AI 模型切换 UI（DeepSeek / MiniMax / Auto）
- [ ] Agent 模式入口设计
- [ ] 对话历史管理
- [ ] 流式响应渲染优化

---

## 🔵 I23 — AI 语音识别

**状态**：待设计
**决策**：🔵 需架构设计

**子任务**：
- [ ] Speech 框架接入方案
- [ ] 流式传输到后端 STT/ASR
- [ ] 语音输入 UI 交互（按住说话 / 实时转写）

---

## 🔵 I24 — iPad 布局适配

**状态**：待设计
**决策**：🔵 需架构设计

**子任务**：
- [ ] 当前所有页面在 iPad 上的表现审计
- [ ] 决定适配策略（Split View / 等比放大 / 自适应列）
- [ ] NavigationStack + sidebar 方案评估

---

## 🔴 I30 — 会员/订阅页面

**状态**：待决策
**决策**：🔴 需你决策

**背景**：用户提到"订阅页面、付款问题"。当前完全没有会员体系相关页面。

**需要你决策**：
1. 订阅套餐设计：几个档位？（免费/Pro/终身？）
2. 定价策略：月费/年费各多少？
3. 免费版限制：AI 次数？知识库数量？
4. 竞品参考：多邻国 Super/Anki 一次性购买/得到订阅？

**技术侧待架构**：
- [ ] IAP 接入（StoreKit 2）
- [ ] 会员权益展示页 UI
- [ ] 订阅状态管理（entitlement / restore / expiration）
- [ ] 与后端 B23 对接（Plans + Membership + Subscription API）

---

## 🔴 I31 — 付款流程

**状态**：待决策
**决策**：🔴 需你决策（依赖 I30 定价）

**技术侧待架构**：
- [ ] Apple IAP 支付流程（StoreKit 2 Transaction API）
- [ ] 收据验证（服务端验证 receipt）
- [ ] 支付失败/恢复购买/退款处理
- [ ] 支付状态 UI（loading / success / failure / pending）

---

## 🟡 发布准备（🟢 可自主实现）

| # | 事项 | 状态 |
|---|------|------|
| I25 | App 图标制作（1024px + 各尺寸） | 待开始 |
| I26 | 图片文件上传对接 COS | 待开始 |
| I27 | 设备信息收集 API 对接 | 待开始 |
| I28 | iOS 小组件（WidgetKit） | 待开始 |
| I29 | TestFlight 打包发布（证书+构建） | 待开始 |

---

## 🟢 P3（暂缓）

| # | 事项 | 状态 |
|---|------|------|
| I14 | 数据埋点（PostHog/Firebase） | 暂缓 |
| I15 | 崩溃监控（Crashlytics/Sentry） | 暂缓 |
| I16 | ViewModel/Service 单元测试 | 暂缓 |
| I17 | Tab 结构调整（4 vs 5，🔴需决策） | 暂缓 |