# 知习 APP 页面整理 > 本文档根据头脑风暴内容整理，只记录已讨论的内容，后续逐步扩展。 --- ## 多端定位 ``` iPhone：阅读、轻问答、复习、自测、继续上次进度、消息提醒、资料状态查看 iPad：深度阅读、PDF 标注、手写笔记、分屏学习、资料旁路问答、导图查看和轻编辑 Mac/Web：知识库管理、批量资料处理、长笔记、结构化整理、完整导图、深度分析、公开知识库管理 ``` > iPhone 不追求完整学习工作台，而是围绕资料消费、轻问答、复习、自测和进度恢复做体验。真正的大屏学习、标注、笔记和知识整理放到 iPad/Mac/Web。 --- ## 整体结构 ``` 知习 APP ├── 登录 ├── 首页（学习） ├── 学习 │ ├── 复习 │ ├── 答题测试 │ └── 消息 ├── 知识库 │ ├── 创建知识库 │ ├── 知识库详情 │ │ └── 知识点预览 │ └── AI 对话 ├── 分析 └── 我的 ├── 个人中心 └── 设置 ``` --- ## 底部导航 Tab | Tab | 说明 | | --- | --- | | 首页 | 学习页面 | | 知识库 | 资料、知识点、问答入口 | | 分析 | AI 诊断、学习结果 | | 我的 | 账号、设置、许可、反馈 | --- ## 已有页面 ### 1. 登录页面 **功能模块** - Apple 登录（已接入） - 微信登录（后续） - 手机号登录（后续） - Rive 状态机动画 > 待继续扩展 --- ### 2. 首页（学习页面） **定位**：学习行动面板，回答——我现在该做什么。 **主行动优先级**（首页第一屏只强调一个主行动） | 优先级 | 条件 | 主卡片 | | --- | --- | --- | | 1 | 有未完成学习 | 继续上次学习 | | 2 | 无未完成、有今日复习 | 今日复习 | | 3 | 无复习、有新自测 | 资料自测 | | 4 | 有新资料整理完成 | 开始学习 | | 5 | 空状态 | 引导去知识库添加资料 | **核心模块** - **继续上次学习** — 恢复具体学习上下文（回忆做到一半/分析没看完/测验做到一半/复习做到一半），文案带状态，如「你上次停在《数据库事务》的主动回忆，第 4/10 个知识点」 - **今日复习入口** — 只告知有复习任务和大概时长，不展开卡片列表；复习详情和薄弱点分析分别由复习页、分析页负责 - **资料自测入口** — 区分于复习（复习=系统安排长期巩固，自测=用户主动即时检测），叫「资料自测」不叫「测验」 - **本周学习进度摘要** — 本周时长、完成学习次数、完成复习数量、连续学习天数（可选），轻量反馈，→ 查看分析 - **状态提示** — 轻量 banner：资料整理中/整理失败/整理完成、测验生成中、复习卡生成中 **页面布局** - 第一屏：顶部轻状态文案 + 主行动卡片 - 中部：今日复习小卡、资料自测小卡、处理中/新资料完成提示 - 底部：本周进度摘要 + 查看分析入口 **优先级** - P0：继续上次学习、今日复习、资料自测、本周进度摘要 - P1：新资料整理完成提示、处理中/失败状态提示 - P2：最近完成记录、连续学习天数 --- ### 3. 学习页面 **定位**：学习行动中心。主动回忆、AI 诊断、学习结果。 > 待扩展 --- ### 复习页面 **上级**：学习页面 **定位**：今日复习、复习卡、复习结果。从学习页面进入。 > 待扩展 --- ### 4. 知识库页面 **定位**：内容中心。管理我的知识库、查看已订阅和官方知识库，所有信息服务于下一步学习。 **知识库分类**（三类，不混） | 分类 | 说明 | | --- | --- | | 我的知识库 | 用户自己创建/上传资料生成的 | | 已订阅知识库 | 订阅了别人公开的知识库 | | 官方/精选知识库 | 平台发布或平台认证的 | 用户自己创建的，哪怕公开了也叫「公开知识库」或「个人知识库」，不叫「官方」。 **实体字段** ``` ownerType: user / official visibility: private / public / unlisted relation: owned / subscribed / official isPinned: true / false isVerified: true / false ``` **页面结构** - 顶部：标题「知识库」+ 搜索入口 + 右上角 + - 筛选 chips：全部 ｜ 我的 ｜ 已订阅 ｜ 官方 - 列表：置顶区 + 普通列表 - 交互：下拉刷新、上拉加载 **搜索** - 列表页顶部保留搜索入口，点击进入独立搜索页 `KnowledgeSearchView` - 搜索页按范围切换：知识库 / 资料 / 知识点 / 公开知识库 - 支持作用域：我的内容 / 已订阅 / 官方公开 / 全部 **创建知识库** - 右上角 +，点击可弹出小菜单：「创建知识库」「上传资料」，或直接进入 `CreateKnowledgeBaseView` --- **知识库卡片字段** - 名称 - 简介 - 类型标签：官方 / 已订阅 / 公开 / 私有 - 资料数量、知识点数量、测验数量 - 最近学习时间 - 学习进度 - 导入状态（整理中/失败/完成） - 置顶状态 卡片要点：不只展示资料状态，要体现「可学习」。 **卡片操作**（按类型区分） - 我的知识库：重命名、上传资料、公开设置、置顶、删除 - 已订阅知识库：置顶、取消订阅、查看来源、生成我的学习内容 - 官方知识库：置顶、开始学习、订阅、查看来源 **置顶** - 置顶是用户个人行为，只影响自己的列表 - 置顶区不随分页重复出现 - 第一版支持置顶/取消置顶，不做多级收藏夹、拖拽排序、分组命名 **排序** - 默认：置顶优先 → 最近学习 → 最近更新 - 可提供排序入口：最近学习 / 最近更新 / 创建时间 / 名称 **订阅公开知识库**（第一版克制） - 支持：展示已订阅、搜索发现公开库、官方精选入口、订阅/取消订阅 - 暂不做：信息流、创作者主页、评论区、排行榜、付费订阅、二创市场 **数据边界** - 知识库内容 → 归属原作者 - 学习记录 → 归属当前用户 - 复习卡 → 可归属当前用户 - 测验结果 → 归属当前用户 - 订阅库 → 只读，不可改原内容 **空状态**（分场景） - 全部为空：还没有知识库，可上传资料让知习整理成可学习的内容 - 我的为空：还没有创建自己的知识库 - 已订阅为空：还没有订阅公开知识库 - 官方为空：暂时没有官方知识库 **状态** - 加载中 - 加载失败 - 无网络 - 导入中/失败提示（如「正在整理 2 份资料」「1 份资料导入失败」） --- **优先级** - P0：知识库列表、筛选、搜索入口、创建入口、置顶、下拉刷新、上拉加载、卡片状态展示、空状态/错误状态/加载状态 - P1：公开知识库发现、订阅/取消订阅、官方精选入口、排序切换、只读提示、导入失败提醒 - P2：收藏分组、拖拽排序、创作者主页、排行榜、付费订阅、协作知识库 --- ### 4-1. 知识库创建页面 **定位**：轻量创建，用户只填名称就能创建成功。 **表单字段** - 知识库封面：选填，默认已选中系统封面，点击弹出底部抽屉切换 - 知识库名称：必填，最多 30～40 字，不能全空格，允许同名 - 知识库描述：选填，最多 200 字 **按钮**：创建知识库（名称填写后才可点击） **创建成功**：直接进入知识库详情页，展示下一步引导「上传资料后，知习会帮你整理知识点」 **创建失败**：展示错误提示，可重试；封面上传失败时提供「先用默认封面创建」降级方案 --- **封面规则** - 比例 1:1，建议 512×512，支持 JPG/PNG/HEIC，大小限制 5～10MB - 用户选图 → 正方形裁剪 → 上传 - 数据结构：`coverType: system/custom`，系统封面由 `coverIcon + coverColor` 组合 **底部封面抽屉（CoverPickerSheet）** - 默认封面：一组图标 + 背景色可选（书本/笔记/代码/考试等） - 自定义：从相册选择、恢复默认封面 --- **描述处理** - 输入框 placeholder：「例如：整理数据库课程笔记、复习题和考试重点」 - 用户不填不强制，列表卡片通过 fallback 兜底：「包含 4 份资料，最近添加《数据库事务笔记》」「还没有添加资料」 - 知识库卡片不依赖描述作为布局必需项 --- **创建页不放** 上传资料、选择公开范围、选择协作者、复杂标签——这些不是创建页该承担的功能。创建的知识库默认私有，公开设置后续在详情页加入。 --- **优先级** - P0：名称、系统默认封面、创建按钮、创建成功跳转详情页 - P1：自定义封面上传裁剪、底部抽屉封面选择器 - P2：AI 智能描述建议、「帮我生成描述」按钮 --- ### 4-2. 知识库详情页面 **定位**：知识库内部的学习内容工作台。看概览、管资料、管知识点、开始学习、问答、自测。 --- **顶部信息区** - 封面、名称、描述（空时 fallback：「还没有描述。上传资料后，知习会根据内容整理知识点」） - 类型标签：私有/公开/已订阅/官方 - 资料数、知识点数、测验数、最近学习时间、导入状态 **快捷操作区**（仅 owned 知识库显示完整操作） - 开始学习 - 上传资料 - 资料自测 - 问资料（ZxIcon(.aiChat)，点击进入独立 KnowledgeBaseChatView，默认绑定当前知识库） 主按钮动态变化：有知识点→开始学习，有资料处理中→查看导入进度，没有资料→上传资料 **分区**（分段控件或 chips） 概览 ｜ 资料 ｜ 知识点 ｜ 测验 ｜ 问答 --- **知识点列表**（主内容区） 卡片字段：标题、摘要、所属分类/章节、来源资料、掌握状态、是否已生成复习卡、最近学习时间 操作： - 点击 → 知识点详情页 - 左滑 → 删除/移动分类 - 更多 → 编辑/加入复习/开始回忆 - 右上角选择 → 批量删除/移动分类/生成复习卡/开始学习（P1） **新增知识点** - 点击 + → 底部抽屉选择入口（手动新增/从资料生成/上传资料生成/批量导入） - 手动新增进入独立 CreateKnowledgeItemView（标题、内容摘要、所属分类、来源说明、是否生成复习卡） --- **分类**（不叫「文件夹」） - 叫「分类/章节/主题」 - P0：单层分类（未分类、自定义分类、创建/重命名/删除分类、知识点移动分类） - P1：二级章节 - P2：标签系统（#易错 #考试重点 #概念辨析） --- **资料区** - 资料列表、导入状态、进入资料详情、重新处理、删除资料、查看生成的知识点 - 导入失败明确提示 **测验区** - 知识库下全部测验，按资料/分类生成 - 操作：开始测验、重新生成、查看结果 - 第一版可很轻：「测验 3 个，最近测验：《传输层基础》10 题」 **问答区** - 最近问答、常用问题建议、问答历史、进入完整问答 - 不直接塞完整聊天 --- **问资料入口** - 快捷操作区放聊天图标→进入 KnowledgeBaseChatView - 默认范围=当前知识库，回答必须带引用来源 - 支持范围切换：整个知识库/当前分类/当前资料/当前知识点 - 没有检索到来源时提示「当前知识库中没有找到足够相关的内容」 - 第一版不做跨知识库提问 - 底部不做常驻可输入聊天框 **知识库管理入口** - 右上角 ··· → 底部抽屉（编辑信息/分类管理/公开设置/删除知识库） - 编辑信息、分类管理等具体管理进独立页面 --- **权限区分**（详情页根据权限变化） | 权限 | 可操作 | | --- | --- | | owned | 编辑、新增、删除、学习、自测、问答 | | subscribed | 只读，可学习、复习、自测、问答、取消订阅 | | official | 只读，可学习、自测、订阅 | --- **删除知识点** - 左滑 → 二次确认 - 批量删除 → 明确提示数量 - 删除后关联复习卡失效/归档，不硬删学习记录 --- **页面拆分策略** - 当前页面：概览、资料摘要、知识点列表、分类筛选、左滑删除 - 底部抽屉：新增入口选择、更多操作菜单、排序筛选、删除确认 - 独立页面：新增/编辑知识点、知识点详情、知识库管理、分类管理、资料详情、测验列表/过程、知识库问答 --- **优先级** - P0：顶部信息、资料列表、知识点列表、新增/删除知识点、分类筛选、上传/学习/问答入口、知识库管理入口、空/加载/错误状态 - P1：分类管理、批量操作、测验列表、公开设置、订阅库只读状态、导入失败处理 - P2：多级分类、标签系统、知识图谱、协作编辑、版本历史 --- ### 知识点预览页面 **上级**：知识库详情页面 **定位**：移动端轻阅读学习单元，不是完整学习主场。 **负责** - 查看知识点内容 - 查看引用来源 - 问这个知识点（进入 AI 对话） - 加入复习 / 收藏 - 轻量备注 - 开始自测 / 开始复习 **不负责**（留给 iPad/Mac/Web） - 长笔记、复杂标注 - 多窗口对照资料 - 手写整理、导图编辑 - 系统化重构知识 --- ### 答题测试页面 **上级**：学习页面 **定位**：用户答题/自测。从首页、知识库详情页等入口进入。 > 待扩展 --- ### AI 对话页面 **上级**：知识库页面 **定位**：基于知识库/资料/分类的学习问答与产物生成页。不是普通聊天，绑定知识库上下文，回答带引用来源。 **页面结构** - 顶部：返回、当前范围（知识库名）、会话切换按钮、更多 - 上下文提示条：「基于「计算机网络」回答」，可切换范围 - 消息区：用户问题、AI 回答、引用来源、生成中/错误/重试状态 - 底部输入区：添加文件、输入框、发送按钮、模式按钮（快速/深度/联网） **空状态** 提示示例按范围变化： - 知识库级：「总结这个知识库的核心内容」「找出最重要的知识点」 - 资料级：「总结这份资料」「提取关键概念」「根据这份资料生成测验」 - 知识点级：「解释这个概念」「举一个例子」「找出容易混淆的地方」 --- **P0 功能** - 当前知识库上下文问答 - 新建/切换/删除会话（删除二次确认，区分：删除会话 ≠ 删除知识库/资料/学习记录） - AI 提示问题 - 回答引用来源、复制、分享（分享私有知识库内容需提醒用户确认） - 保存为笔记（保存到当前知识库） - 重新生成 - 文本输入发送 - 加载/失败/重试状态 **P1 功能** - 切换提问范围：整个知识库/当前分类/当前资料 - 添加文件到知识库（区分临时提问 vs 入库资料，P0 先只做到入库） - 深度思考模式、联网搜索模式（默认关闭，仅知识库回答） - 生成导图、生成测验、生成复习卡 - 模型选择（高级设置，普通用户看到「快速/深度/联网」而非模型名） - 会话重命名/搜索 - 语音转文字提问 **P2 功能** - 跨知识库问答 - 临时文件问答 - 生成播客脚本/音频播客 - 上传音频资料转写 - 多模态图片/视频问答 - 会话分享链接 - 协作会话 --- **AI 回答卡片操作** 引用来源 | 复制 | 分享 | 保存为笔记 | 重新生成 | 更多（生成导图/生成测验/生成复习卡/反馈） **模式切换** 普通用户：快速 / 深度 / 联网 高级用户/设置中：具体模型选择 - 默认仅知识库回答，联网搜索开启后需区分「知识库引用」和「网络来源」 - 深度思考提示更慢、消耗更多额度 **核心边界** 第一版收敛为：基于当前知识库提问 → 回答带引用 → 可保存为学习材料 不堆模型市场、语音通话、播客、多模态、跨库 Agent --- ### 5. 分析页面 **定位**：反馈中心。告诉用户学了多少、记住了多少、哪里薄弱、为什么薄弱、下一步该做什么。 **核心逻辑链** ``` 学了多少 → 有没有坚持 → 复习得怎么样 → 答题表现怎么样 → 哪些掌握了 → 哪些薄弱 → 为什么薄弱 → 下一步做什么 ``` **移动端定位**：随手查看学习反馈，摘要 + 关键趋势 + AI 结论。完整图表和深度分析留给 iPad / Web。 --- **移动端结构** **a. 顶部总览卡片**（3～4 个关键数字） - 本周学习时长 - 累计学习时长 - 本周复习次数 - 测验正确率 **b. 学习热力图** - 近 30 天 / 近 90 天 - 点击某天显示：当天学习时长、完成知识点、复习卡数、测验数 - 强度综合计算（学习时长 + 主动回忆次数 + 复习次数 + 测验完成数），第一版可先用学习时长 **c. 本周学习趋势**（一个简单折线或柱状图即可） **d. 复习表现摘要** - 本周复习完成率 - 到期未复习数量 - 容易遗忘知识点数量 **e. 测验表现摘要** - 最近测验正确率 - 高频错误知识点 Top 3 - 最近一次测验结果 **f. 知识掌握摘要** - 掌握较好 / 需要巩固 / 可能遗忘 - Top 3～5 薄弱知识点 - 掌握度来源综合：主动回忆表现、复习自评、测验正确率、遗忘间隔、AI 诊断结果 **g. AI 综合分析卡片** - 本周总结 - 主要薄弱点 - 薄弱原因 - 下一步建议 - 展示分析依据（如「最近 3 次测验中隔离级别相关题目正确率较低」） - → 查看详细分析 --- **知识库维度筛选** 按知识库切换查看：全部 / 计算机网络 / 数据库 / 操作系统 / 官方 / 订阅 每个知识库显示：学习时长、知识点掌握、复习完成、测验表现、薄弱点 --- **移动端不放** 复杂知识库对比、多维筛选器、完整错题分析、题型正确率矩阵、复习预测曲线、学习效率评分、知识图谱、月报/年报完整详情、导出报告、排行榜 --- **iPad / Web 扩展** - iPad：左右分栏，左侧总览+热力图+AI 分析，右侧复习+测验+知识库掌握度 - Web：完整仪表盘，时间范围筛选、知识库筛选、多维图表、导出报告 --- **优先级** - P0：总览卡片、学习热力图、复习摘要、测验摘要、薄弱知识点 Top 5、AI 综合分析 - P1：记忆状态分布（刚开始学/正在巩固/基本掌握/长期记住/可能遗忘）、复习准时率、高频错误概念、知识库对比、周报/月报、即将遗忘提醒、学习目标 - P2：考试倒计时计划、预测复习负载、学习效率评分、同类用户对比、排行榜、公开报告分享 --- ### 消息页面 **上级**：学习页面 **定位**：消息与通知汇总。从「我的页面」消息中心入口进入。 > 待扩展 --- ### 6. 我的页面 **定位**：个人中心。身份展示 + 学习资产 + 常用入口。 **a. 个人信息区** - 头像、昵称、邮箱/账号 - 账号状态 - 编辑资料入口 - 右上角设置按钮 **b. 学习资产摘要**（轻量，增强「我在这里有资产」的感觉） - 知识库数量、资料数量、知识点数量、复习卡数量 - 点击分别跳转对应页面 **c. 常用入口** - 消息中心（导入完成/失败、复习提醒、测验生成完成、AI 分析完成、订阅更新、系统通知） - 存储空间（云端空间、资料文件占用、离线缓存占用、剩余空间） - 缓存管理（清理图片/文件预览/离线资料/临时上传文件缓存，明确不删云端资料） - 我的订阅 - 用量与额度（可选，P1） > 退出登录、注销账号、隐私政策、用户协议、开源许可、帮助反馈等低频操作不放首页，统一进设置页。 **优先级** - P0：个人信息区、学习资产摘要、消息中心、存储空间/缓存管理、设置入口 - P1：用量与额度、我的订阅 - P2：成就徽章、学习报告分享 --- ### 5-1. 设置页面 **定位**：账号、安全、通知、学习偏好、存储、隐私、反馈、合规的集中管理。从「我的页面」进入。 | 分组 | 内容 | | --- | --- | | 账号与安全 | 个人资料、绑定邮箱/Apple 登录、登录设备、退出登录、注销账号 | | 学习偏好 | 每日学习提醒、默认复习时间、复习强度、测验题数偏好、AI 诊断详细程度 | | 通知设置 | 复习提醒、导入完成、测验生成、订阅更新、系统通知 | | 数据与存储 | 存储空间、缓存管理、离线内容、数据导出（P1） | | 隐私与公开 | 公开知识库设置、订阅可见性、学习记录隐私、数据权限说明 | | 支持与反馈 | 帮助中心、问题反馈、功能建议、联系我们 | | 关于与合规 | 关于知习、用户协议、隐私政策、开源许可、第三方资源署名、版本号 | **优先级** - P0：账号与安全、通知设置、数据与存储、隐私与公开、支持与反馈、关于与合规 - P1：学习偏好、数据导出、登录设备管理 - P2：注销账号 --- ### 6-2. 个人中心页面（编辑资料） **定位**：只修改用户在知习内展示的个人身份信息。不承担账号安全、注销、隐私协议等。 --- **P0 字段** - 头像（圆形，1:1，支持 JPG/PNG/HEIC，≤5MB，点击→底部抽屉选择默认头像/从相册选择/恢复默认） - 昵称（必填，最多 20 中文/30 英文，允许中英文数字常见符号） - 个人简介（选填，最多 80～120 字，不填不展示简介区域） **邮箱**：展示但不可修改，→ 前往账号与安全修改 --- **页面交互** - 右上角保存，或底部固定保存按钮 - 未修改→保存置灰，修改后→可点击，保存中→loading，成功→toast，失败→错误可重试 - 离开时有未保存内容→提示确认 **头像底部抽屉** - 选择默认头像（一组可选，不要只有一个）+ 从相册选择（进裁剪固定 1:1）+ 恢复默认头像 --- **不放** 性别、生日、学校、职业、地区、手机号、真实姓名、学习目标（放学习偏好）、隐私设置、账号注销、退出登录 --- **优先级** - P0：头像、昵称、个人简介、保存 - P1：@handle/知习号、公开主页预览、默认头像库 - P2：创作者主页资料、社交链接、公开知识库作者认证 --- ### 6-1. 设置页面 ## 待补充 > 以下内容待你逐个说明后补充。