docs: add app pages brainstorm + 技术设计 DESIGN.md
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
parent
0eb5f53873
commit
849cad543b
715
app-pages-brainstorm.md
Normal file
715
app-pages-brainstorm.md
Normal file
@ -0,0 +1,715 @@
|
|||||||
|
# 知习 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. 设置页面
|
||||||
|
|
||||||
|
## 待补充
|
||||||
|
|
||||||
|
> 以下内容待你逐个说明后补充。
|
||||||
|
|
||||||
1192
技术设计/DESIGN.md
Normal file
1192
技术设计/DESIGN.md
Normal file
File diff suppressed because it is too large
Load Diff
Loading…
x
Reference in New Issue
Block a user