startup-plan/app-pages-brainstorm.md
wangdl 849cad543b docs: add app pages brainstorm + 技术设计 DESIGN.md
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-15 21:54:52 +08:00

716 lines
22 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 知习 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. 知识库创建页面
**定位**:轻量创建,用户只填名称就能创建成功。
**表单字段**
- 知识库封面:选填,默认已选中系统封面,点击弹出底部抽屉切换
- 知识库名称:必填,最多 3040 字,不能全空格,允许同名
- 知识库描述:选填,最多 200 字
**按钮**:创建知识库(名称填写后才可点击)
**创建成功**:直接进入知识库详情页,展示下一步引导「上传资料后,知习会帮你整理知识点」
**创建失败**:展示错误提示,可重试;封面上传失败时提供「先用默认封面创建」降级方案
---
**封面规则**
- 比例 1:1建议 512×512支持 JPG/PNG/HEIC大小限制 510MB
- 用户选图 → 正方形裁剪 → 上传
- 数据结构:`coverType: system/custom`,系统封面由 `coverIcon + coverColor` 组合
**底部封面抽屉CoverPickerSheet**
- 默认封面:一组图标 + 背景色可选(书本/笔记/代码/考试等)
- 自定义:从相册选择、恢复默认封面
---
**描述处理**
- 输入框 placeholder「例如整理数据库课程笔记、复习题和考试重点」
- 用户不填不强制,列表卡片通过 fallback 兜底:「包含 4 份资料,最近添加《数据库事务笔记》」「还没有添加资料」
- 知识库卡片不依赖描述作为布局必需项
---
**创建页不放**
上传资料、选择公开范围、选择协作者、复杂标签——这些不是创建页该承担的功能。创建的知识库默认私有,公开设置后续在详情页加入。
---
**优先级**
- P0名称、系统默认封面、创建按钮、创建成功跳转详情页
- P1自定义封面上传裁剪、底部抽屉封面选择器
- P2AI 智能描述建议、「帮我生成描述」按钮
---
### 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. 顶部总览卡片**34 个关键数字)
- 本周学习时长
- 累计学习时长
- 本周复习次数
- 测验正确率
**b. 学习热力图**
- 近 30 天 / 近 90 天
- 点击某天显示:当天学习时长、完成知识点、复习卡数、测验数
- 强度综合计算(学习时长 + 主动回忆次数 + 复习次数 + 测验完成数),第一版可先用学习时长
**c. 本周学习趋势**(一个简单折线或柱状图即可)
**d. 复习表现摘要**
- 本周复习完成率
- 到期未复习数量
- 容易遗忘知识点数量
**e. 测验表现摘要**
- 最近测验正确率
- 高频错误知识点 Top 3
- 最近一次测验结果
**f. 知识掌握摘要**
- 掌握较好 / 需要巩固 / 可能遗忘
- Top 35 薄弱知识点
- 掌握度来源综合主动回忆表现、复习自评、测验正确率、遗忘间隔、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 英文,允许中英文数字常见符号)
- 个人简介(选填,最多 80120 字,不填不展示简介区域)
**邮箱**:展示但不可修改,→ 前往账号与安全修改
---
**页面交互**
- 右上角保存,或底部固定保存按钮
- 未修改→保存置灰修改后→可点击保存中→loading成功→toast失败→错误可重试
- 离开时有未保存内容→提示确认
**头像底部抽屉**
- 选择默认头像(一组可选,不要只有一个)+ 从相册选择(进裁剪固定 1:1+ 恢复默认头像
---
**不放**
性别、生日、学校、职业、地区、手机号、真实姓名、学习目标(放学习偏好)、隐私设置、账号注销、退出登录
---
**优先级**
- P0头像、昵称、个人简介、保存
- P1@handle/知习号、公开主页预览、默认头像库
- P2创作者主页资料、社交链接、公开知识库作者认证
---
### 6-1. 设置页面
## 待补充
> 以下内容待你逐个说明后补充。