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
+1
View File
@@ -13,6 +13,7 @@
| 待归类 | 尚未确定内容归属的碎片状态 | [内容归属](knowledge-ownership.md) |
| 学习报告 | 一次学习结束后汇总出的结构化学习结果 | [学习报告](learning-report.md) |
| 有效学习时间 | 学习会话中未暂停的实际投入时间 | [时间与效率](time-and-efficiency.md) |
| 复习耗时 | 复习行为(回忆对比、引导追问)的耗时,独立于学习时间 | [时间与效率](time-and-efficiency.md) |
| 任务优先级 | 由多个维度综合计算出的学习任务排序依据 | [任务优先级](priority.md) |
| 应用场景 | 学到的知识可以被使用到什么地方 | [应用场景](application-scenario.md) |
| 复习总览 | 按任务汇总可复习内容、掌握度与最近复习时间的入口 | [复习总览](review-overview.md) |
+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 的关联用标签表达。如果用户持续在同一领域积累旁支碎片,说明该领域已值得作为独立学习任务,此时走“待归类内容升格为学习任务”的路径,而不是给它第二个归属。
+1 -1
View File
@@ -11,7 +11,7 @@
- **按归属分组的碎片**:碎片按内容归属分组呈现;旁支碎片单独列出并标注其归属。
- **自由总结**:用户对本次学习的叙述,包括卡点、疑问和下一步打算。
报告一定属于产生它的那次会话。会话中产生的碎片无论最终归属哪个任务,都会出现在本次报告中,只是分组不同。
报告一定属于产生它的那次会话。会话中产生的碎片无论最终归属哪个任务,都会出现在本次报告中,只是分组不同。复习行为(回忆对比、引导追问)产生的碎片不进入任何报告:报告按会话生成,复习行为不是会话。
## 设计意图
+1
View File
@@ -24,6 +24,7 @@
- 复习起点(或整棵树)。
- 命中、遗漏、额外的节点集合。
- 覆盖率。
- 本次耗时(见[时间与效率](time-and-efficiency.md)的复习耗时)。
回忆记录有三个用途:
+3
View File
@@ -10,6 +10,7 @@
- **可复习内容的规模**:该任务下有多少知识碎片。学习报告不以报告为单位重复计数,它包含的碎片已经在碎片里各出现过一次。
- **掌握度**:该任务最近一次回忆对比的覆盖率。
- **复习耗时**:该任务上回忆对比与引导追问累计的耗时,与学习时长并列展示。
- **最近复习时间**:距上次回忆对比过去了多久。
- **待归类内容**:尚未确定内容归属的碎片,见[内容归属](knowledge-ownership.md)。
@@ -17,6 +18,7 @@
- 用户主动想复习时,需要一个“从哪里开始”的列表。总览只是入口选择,不是必须完成的清单:不产生到期、逾期、落后等压力信号。
- 任务级聚合让复习聚焦在有知识结构的对象上,碎片不单独成为待办项。
- 学习时长与复习耗时并列呈现:让用户看到投入的分布,而不是只有一个总数。
- 待归类内容必须在这里被看见:否则用户不知道有哪些内容还没有归属,归类也就无从发生。
## 相关概念
@@ -25,6 +27,7 @@
- 内容归属:决定内容进入哪个任务,也决定待归类内容是否出现在这里。
- 标准思维导图:从任务进入深度复习的对象。
- 回忆记录与覆盖率:掌握度的来源。
- 复习耗时:与学习时长并列的投入口径。
- 复习 Feed:条目级的偶遇展示,与总览互补。
## 设计思路
+15 -2
View File
@@ -8,6 +8,8 @@
- 有效学习时间:会话中真正处于学习状态的时间,即扣除暂停时间后的投入。
- 有效时间比:有效学习时间占实际使用时间的比例,用于观察学习是否被频繁中断。
复习行为另用「复习耗时」计量,它与上述学习时间独立统计,见下文。
## 设计意图
时间数据帮助用户建立对学习投入的感知,而不是用来评判用户。用户看到一次学习真正投入了多久,可以更合理地估计完成一个任务需要多长时间。
@@ -18,7 +20,18 @@
- 番茄钟等时间刻度只是辅助参考,不是强制约束。
- 系统记录数据,不把“效率低”当成错误,而是让用户看到实际情况。
## 复习耗时
复习耗时是一次复习行为的耗时。它与学习时间分属两条轴,不合并、不换算、不互相比较。
- **覆盖范围**:回忆对比与引导追问。滚动浏览内容不计时。
- **计时边界**:从行为开始到结束;超过 5 分钟没有任何交互,则把耗时截断到上一次交互时间。复习没有“暂停”动作,这条截断规则用来替代暂停。
- **不叫“有效复习时间”,也不套用 10 分钟最小阈值**:复习行为天然是分钟级,套用会话口径会把几乎所有复习耗时清零。
- **用途**:在复习总览中按任务与学习时长并列展示,回答“我在这块内容上复习了多少”。不设目标、不做提醒、不参与“该复习什么”的排序。
## 相关概念
- 学习会话:时间数据记录在会话上。
- 学习任务:任务层面的累计学习时间来自多次会话
- 学习会话:学习时间数据记录在会话上。
- 复习行为:回忆对比与引导追问,复习耗时的来源
- 复习总览:按任务并列展示学习时长与复习耗时。
- 学习任务:任务层面的累计学习时间来自多次会话,累计复习耗时来自多次复习行为。