wangdl/ios-projects
2
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases Wiki Activity
ios-projects/docs/system-map/ios/01-iOS页面地图.md

40 KiB
Raw Permalink Blame History

01 iOS 页面地图

按用户可见的页面层级整理，不按代码目录组织。

一、启动与登录流程

1.1 启动页（SplashScreen）

  • 页面作用： 应用启动时显示品牌标识，后台静默恢复登录会话。
  • 页面入口： 应用冷启动时的默认展示。
  • 页面组成： 深色渐变背景、品牌图标（大脑）、"知习"标题、加载指示器。
  • 用户可执行操作： 无（自动跳转）。
  • 自动执行功能： 从系统钥匙串读取 Token → 调用 API 校验 → 恢复会话或跳转到登录页。
  • 可跳转页面： 自动跳转至 Welcome 页（未登录）或主界面（已登录）。
  • 页面主要状态： 仅展示态。会话恢复中 / 恢复完成自动跳转。
  • 当前完成情况： 已完成

1.2 欢迎页（WelcomePage）

  • 页面作用： 向新用户介绍产品核心功能，引导进入登录流程。
  • 页面入口： 未登录用户从启动页自动跳转，或已登录用户退出后进入。
  • 页面组成： 页面渐变背景、装饰光晕、"AI 驱动"标签、主标题"用 AI 重新定义你的学习方式"、三个功能介绍卡片（主动回忆、费曼解释、AI 分析）、"开始使用"按钮。
  • 用户可执行操作： 点击"开始使用"进入登录页。
  • 自动执行功能： 无。
  • 可跳转页面： LoginPage（登录页）。
  • 页面主要状态： 仅展示态。
  • 当前完成情况： 已完成

1.3 登录页（LoginPage）

  • 页面作用： 用户使用 Apple ID 登录应用。
  • 页面入口： 欢迎页点击"开始使用"。
  • 页面组成： 页面渐变背景、品牌图标、欢迎文案、"使用 Apple 账号登录以同步学习数据"提示、Sign in with Apple 按钮、错误信息区域、登录中取消按钮覆盖层。
  • 用户可执行操作： Apple ID 登录、取消登录。
  • 自动执行功能： 登录成功后自动保存 Token 至钥匙串、切换会话状态。
  • 可跳转页面： 登录成功 → Onboarding 页（首次）或主界面（已设定目标）。
  • 页面主要状态： 待登录 / 登录中 / 登录失败（显示错误提示）。
  • 当前完成情况： 已完成

1.4 账号状态页（AccountStatusView）

  • 页面作用： 当账号被禁用或已注销时，向用户展示状态说明。
  • 页面入口： 启动时 AuthManager 检测到账号为 disabled 或 deleted 状态。
  • 页面组成： 页面渐变背景、状态图标、标题文案、说明文字、"返回首页"按钮。
  • 用户可执行操作： 点击"返回首页"回到未登录状态，可重新登录。
  • 自动执行功能： 无。
  • 可跳转页面： 回到 Welcome 页。
  • 页面主要状态： 禁用态 / 注销态（两种展示略有不同）。
  • 当前完成情况： 已完成

1.5 引导页（OnboardingPage）

  • 页面作用： 首次登录后展示产品价值，引导用户理解产品核心流程。
  • 页面入口： 首次登录成功后自动跳转。
  • 页面组成： 页面渐变背景、4 步引导指示器、步骤标题与说明、"下一步"/"开始使用"按钮、"跳过"链接。四步分别为：输入知识、主动输出、AI 分析、掌握知识。
  • 用户可执行操作： 点击"下一步"依次浏览、点击"跳过"直接结束。
  • 自动执行功能： 无。
  • 可跳转页面： GoalSetupPage（目标设置页）或直接进入主界面（跳过）。
  • 页面主要状态： 展示第1-4步。
  • 当前完成情况： 已完成

1.6 目标设置页（GoalSetupPage）

  • 页面作用： 用户设定学习目标、偏好方法和每日学习时间。
  • 页面入口： Onboarding 完成后自动跳转，或从"我的"→"学习目标设置"进入。
  • 页面组成： 页面渐变背景、标题"设定你的学习目标"、四个学习目标选项（备考考试/职业技能/通识学习/自定义）、三种学习方法多选（间隔回忆/费曼技巧/AI 分析）、四个每日学习时间选项（15分钟/30分钟/1小时/不限制）、"开始学习"按钮。
  • 用户可执行操作： 选择学习目标、选择学习方法、选择每日时间、确认进入主界面。
  • 自动执行功能： 确认后将目标通过 API 保存至用户偏好。
  • 可跳转页面： 主界面 ContentView。
  • 页面主要状态： 选择中（单选目标、多选方法、单选时间）/ 已确认。
  • 当前完成情况： 部分完成（学习目标和方法通过 API 保存；每日学习时长仅保存在本地 @State，缺乏可靠持久化）

二、学习（底部导航 Tab 1）

2.1 学习主页（StudyHomeView）

  • 页面作用： 学习工作台，聚合展示今日学习任务、复习卡片、自我测试等学习入口。
  • 页面入口： 底部导航"学习" Tab（默认选中）。
  • 页面组成：
    • 标题栏：页面标题"学习"（实际未显示明显标题）
    • 连续学习天数（火焰图标 + 天数）
    • 主操作卡片（动态变化，见下）
    • 今日复习卡片（卡片数 + 预计时长）
    • 自我测试卡片（可用测验数）
    • 每周摘要卡片（本周分钟数 / 复习卡片数 / 活跃天数 / 连续天数）
    • 底部"查看完整分析"链接
  • 用户可执行操作：
    • 点击主操作卡片（根据优先级不同，操作不同）
    • 点击复习卡片入口
    • 点击自我测试入口
    • 点击每周摘要区域查看详细分析
    • 下拉刷新
  • 自动执行功能： 页面加载时自动计算优先级最高的学习操作（继续学习 > 今日复习 > 自我测试 > 开始学习 > 空状态引导）
  • 可跳转页面：
    • MaterialReaderView（资料阅读，继续学习时）
    • ReviewCardView（复习卡片）
    • QuizTakerView（自我测试）
    • QuizListView（测验列表）
    • ActiveRecallView（主动回忆）
    • 切换到"知识库" Tab
  • 页面主要状态： 加载中 / 加载失败（错误提示 + 重试按钮）/ 已加载·有任务 / 已加载·空状态。

    注：View 支持 error 状态展示，但 ViewModel 中所有 API 调用使用 try? 吞错，error 状态在实际运行中永不可达。

  • 当前完成情况： 已完成

2.2 学习会话页（LearningSessionView）

  • 页面作用： 专注学习计时器，记录单次学习时长。
  • 页面入口： 从学习主页或资料阅读页的学习任务入口进入。
  • 页面组成： 环形计时器（带动画渐变环）、任务信息卡片（任务名称、类型、建议时长 30 分钟、今日已学时长）、提示卡片、底部状态栏"学习中…"、暂停/继续按钮、结束按钮。
  • 用户可执行操作： 暂停/继续计时、结束学习。
  • 自动执行功能： 进入页面自动开始计时（1秒精度），学习结束时自动展示庆祝动画。
  • 可跳转页面： 无（结束学习后展示庆祝动画，用户可返回）。
  • 页面主要状态： 计时中 / 已暂停 / 学习完成（庆祝动画覆盖层）。
  • 当前完成情况： 暂未确认（本地计时功能完成，但代码中未发现调用 LearningSessionService API 保存学习记录的代码，学习时长可能不持久化到服务端）

2.3 复习卡片页（ReviewCardView）

  • 页面作用： 基于间隔重复的闪卡复习。
  • 页面入口： 学习主页"今日复习"入口、AI 快捷操作。
  • 页面组成： 进度条、卡片正面（问题）、卡片反面（答案 + 出处）、自评按钮组（"完全不会"/"有点难"/"基本会"/"很简单"）。
  • 用户可执行操作： 点击卡片翻转查看答案、点击自评按钮评分、自动跳至下一张。
  • 自动执行功能： 评分后自动前进到下一张卡片，全部完成后自动展示庆祝动画。
  • 可跳转页面： 无。
  • 页面主要状态： 卡片正面 / 卡片反面（含自评按钮）/ 全部完成（庆祝动画覆盖层）。
  • 当前完成情况： 占位实现（展示 3 张机器学习相关硬编码卡片，未接通 ReviewViewModel 和 API）

2.4 主动回忆页（ActiveRecallView）

  • 页面作用： 用户主动输出知识点内容，由 AI 评估掌握程度。
  • 页面入口： 学习主页底部链接或 AI 快捷操作。
  • 页面组成： 进度条、问题卡片（含题目类型标签：语音/文字 和来源）、回答输入区（TextEditor 或语音占位按钮）、提交按钮、提交确认区（"下一题"/"查看 AI 分析"按钮）。
  • 用户可执行操作： 输入文字答案、提交答案、查看 AI 分析、进入下一题。
  • 自动执行功能： 提交答案后展示"AI 正在分析你的回答…"思考动画覆盖层，全部完成后展示庆祝动画。
  • 可跳转页面： AIFeedbackPageView（AI 反馈页）。
  • 页面主要状态： 答题模式 / 答案已提交 / AI 分析中（覆盖层）/ 全部完成（庆祝动画覆盖层）。
  • 当前完成情况： 占位实现（3 道硬编码机器学习题目，第 3 题标记为语音类型但语音功能未实现）

三、知识库（底部导航 Tab 2）

3.1 知识库首页（LibraryHomeView）

  • 页面作用： 展示和管理用户的知识库列表。
  • 页面入口： 底部导航"知识库" Tab。
  • 页面组成： 标题"知识库"、搜索按钮、创建按钮、搜索栏、筛选分类横条（全部/我的/已订阅/官方）、知识库卡片列表（封面图、名称、描述、日期、可见性标签、置顶标记）。
  • 用户可执行操作：
    • 点击知识库卡片进入详情
    • 点击搜索按钮进入搜索
    • 点击创建按钮新建知识库
    • 切换筛选分类
    • 下拉刷新
    • 无限滚动加载更多
  • 自动执行功能： 页面加载时自动拉取知识库列表。
  • 可跳转页面：
    • LibraryDetailPage（知识库详情）
    • LibrarySearchView（搜索）
    • CreateLibraryPage（创建知识库）
  • 页面主要状态： 加载中 / 各分类的空状态（文案不同）/ 已加载·有数据 / 分页加载更多中 / 刷新中。
  • 当前完成情况： 部分完成（"官方"筛选返回空数组，待后端支持；搜索页仅展示空状态，未实现搜索逻辑）

3.2 知识库搜索页（LibrarySearchView）

  • 页面作用： 搜索知识库和知识点。
  • 页面入口： 知识库首页点击搜索图标。
  • 页面组成： 搜索输入框、空白搜索区域。
  • 用户可执行操作： 输入搜索关键词（实际搜索逻辑未实现）。
  • 自动执行功能： 无。
  • 可跳转页面： 无。
  • 页面主要状态： 搜索前空状态。
  • 当前完成情况： 部分完成（页面框架和输入框已搭建，搜索逻辑未实现）

3.3 知识库详情页（LibraryDetailPage）

  • 页面作用： 查看知识库内容，管理知识点和来源文件。
  • 页面入口： 知识库首页点击知识库卡片。
  • 页面组成：
    • 知识库信息头部（封面、标题、描述、元数据行）
    • 两个标签页切换：知识点 Tab / 来源 Tab
    • 知识点 Tab： 知识点列表（类型图标、类型标签、日期、学习进度）、排序菜单、操作菜单、批量选择模式
    • 来源 Tab： 来源文件列表（含阅读状态标签、删除按钮）
    • 底部 AI 对话按钮（知识库范围）
    • 文件夹管理入口（Sheet）
  • 用户可执行操作：
    • 切换知识点/来源 Tab
    • 点击知识点进入详情
    • 长按/滑动删除知识点
    • 批量选择与批量删除
    • 切换排序方式（默认/文件大小/创建时间/更新时间）
    • 点击上传导入资料
    • 打开文件夹管理弹窗
    • 点击底部 AI 对话按钮
    • 点击来源文件进入资料阅读
    • 删除来源文件
    • 点击"知识库管理"（操作菜单中存在，但 action 为空 TODO，未实现）
  • 自动执行功能： 页面加载时自动拉取知识点列表和来源列表。
  • 可跳转页面：
    • KnowledgeDetailPage（知识点详情）
    • ImportPage（导入资料）
    • AddKnowledgePage（添加知识点）
    • QuizListView（生成测验）
    • AIChatPage（AI 对话，知识库范围）
    • MaterialReaderView（资料阅读）
    • FolderManageView（文件夹管理，Sheet 弹窗）
  • 页面主要状态：
    • 加载中 / 加载失败
    • 知识点 Tab·有数据 / 知识点 Tab·空
    • 来源 Tab·有数据 / 来源 Tab·空
    • 批量选择模式
    • 删除确认弹窗
  • 当前完成情况： 部分完成（知识点重命名 TODO、移动到文件夹 TODO、知识库管理页 TODO、收藏状态切换 TODO）

3.4 创建知识库页（CreateLibraryPage）

  • 页面作用： 创建新的知识库。
  • 页面入口： 知识库首页点击创建按钮、"我的"页学习资产入口。
  • 页面组成： 封面图区域（可点击上传）、知识库名称输入框（必填）、描述输入框（必填）、创建按钮。
  • 用户可执行操作： 从相册选择封面图（自动裁剪为 512×512）、输入名称和描述、点击创建。
  • 自动执行功能： 封面上传时自动调整图片尺寸。
  • 可跳转页面： 无（创建成功后返回上一页）。
  • 页面主要状态： 编辑中（名称/描述为空时按钮禁用）/ 封面上传中 / 创建中。
  • 当前完成情况： 已完成

3.5 添加知识点页（AddKnowledgePage）

  • 页面作用： 向知识库添加新的知识点。
  • 页面入口： 知识库详情页操作菜单中的"添加"。
  • 页面组成： "内容来源"分段选择器（手动 / 文件）、手动模式下的标题输入框和内容编辑器、文件模式下的"选择文件"/"图片"按钮、已选文件列表（可移除）、上传进度指示器、保存按钮。
  • 用户可执行操作：
    • 手动模式：输入标题和内容文字，点击保存。
    • 文件模式：选择文件（PDF/纯文本/图片）、选择照片、移除已选文件、批量保存。
  • 自动执行功能： 文件模式下自动检测 MIME 类型，大于 2MB 的图片自动压缩，文件上传至腾讯云 COS。
  • 可跳转页面： 无（保存成功后返回上一页）。
  • 页面主要状态： 手动模式 / 文件模式 / 文件上传中 / 保存中。
  • 当前完成情况： 已完成

3.6 知识点详情页（KnowledgeDetailPage）

  • 页面作用： 查看知识点详细内容，支持多种文件格式渲染。
  • 页面入口： 知识库详情页点击知识点。
  • 页面组成： 根据内容类型不同展示不同渲染方式：
    • URL 型知识点：嵌入 MaterialReaderView 渲染
    • 纯文本知识点：直接文本渲染（支持 Markdown）
    • 图片/PDF/Word/Excel/PPT/ePub：对应原生阅读器或系统预览
    • 工具栏菜单（笔记、预览选项、阅读原文按钮）
  • 用户可执行操作： 阅读内容、查看原文、添加笔记、收藏（UI 存在但后端未支持）。
  • 自动执行功能： 加载知识点内容，自动从 COS 下载文件（带过期 URL 重新获取逻辑）。
  • 可跳转页面： MaterialReaderView。
  • 页面主要状态： 加载中 / 错误（显示概要回退文字 + 重试按钮）/ 内容已就绪。
  • 当前完成情况： 部分完成（收藏切换有 UI 但后端 API 未支持，收藏标记为 TODO）

3.7 编辑知识点页（EditKnowledgePage）

  • 页面作用： 编辑知识点标题和内容。
  • 页面入口： 知识点详情页工具栏菜单。
  • 页面组成： 标题输入框、内容编辑器、保存按钮。
  • 用户可执行操作： 修改标题和内容、保存。
  • 自动执行功能： 无。
  • 可跳转页面： 无（保存后返回）。
  • 页面主要状态： 编辑中 / 保存中。
  • 当前完成情况： 已完成

3.8 导入资料页（ImportPage）

  • 页面作用： 向知识库导入外部资料。
  • 页面入口： 知识库详情页操作菜单中的"导入"。
  • 页面组成： 三种导入方式入口：文件导入、相册导入、链接导入。自动检测或提示选择目标知识库。
  • 用户可执行操作：
    • 文件导入：选择 PDF 或纯文本文件
    • 相册导入：选择照片
    • 链接导入：输入 URL（通过弹窗）
  • 自动执行功能： 自动选择第一个知识库，无知识库时提示用户创建。
  • 可跳转页面： ImportReviewPage（导入候选审核页）。
  • 页面主要状态： 选择导入方式 / 导入中 / 导入失败（错误横幅）。
  • 当前完成情况： 已完成

3.9 导入候选审核页（ImportReviewPage）

  • 页面作用： 审核 AI 从导入资料中提取的知识点候选。
  • 页面入口： 导入资料完成后自动跳转。
  • 页面组成： 候选知识点列表（含置信度分数）、每条候选可展开查看详情、接受/拒绝按钮、"全部接受"按钮。
  • 用户可执行操作： 接受单个候选、拒绝单个候选、批量全部接受。
  • 自动执行功能： 加载该来源的导入候选列表。
  • 可跳转页面： 无。
  • 页面主要状态： 加载中 / 无待审核候选 / 有待审核列表。
  • 当前完成情况： 已完成

3.10 发现公开库页（DiscoverView）

  • 页面作用： 浏览和订阅其他用户公开的知识库。
  • 页面入口： "我的"页"发现公开库"入口。
  • 页面组成： 公开知识库列表（标题、描述、知识条目数）、每条右侧有订阅/取消订阅按钮。
  • 用户可执行操作： 订阅知识库、取消订阅。
  • 自动执行功能： 加载公开知识库列表。
  • 可跳转页面： 无。
  • 页面主要状态： 加载中 / 空（无公开知识库）/ 已加载。
  • 当前完成情况： 已完成

3.11 文件夹管理（FolderManageView）

  • 页面作用： 管理知识库内的文件夹/分类。
  • 页面入口： 知识库详情页操作菜单中的"文件夹管理"（以 Sheet 形式弹出）。
  • 页面组成： 文件夹列表（含名称）、新建按钮、每条可滑动操作（重命名、删除）。
  • 用户可执行操作： 创建文件夹（通过弹窗输入名称）、重命名文件夹、删除文件夹。
  • 自动执行功能： 加载该知识库的文件夹列表。
  • 可跳转页面： 无（Sheet 内操作）。
  • 页面主要状态： 文件夹列表 / 新建弹窗 / 重命名弹窗。
  • 当前完成情况： 已完成

四、分析（底部导航 Tab 3）

4.1 学习分析页（AnalysisHomeView）

  • 页面作用： 展示学习数据分析和趋势洞察。
  • 页面入口： 底部导航"分析" Tab。
  • 页面组成：
    • 标题"学习分析"+ 日期范围筛选（"近 7 天"）
    • 4 个统计徽章：综合掌握 / 总分钟 / 复习卡片 / 活跃天
    • 4 个阅读统计徽章：今日阅读 / 本周阅读 / 已读资料 / 阅读资料
    • 掌握度趋势折线图（含动画）
    • 阅读时长趋势柱状图
    • 本周学习活跃柱状图
    • 连续学习统计（当前连续/最长连续/最后活跃）
    • 最近学习记录列表（最多 5 条）
    • 学习推荐列表（含优先级标签）
    • 继续阅读入口
    • AI 综合分析文字摘要
    • 薄弱知识点列表（最多 5 条）
  • 用户可执行操作：
    • 点击薄弱知识点查看详情（跳转 WeakPointsPage）
    • 点击继续阅读入口（跳转 MaterialReaderView）
    • 下拉刷新数据
  • 自动执行功能： 页面加载时自动并行拉取活动概览、趋势、连续天数、推荐、阅读数据等。
  • 可跳转页面：
    • WeakPointsPage（薄弱知识点详情）
    • MaterialReaderView（继续阅读）
  • 页面主要状态： 加载中 / 加载失败（错误提示 + 重试按钮）/ 已加载·有数据 / 部分数据为空时隐藏对应区域。
  • 当前完成情况： 部分完成（掌握度趋势折线图和每周活跃柱状图使用编译时硬编码的 7 天数据，未从 ViewModel API 数据读取，属于占位实现；其他数据来自 API）

五、我的（底部导航 Tab 4）

5.1 个人中心页（ProfileView）

  • 页面作用： 用户个人信息与功能入口集合。
  • 页面入口： 底部导航"我的" Tab。
  • 页面组成：
    • 顶部导航栏：标题"我的"、发现公开库按钮、通知图标、设置图标
    • 个人资料卡片（头像、昵称、邮箱、活跃天/复习卡片/分钟统计）
    • 功能菜单：学习目标设置、复习提醒、学习方法偏好、帮助与反馈
    • 学习资产区域：知识库/条目/卡片计数、发现公开库入口、消息中心入口、存储空间展示
  • 用户可执行操作：
    • 点击资料卡片进入编辑资料
    • 点击各菜单项进入对应子页面
    • 点击通知图标进入通知列表
    • 点击设置图标进入设置
  • 自动执行功能： 页面加载时自动拉取用户资料、活动摘要、资产和存储统计。
  • 可跳转页面：
    • EditProfilePage（编辑资料）
    • GoalSettingDetailView（学习目标设置）
    • SettingsView（设置，从复习提醒行进入也是设置）
    • MethodPreferenceView（学习方法偏好）
    • FeedbackFormView（帮助与反馈）
    • CreateLibraryPage（学习资产入口）
    • DiscoverView（发现公开库）
    • NotificationListView（通知列表/消息中心）
  • 页面主要状态： 加载中 / 已加载（含默认值和占位信息）。
  • 当前完成情况： 已完成

5.2 编辑资料页（EditProfilePage）

  • 页面作用： 编辑个人资料信息。
  • 页面入口： 个人中心页点击资料卡片。
  • 页面组成：
    • 头像区域（可点击上传，自动裁剪为正方形 256×256）
    • 基本信息区：昵称输入框、学习身份输入框
    • 学习档案区：学习方向输入框、当前目标输入框
    • 个人简介输入框
    • 保存按钮（含加载状态）
  • 用户可执行操作： 从相册选择头像、编辑各文本字段、保存。
  • 自动执行功能： 头像选择后自动裁剪上传。
  • 可跳转页面： 无。
  • 页面主要状态： 加载中（加载现有资料）/ 编辑中 / 头像上传中 / 保存中 / 错误提示。
  • 当前完成情况： 已完成

5.3 设置页（SettingsView）

  • 页面作用： 应用全局设置。
  • 页面入口： 个人中心页点击设置图标或"复习提醒"行。
  • 页面组成：
    • 外观与语言区：外观模式选择（跟随系统/深色/浅色）、语言
    • 学习设置区：学习目标（导航）、方法偏好（导航）
    • 复习提醒区：提醒开关、提醒时间选择器、间隔天数选择器
    • 通知设置区：复习提醒开关、导入完成通知开关、系统通知开关
    • 数据与存储区：存储空间、iCloud 同步开关
    • 账号区：个人信息、设备管理
    • 帮助与反馈、隐私政策、用户协议
    • 退出登录按钮（带确认弹窗）
    • 底部关于信息（版本号）
  • 用户可执行操作： 切换外观模式、设置复习提醒时间和间隔天数、切换通知开关、iCloud 同步开关、退出登录、跳转子页面。
  • 自动执行功能： 外观模式变更时自动保存至用户偏好 API。
  • 可跳转页面：
    • GoalSettingDetailView（学习目标设置）
    • MethodPreferenceView（方法偏好）
  • 页面主要状态： 各开关状态、退出登录确认弹窗。
  • 当前完成情况： 部分完成（三个通知开关绑定到同一个 $reviewReminder 变量，存在明确 bug；"设备管理"、"隐私政策"、"用户协议"入口无导航目标；"存储空间"行导航目标为 Route.settings 自身，形成无效自引用；"登录设备管理"行同理，导航目标也为 Route.settings 自身）

5.4 学习目标设置页（GoalSettingDetailView）

  • 页面作用： 配置学习目标和每日学习时长。
  • 页面入口： 设置页"学习目标"或"我的"页"学习目标设置"。
  • 页面组成： 四个学习目标选项（备考考试/职业技能/通识学习/自定义）、四个每日学习时间选项（15分钟/30分钟/1小时/不限制）。
  • 用户可执行操作： 选择目标和时间，保存。
  • 自动执行功能： 保存至用户 API。
  • 可跳转页面： 无。
  • 页面主要状态： 当前选中态展示。
  • 当前完成情况： 部分完成（学习目标选择通过 API 保存，但每日学习时长 dailyMins 仅保存在本地 @State 变量，不通过 API 持久化，下次进入恢复默认"30 分钟"）

5.5 学习方法偏好页（MethodPreferenceView）

  • 页面作用： 配置偏好的学习方式。
  • 页面入口： 设置页或"我的"页"学习方法偏好"。
  • 页面组成： 四种方法选项（间隔回忆/费曼技巧/AI分析/主动回忆），多选框形式。
  • 用户可执行操作： 多选/取消方法，保存。
  • 自动执行功能： 保存至用户偏好 API。
  • 可跳转页面： 无。
  • 页面主要状态： 选中/未选中。
  • 当前完成情况： 已完成

5.6 通知列表页（NotificationListView）

  • 页面作用： 查看和管理系统通知。
  • 页面入口： "我的"页通知图标或消息中心入口。
  • 页面组成： 通知列表按日期分组（今天/本周/更早），每条通知含类型图标、标题、内容、时间、已读/未读状态。顶部"全部已读"按钮。
  • 用户可执行操作： 点击单条通知标记为已读、点击"全部已读"。
  • 自动执行功能： 加载通知列表。
  • 可跳转页面： 无。
  • 页面主要状态： 加载中 / 有通知 / 无通知。
  • 当前完成情况： 已完成

5.7 帮助与反馈页（FeedbackFormView）

  • 页面作用： 用户提交反馈和问题报告。
  • 页面入口： "我的"页"帮助与反馈"、设置页"帮助与反馈"。
  • 页面组成： 反馈类型选择器（Bug反馈/功能建议/内容问题/其他）、内容输入框、提交按钮。
  • 用户可执行操作： 选择反馈类型、输入描述文字、提交。
  • 自动执行功能： 提交至反馈 API。
  • 可跳转页面： 无。
  • 页面主要状态： 编辑中 / 提交中 / 已提交（可继续提交新的）。
  • 当前完成情况： 已完成

六、AI 辅助功能（跨模块访问）

6.1 AI 对话页（AIChatPage）

  • 页面作用： 与 AI 进行学习相关的对话互动。
  • 页面入口： 知识库详情页底部 AI 对话按钮、AI 反馈页"深入提问"、资料阅读页工具栏 AI 按钮（多处入口，均可附带对话范围上下文）。
  • 页面组成：
    • 对话消息列表（用户消息紫色渐变气泡、AI 消息含思考过程和内容）
    • AI 思考过程区（可折叠、含流式输出动画）
    • 范围标签（当对话限定在特定知识库/资料时显示）
    • 工具栏按钮（新建对话、会话列表）
    • 底部输入栏（文字输入框、语音图标（占位）、发送按钮）
    • AI 回复完成后显示"复制"和"重新生成"按钮
  • 用户可执行操作：
    • 发送文字消息
    • 查看 AI 思考过程
    • 复制 AI 回复
    • 重新生成回复
    • 新建对话
    • 打开会话列表 Sheet
    • 在会话列表中搜索、删除、归档会话
  • 自动执行功能： 流式接收 AI 回复并实时展示，自动创建或恢复对话会话。
  • 可跳转页面： 无（页面内操作）。
  • 页面主要状态：
    • 创建会话中 / 会话创建失败
    • 消息列表（含滚动加载历史）
    • AI 回复流式输出中（含思考动画）
    • 会话列表 Sheet（搜索、筛选、编辑操作）
  • 当前完成情况： 已完成

6.2 每日思考页（DailyThinkingPage）

  • 页面作用： 展示一道每日思考题，用户提交回答后获取 AI 反馈。
  • 页面入口： AI 反馈页"再来一题"。
  • 页面组成： 思考题目（硬编码："Transformer 中的注意力机制"）、评估要点提示、回答输入框、"提交获取 AI 反馈"按钮。
  • 用户可执行操作： 输入答案、提交获取 AI 反馈。
  • 自动执行功能： 无。
  • 可跳转页面： AIFeedbackPageView。
  • 页面主要状态： 回答中 / 提交后跳转。
  • 当前完成情况： 占位实现（题目硬编码，无 ViewModel，无动态题目来源。注：submitted 状态变量在代码中从未被设置为 true，提交按钮始终可见，可能导致用户重复提交）

6.3 AI 反馈页（AIFeedbackPageView）

  • 页面作用： 展示 AI 对用户回答的分析评分和建议。
  • 页面入口： 主动回忆完成后、每日思考提交后、回忆测试提交后。
  • 页面组成（两阶段）：
    • 分析中：动画步骤指示器（"解析你的回答结构…"等 4 步，约 5 秒）
    • 分析结果：得分圆环、掌握度评价文字、用户原始回答、答对的部分列表、需要完善的内容、参考答案要点、"加入待巩固"按钮、"深入提问"按钮、"再来一题"按钮
  • 用户可执行操作： 查看分析结果、加入待巩固（跳转学习主页）、深入提问（跳转 AI 对话）、再来一题（跳转每日思考）。
  • 自动执行功能： 模拟分析过程（5 秒后自动展示结果）。
  • 可跳转页面： StudyHomeView、AIChatPage、DailyThinkingPage。
  • 页面主要状态： 分析中 / 分析结果。
  • 当前完成情况： 占位实现（得分 78/100 硬编码，所有分析文字硬编码，未接通真实 AI 分析 API）

6.4 薄弱知识点页（WeakPointsPage）

  • 页面作用： 展示用户的薄弱知识点列表。
  • 页面入口： 学习分析页薄弱知识点区域"全部"链接。
  • 页面组成： 薄弱知识点列表，每项含掌握度分数、知识点名称、所属知识库、优先级标签（高/中）。
  • 用户可执行操作： 查看列表。
  • 自动执行功能： 无。
  • 可跳转页面： 无。
  • 页面主要状态： 展示态。
  • 当前完成情况： 占位实现（5 个硬编码知识点，主题为贝叶斯定理/正态分布/词根/Covariance/梯度下降，无 ViewModel，未接通 API）

6.5 AI 首页（AIHomeView）

  • 页面作用： 原本设计为 AI 功能的聚合首页，包含快速操作入口、每日思考题和 AI 输入。
  • 页面入口： 代码中无任何页面跳转到此页——该页面未接入导航系统，属于废弃页面。
  • 页面组成： 日期 + 服务器状态、Hero 区、Rive 动画占位、4 个快捷操作按钮、每日思考卡片、推荐问题列表、底部输入栏。
  • 用户可执行操作： （理论上的操作，实际不可达）
  • 自动执行功能： 健康检查服务器状态。
  • 可跳转页面： （理论上）ActiveRecallView、WeakPointsPage、AIChatPage、ReviewCardView、DailyThinkingPage。
  • 页面主要状态： 服务器在线/检查中/离线。
  • 当前完成情况： 占位实现（已废弃，无导航入口。Rive 动画标注为占位，推荐问题硬编码）

6.6 回忆测试页（RecallTestPage）

  • 页面作用： 用户对特定知识点进行回忆测试，输入理解后提交，获取 AI 反馈。
  • 页面入口： 代码中无任何页面跳转到此页——Route 枚举中无对应 case，属于代码存在但无导航入口的页面。
  • 页面组成： 提示文字（硬编码："请回忆并写下你对「偏差-方差权衡」的理解"）、TextEditor 回答输入框、"提交"按钮。
  • 用户可执行操作： （理论上的操作，实际不可达）输入答案、提交获取 AI 反馈。
  • 自动执行功能： 无。
  • 可跳转页面： （理论上）AIFeedbackPageView。
  • 页面主要状态： 编辑中 / 提交后跳转。
  • 当前完成情况： 占位实现（无导航入口，题目硬编码，无 ViewModel。注：submitted 状态变量在代码中从未被设置为 true，提交按钮始终可见，可能导致用户重复提交）

七、测验功能（跨模块访问）

7.1 测验列表页（QuizListView）

  • 页面作用： 查看知识库下的所有测验，并可以生成新测验。
  • 页面入口： 知识库详情页操作菜单中的"测验"。
  • 页面组成： 测验列表（含测验标题等信息）、空状态提示（"暂无测验"+"生成测验"按钮）、"生成新测验"按钮。
  • 用户可执行操作： 生成新测验、点击已有测验进入作答。
  • 自动执行功能： 加载该知识库的测验列表。
  • 可跳转页面： QuizTakerView（测验作答）。
  • 页面主要状态： 加载中 / 空（引导生成）/ 有测验列表 / 生成失败（Toast 提示）。
  • 当前完成情况： 已完成

7.2 测验作答页（QuizTakerView）

  • 页面作用： 逐题作答。
  • 页面入口： 测验列表点击测验、学习主页自我测试入口。
  • 页面组成： 进度条（当前题号/总题数）、题目题干、选项/答案区。支持三种题型：选择题（A/B/C/D 单选）、判断题（正确/错误按钮）、填空题（文本输入）。
  • 用户可执行操作： 选择题选择答案、判断正误、输入填空答案、上一题/下一题导航、提交全部答案。
  • 自动执行功能： 提交后自动计算得分。
  • 可跳转页面： QuizResultView（测验结果）。
  • 页面主要状态： 答题中 / 提交中。
  • 当前完成情况： 已完成

7.3 测验结果页（QuizResultView）

  • 页面作用： 展示测验得分和详细答题情况。
  • 页面入口： 测验作答提交后自动跳转。
  • 页面组成： 大号得分数字（低于 60 分红色、高于 60 分绿色）、正确/总题数统计、"重新测验"按钮、逐题详细结果（正确/错误标记 + 解析）。
  • 用户可执行操作： 查看每道题的结果和解析、点击重新测验。
  • 自动执行功能： 加载测验结果详情。
  • 可跳转页面： 无（重新测验回到 QuizTakerView 或 QuizListView）。
  • 页面主要状态： 加载中 / 结果已加载。
  • 当前完成情况： 已完成

八、资料阅读（跨模块访问）

8.1 资料阅读页（MaterialReaderView）

  • 页面作用： 阅读学习资料，支持多种文件格式。
  • 页面入口： 学习主页"继续学习"、学习分析页"继续阅读"、知识库详情页来源文件、知识点详情页。
  • 页面组成：
    • 根据文件类型不同展示不同内容：
      • Markdown/文本/图片：原生渲染（标题、段落、列表、代码块、引用、表格、图片）
      • PDF/Word/Excel：系统预览按钮（QuickLook）
      • PowerPoint：外部打开按钮（ShareLink）
      • 不支持的格式：提示文字
    • 工具栏按钮：标记已读、AI 对话（资料范围）、资料详情、开始学习会话、知识提取
    • 笔记功能入口（Sheet）
    • 解析状态 Toast
  • 用户可执行操作：
    • 阅读/滚动内容
    • 标记已读/取消标记
    • 打开 AI 对话（资料范围）
    • 查看资料详情
    • 开始学习会话
    • 添加笔记
    • QuickLook 预览（PDF/Office）
    • 外部打开（PowerPoint）
  • 自动执行功能：
    • 自动记录阅读位置（2 秒防抖上报）
    • 自动开始/暂停/恢复阅读会话（前后台切换）
    • 自动心跳上报（15 秒间隔）
    • 优先恢复上次阅读位置（API > 本地缓存 > 会话位置）
    • 文件不存在时自动从 COS 下载
    • 后台时自动导出并上传阅读事件
  • 可跳转页面：
    • AIChatPage（资料范围对话）
    • MaterialDetailView（资料详情）
    • LearningSessionView（学习会话）
  • 页面主要状态： 加载中 / 加载失败（重试）/ 已加载·按格式渲染 / 解析状态 Toast。
  • 当前完成情况： 部分完成（核心功能已就位，解析触发使用 60×2s 硬编码轮询，存在改进空间）

8.2 资料详情页（MaterialDetailView）

  • 页面作用： 展示资料的元数据、处理状态和学习统计。
  • 页面入口： 资料阅读页工具栏"信息"按钮。
  • 页面组成：
    • "原始文件"区域：AI 处理状态横幅（处理中/就绪/失败）、文件元数据（名称、格式、大小、上传日期）、阅读进度卡片
    • "学习内容"区域：知识点计数、测验计数
  • 用户可执行操作： 查看文件信息、查看阅读进度、查看关联学习内容。
  • 自动执行功能： 并行加载知识库详情、知识点列表、测验列表、阅读进度。
  • 可跳转页面： 无。
  • 页面主要状态：
    • AI 处理状态：处理中（琥珀色横幅）/ 就绪（绿色横幅）/ 失败（红色横幅）
    • 数据加载中
  • 当前完成情况： 已完成

九、弹窗与 Sheet

9.1 快速笔记（QuickNoteSheet）

  • 页面作用： 在阅读过程中快速添加笔记。
  • 页面入口： 资料阅读页工具栏笔记按钮（以 Sheet 形式弹出）。
  • 页面组成： 资料上下文头部、笔记内容 TextEditor（自动聚焦）、取消/保存按钮。
  • 用户可执行操作： 输入笔记文字、保存或取消。
  • 自动执行功能： 自动获取当前阅读位置作为笔记锚点。
  • 可跳转页面： 无（Sheet 内操作）。
  • 页面主要状态： 编辑中 / 保存后关闭。
  • 当前完成情况： 已完成

9.2 系统预览（QuickLook）

  • 页面作用： 使用系统 QuickLook 预览 PDF、Word、Excel 等 Office 文件。
  • 页面入口： 资料阅读页中非原生支持格式的"系统预览"按钮（以 Sheet 形式弹出）。
  • 页面组成： 系统原生 QLPreviewController。
  • 用户可执行操作： 系统标准的文件预览操作。
  • 自动执行功能： 无。
  • 可跳转页面： 无。
  • 页面主要状态： 加载中 / 预览中。
  • 当前完成情况： 已完成

9.3 AI 会话列表 Sheet

  • 页面作用： 浏览和管理历史 AI 对话会话。
  • 页面入口： AI 对话页工具栏"会话列表"按钮（以 Sheet 形式弹出，支持 .medium 和 .large 展示高度）。
  • 页面组成： 可搜索会话列表，每条显示会话范围和最后消息时间；支持滑动操作（删除、归档）。
  • 用户可执行操作： 搜索会话、切换会话、删除会话、归档会话。
  • 自动执行功能： 根据当前对话范围过滤会话列表。
  • 可跳转页面： 选择会话后关闭 Sheet 并加载对应对话。
  • 页面主要状态： 会话列表 / 搜索中 / 空列表。
  • 当前完成情况： 已完成

9.4 封面选择 Sheet

  • 页面作用： 为知识库选择封面图片。
  • 页面入口： 创建知识库页封面区域点击（以 Sheet 形式弹出，固定高度 220pt）。
  • 页面组成： "从相册选择"选项。
  • 用户可执行操作： 打开系统相册选择图片。
  • 自动执行功能： 图片自动缩放为 512×512。
  • 可跳转页面： 无。
  • 页面主要状态： 选择中。
  • 当前完成情况： 已完成

9.5 链接导入弹窗

  • 页面作用： 输入 URL 以导入链接内容。
  • 页面入口： 导入资料页"链接导入"按钮（以 Alert 形式弹出，含输入框）。
  • 页面组成： 输入框（URL）、确认/取消按钮。
  • 用户可执行操作： 输入链接地址、确认导入。
  • 自动执行功能： 无。
  • 可跳转页面： 无。
  • 页面主要状态： 输入中。
  • 当前完成情况： 已完成

9.6 各类确认弹窗

以下为各页面中使用的系统 Alert 确认弹窗：

弹窗 所在页面 触发操作
删除知识库确认 LibraryDetailPage 操作菜单"删除知识库"
批量删除确认 LibraryDetailPage 批量选择后点击删除
新建文件夹 FolderManageView 点击"新建"
重命名文件夹 FolderManageView 滑动->重命名
退出登录确认 SettingsView 点击"退出登录"
结束学习确认 LearningSessionView 点击"结束"（confirmationDialog）

以上确认弹窗均已完成。