22 KiB
知习 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. 设置页面
待补充
以下内容待你逐个说明后补充。