docs: 新增会话误操作零数据结束

This commit is contained in:
cat-shark
2026-08-15 21:24:56 +08:00
parent 9d80275ef3
commit 9cb9c7541d
4 changed files with 20 additions and 5 deletions
+1 -1
View File
@@ -5,7 +5,7 @@
| 概念 | 一句话定义 | 详细文档 |
|------|-----------|----------|
| 学习任务 | 一份学习材料或学习目标对应的最小可管理单元 | [学习任务](learning-task.md) |
| 学习会话 | 针对某个学习任务的一次连续学习过程 | [学习会话](study-session.md) |
| 学习会话 | 针对某个学习任务的一次连续学习过程;误操作开启时可零数据关闭 | [学习会话](study-session.md) |
| 学习预期 | 开始学习前对本次学习目标的描述 | [学习预期](learning-expectation.md) |
| 知识碎片 | 学习中随手记录的不完整内容,也称“学习报告残片” | [知识碎片](knowledge-fragment.md) |
| 学习报告 | 一次学习结束后汇总出的完整学习结果 | [学习报告](learning-report.md) |
+3 -1
View File
@@ -4,7 +4,9 @@
学习预期是用户在开始一次学习会话前写下的目标描述,例如“理解线程池的核心参数”或“读完第三章并整理要点”。
学习预期在会话开始必须填写,不能为空。
学习预期在会话开始后、正式开始学习前必须填写,不能为空。
如果会话是被误操作开启的,用户可以在填写预期前选择「误操作结束」零数据关闭本次会话;此时不需要填写预期,已填写的预期也会随会话一并删除。
## 设计意图
+11 -2
View File
@@ -10,6 +10,15 @@
- 暂停:用户暂时离开,学习进度被保留。
- 已结束:本次学习完成,并产出学习报告。
## 误操作结束
用户可能误操作开启了一次学习会话。在本次会话尚未产生任何学习残片时,系统允许以「误操作结束」的方式关闭它,并保证不留下任何数据:会话记录与学习预期一并删除,不产生学习残片,也不产生学习报告。系统视角下,这次会话从未发生过。
误操作结束有两个约束:
- 必须输入确认语「我误操作导致开启了本次学习」才能关闭,防止用户误删真实的学习数据。
- 仅当本次会话尚未产生学习残片时可用;一旦产生过残片,只能按正常流程结束。
## 设计意图
学习会话把“学习”从模糊的时间块变成可记录、可恢复、可比较的过程。系统通过会话记录:
@@ -20,11 +29,11 @@
## 相关概念
- 学习预期:会话开始时必须记录
- 学习预期:会话正式学习前记录;误操作结束时不保留
- 知识碎片:会话过程中产生。
- 学习报告:会话结束时汇总生成。
- 学习任务:会话所属的上层对象。
## 设计思路
一个会话应当是连续的单元,而不是把一次学习拆成多个互不相关的片段。会话可以暂停和恢复,但不鼓励长时间搁置;长时间未继续的会话应被视为自然结束,避免遗留无意义的进行中状态。
一个会话应当是连续的单元,而不是把一次学习拆成多个互不相关的片段。会话可以暂停和恢复,但不鼓励长时间搁置;长时间未继续的会话应被视为自然结束,避免遗留无意义的进行中状态。误操作结束是这条思路的例外出口:错误的开始可以被干净地撤销,而不是被迫留下一段无意义的数据。
+5 -1
View File
@@ -5,7 +5,7 @@
```text
学习任务
开始学习会话
开始学习会话 ──误操作──→ 零数据关闭(不产生任何数据)
记录学习预期
@@ -26,6 +26,10 @@
预期让每次学习有明确目标。目标不需要宏大,只需要让用户知道自己这次要完成什么。
### 误操作结束(零数据关闭)
如果会话是被误操作开启的,用户可以在尚未产生学习残片时,通过输入确认语「我误操作导致开启了本次学习」零数据关闭本次会话。该分支不进入学习预期、知识碎片与学习报告环节,会话记录与学习预期一并删除,系统视角下会话从未发生。确认语是为了防止真实学习数据被误删。
### 知识碎片
碎片是学习过程中的真实记录。它降低了“边学边记”的成本,让学习内容不会在会话结束时才靠回忆重建。