4.6 KiB
4.6 KiB
知习 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 数据，未接通后端。
五、关键发现
- AI 学习闭环已具雏形： 知识库 → 阅读 → AI 分析薄弱点 → 主动回忆 → 复习卡片，形成完整的学习链路。
- 文档阅读基础设施较完善： 通过 Rust FFI 支持 Markdown、文本、PDF、EPUB、图片、Office 文件的解析和阅读，具备阅读位置记录、事件上报等能力。
- AI 相关页面 mock 较多： 回忆测试、薄弱点分析、AI 反馈、今日思考等页面的展示数据均为硬编码，未接入真实 AI 分析结果。
- AI 首页（AIHomeView）未被引用： 该页面代码完整但未接入任何导航入口，属于废弃页面。
- 知识库管理功能较完整： 创建、导入、知识点增删改查、分类管理、公开库发现、订阅等基础功能已接通 API。
- 通知系统有界面但功能有限： 通知列表可查看和标记已读，但设置页面中通知开关状态存在绑定异常。
- 部分功能标注 TODO： 知识点重命名、移动到文件夹、收藏、知识库管理页、官方知识库筛选等功能未实现。
- 无离线模式： 应用设计为在线优先，无本地数据持久化策略，仅在阅读上下文方面有基础离线缓存。
- 部分 API 端点已就绪但 C 端无入口： WaitlistService（waitlist 加入/统计）API 服务代码完整但无任何页面调用；UserService 账号注销（requestAccountDeletion/cancelDeletion）API 已就绪但设置页未提供注销入口；UserService 设备管理（listDevices/removeDevice）API 已就绪但设置页"登录设备管理"行为空（导航自引用）。
六、关联文档
- 01-iOS页面地图.md — 全部页面的详细描述
- 02-iOS页面功能总表.md — 页面功能汇总表
- 03-C端业务能力初步清单.md — 第一阶段初步归类（草稿，正式能力以 04 为准）
- 04-C端正式业务能力树.md — 正式 C 端业务能力三层树（主索引）
- 05-页面与业务能力矩阵.md — 页面与业务能力双向矩阵