docs: 新增复习耗时与复习行为口径

This commit is contained in:
cat-shark
2026-09-20 00:06:32 +08:00
parent 5208dd0352
commit 6a445ea7f1
9 changed files with 40 additions and 15 deletions
+8 -6
View File
@@ -8,14 +8,14 @@
它与**记录上下文**是两件事:
- **记录上下文**:这条碎片是在哪次学习会话、哪个任务下产生的。不可变,由系统确定。
- **记录上下文**:这条碎片是在哪次学习会话或哪次复习行为、哪个任务下产生的。不可变,由系统确定。
- **内容归属**:这条碎片在知识结构上属于哪个任务。可变,由用户确定。
系统允许两者不一致。典型场景:在学习 AI 的过程中记下"1B 是 one billion 的缩写",它的记录上下文是 AI 任务,内容归属是英语任务。
**待归类**是没有确定归属的状态。处于待归类的内容不会消失,也不阻塞任何流程,只是暂时不进入任何任务的知识结构。
碎片一定产生于某次学习会话,不存在脱离会话的碎片:待归类只表示内容归属尚未确定,记录上下文始终存在。
碎片一定产生于某次学习会话或某次复习行为,不存在没有记录上下文的碎片:待归类只表示内容归属尚未确定,记录上下文始终存在。
## 要解决的问题
@@ -29,7 +29,7 @@
| 维度 | 数量 | 可变性 | 由谁决定 | 影响 |
|------|------|--------|---------|------|
| 记录上下文 | 一个 | 不可变 | 系统 | 时间统计、学习报告 |
| 记录上下文 | 一个 | 不可变 | 系统 | 时间统计(学习时间按会话、复习耗时按复习行为)、学习报告 |
| 内容归属 | 一个,可为空 | 可变 | 用户(AI 只建议) | 标准思维导图、复习内容、检索 |
| 标签 | 多个,可为空 | 可变 | 用户 | 只影响检索,不影响聚合与统计 |
@@ -37,11 +37,12 @@
## 核心原则
**时间按学习会话统计,内容按内容归属聚合。**
**时间按真实发生的行为统计,内容按内容归属聚合。**
这条原则把两条轴彻底分开:
- 学习时间、有效性、番茄钟、遗忘判定——全部按会话,不受归属影响。一次会话实际投入的时间不会因为碎片被归类到别处而改变。
- 学习时间、有效性、番茄钟、遗忘判定——全部按学习会话,不受归属影响。一次会话实际投入的时间不会因为碎片被归类到别处而改变。
- 复习耗时——按复习行为(回忆对比、引导追问)统计,与学习时间独立,不合并也不换算。
- 标准思维导图的素材、复习内容、按任务的检索——全部按归属,不受产生地点影响。
推论:**学习报告按会话生成**(它是"这次学习产出了什么"的事实记录),而**标准思维导图按归属聚合**。同一份数据因此有两种视角,这是设计意图,不是重复。
@@ -84,12 +85,13 @@
- 标准思维导图:按归属聚合的核心消费者。
- 学习报告:按会话生成,与归属口径不同。
- 复习 Feed:归类动作的最低成本落点,也是旁支内容的复习入口。
- 复习行为(回忆对比、引导追问):另一类记录上下文;追问产生的碎片默认归属被追问概念所属的学习任务。
- AI 任务:只提供归属建议,不作为判定依据。
## 已确认的结论
以下三点于 2026-09-19 由维护者确认:
1. **碎片不可脱离学习会话** 不存在没有记录上下文的内容:任何碎片都产生于某次会话,因此必然参与时间统计,也不存在“无处挂载的碎片”。代价是系统不向可以随手记录的通用笔记工具演进,这是有意的边界。
1. **碎片不可脱离记录上下文** 不存在没有记录上下文的内容:每一条碎片都产生于某次学习会话或某次复习行为(回忆对比、引导追问),因此一定有可追溯的产生场景。代价是系统不向可以随手记录的通用笔记工具演进,这是有意的边界。
2. **学习报告改为结构化呈现。** 报告由会话摘要、预期达成判断、按归属分组的碎片和自由总结组成;旁支碎片仍留在本次报告中,只单独标注归属、不参与正文推演。自由总结必须保留,否则卡点与下一步无处表达。
3. **内容归属保持单一,跨领域关联由标签承担。** 学习内容很少只属于一个领域:一份侧重 A 领域的材料仍会带来 B 领域的碎片,但它仍归属 A,与 B 的关联用标签表达。如果用户持续在同一领域积累旁支碎片,说明该领域已值得作为独立学习任务,此时走“待归类内容升格为学习任务”的路径,而不是给它第二个归属。