# 知习 iOS C 端总览

> **分析范围：** 仅 iOS 项目（AIStudyApp），不包含 API、Rust、RAG、Admin 或其他仓库。
> **分析日期：** 2026-06-19
> **分析阶段：** 第一阶段完成 — C 端业务盘点与能力定稿

---

## 一、项目概况

知习（ZhiXi）iOS 是一款 AI 驱动的系统化学习应用，基于 SwiftUI 构建，支持深色/浅色主题。当前版本仅支持 Apple ID 登录。业务主数据以云端 API 为主，部分阅读上下文、上传队列和笔记当前保存在本地。

## 二、用户生命周期

```
首次启动 → Splash（会话恢复）
  → Welcome（欢迎页）
  → Login（Apple ID 登录）
  → Onboarding（4 步引导：输入知识 / 主动输出 / AI 分析 / 掌握知识）
  → GoalSetup（设定学习目标 / 方法 / 时间）
  → 主界面（4 Tab）
```

已登录用户再次启动时直接进入主界面。账号被禁用或注销后进入对应状态页。

## 三、底部导航（一级模块）

| Tab | 名称 | 说明 |
|-----|------|------|
| 1 | 学习 | 学习工作台：今日任务、继续学习、复习卡片、自我测试、每周摘要 |
| 2 | 知识库 | 个人知识库管理：创建、导入、搜索、浏览知识点、AI 对话 |
| 3 | 分析 | 学习数据分析：掌握度、阅读趋势、薄弱知识点、学习推荐 |
| 4 | 我的 | 个人中心：资料编辑、设置、通知、学习方法、目标、反馈 |

## 四、页面总览

### 4.1 统计口径

本阶段盘点范围包括所有用户可访问的页面、弹窗和确认对话框，按入口类型划分：

| 入口类型 | 数量 | 说明 |
|---------|------|------|
| 独立 Push 页面（可路由） | 32 | 通过 NavigationStack + Route 枚举跳转的页面 |
| 启动/登录流程页面（不可路由） | 6 | 启动页、欢迎页、登录页、账号状态页、引导页、目标设置页 |
| Sheet / 弹窗 | 6 | 从页面中弹出的非独立页面 |
| 确认弹窗（Alert/ConfirmationDialog） | 8 | 各类确认/输入弹窗 |
| 代码存在但无导航入口的页面 | 2 | AIHomeView（已废弃）、RecallTestPage（无入口） |
| **总计可盘点对象** | **54** | |

### 4.2 独立 Push 页面完成情况

| 完成情况 | 数量 | 占比 |
|---------|------|------|
| 已完成 | 17 | 53% |
| 部分完成 | 8 | 25% |
| 占位实现 | 7 | 22% |
| **合计** | **32** | 100% |

> "占位实现"指页面框架存在但使用硬编码 mock 数据，未接通后端。

## 五、关键发现

1. **AI 学习闭环已具雏形：** 知识库 → 阅读 → AI 分析薄弱点 → 主动回忆 → 复习卡片，形成完整的学习链路。
2. **文档阅读基础设施较完善：** 通过 Rust FFI 支持 Markdown、文本、PDF、EPUB、图片、Office 文件的解析和阅读，具备阅读位置记录、事件上报等能力。
3. **AI 相关页面 mock 较多：** 回忆测试、薄弱点分析、AI 反馈、今日思考等页面的展示数据均为硬编码，未接入真实 AI 分析结果。
4. **AI 首页（AIHomeView）未被引用：** 该页面代码完整但未接入任何导航入口，属于废弃页面。
5. **知识库管理功能较完整：** 创建、导入、知识点增删改查、分类管理、公开库发现、订阅等基础功能已接通 API。
6. **通知系统有界面但功能有限：** 通知列表可查看和标记已读，但设置页面中通知开关状态存在绑定异常。
7. **部分功能标注 TODO：** 知识点重命名、移动到文件夹、收藏、知识库管理页、官方知识库筛选等功能未实现。
8. **无离线模式：** 应用设计为在线优先，无本地数据持久化策略，仅在阅读上下文方面有基础离线缓存。
9. **部分 API 端点已就绪但 C 端无入口：** WaitlistService（waitlist 加入/统计）API 服务代码完整但无任何页面调用；UserService 账号注销（requestAccountDeletion/cancelDeletion）API 已就绪但设置页未提供注销入口；UserService 设备管理（listDevices/removeDevice）API 已就绪但设置页"登录设备管理"行为空（导航自引用）。

## 六、关联文档

- [01-iOS页面地图.md](./01-iOS页面地图.md) — 全部页面的详细描述
- [02-iOS页面功能总表.md](./02-iOS页面功能总表.md) — 页面功能汇总表
- [03-C端业务能力初步清单.md](./03-C端业务能力初步清单.md) — 第一阶段初步归类（草稿，正式能力以 04 为准）
- [04-C端正式业务能力树.md](./04-C端正式业务能力树.md) — 正式 C 端业务能力三层树（主索引）
- [05-页面与业务能力矩阵.md](./05-页面与业务能力矩阵.md) — 页面与业务能力双向矩阵