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

docs/concepts/README.md

@@ -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) |

docs/concepts/knowledge-ownership.md

@@ -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 的关联用标签表达。如果用户持续在同一领域积累旁支碎片，说明该领域已值得作为独立学习任务，此时走“待归类内容升格为学习任务”的路径，而不是给它第二个归属。

docs/concepts/learning-report.md

@@ -11,7 +11,7 @@
 - **按归属分组的碎片**：碎片按内容归属分组呈现；旁支碎片单独列出并标注其归属。
 - **自由总结**：用户对本次学习的叙述，包括卡点、疑问和下一步打算。
 
-报告一定属于产生它的那次会话。会话中产生的碎片无论最终归属哪个任务，都会出现在本次报告中，只是分组不同。
+报告一定属于产生它的那次会话。会话中产生的碎片无论最终归属哪个任务，都会出现在本次报告中，只是分组不同。复习行为（回忆对比、引导追问）产生的碎片不进入任何报告：报告按会话生成，复习行为不是会话。
 
 ## 设计意图
 

docs/concepts/recall-review.md

@@ -24,6 +24,7 @@
 - 复习起点（或整棵树）。
 - 命中、遗漏、额外的节点集合。
 - 覆盖率。
+- 本次耗时（见[时间与效率](time-and-efficiency.md)的复习耗时）。
 
 回忆记录有三个用途：
 

docs/concepts/review-overview.md

@@ -10,6 +10,7 @@
 
 - **可复习内容的规模**：该任务下有多少知识碎片。学习报告不以报告为单位重复计数，它包含的碎片已经在碎片里各出现过一次。
 - **掌握度**：该任务最近一次回忆对比的覆盖率。
+- **复习耗时**：该任务上回忆对比与引导追问累计的耗时，与学习时长并列展示。
 - **最近复习时间**：距上次回忆对比过去了多久。
 - **待归类内容**：尚未确定内容归属的碎片，见[内容归属](knowledge-ownership.md)。
 
@@ -17,6 +18,7 @@
 
 - 用户主动想复习时，需要一个“从哪里开始”的列表。总览只是入口选择，不是必须完成的清单：不产生到期、逾期、落后等压力信号。
 - 任务级聚合让复习聚焦在有知识结构的对象上，碎片不单独成为待办项。
+- 学习时长与复习耗时并列呈现：让用户看到投入的分布，而不是只有一个总数。
 - 待归类内容必须在这里被看见：否则用户不知道有哪些内容还没有归属，归类也就无从发生。
 
 ## 相关概念
@@ -25,6 +27,7 @@
 - 内容归属：决定内容进入哪个任务，也决定待归类内容是否出现在这里。
 - 标准思维导图：从任务进入深度复习的对象。
 - 回忆记录与覆盖率：掌握度的来源。
+- 复习耗时：与学习时长并列的投入口径。
 - 复习 Feed：条目级的偶遇展示，与总览互补。
 
 ## 设计思路

docs/concepts/time-and-efficiency.md

@@ -8,6 +8,8 @@
 - 有效学习时间：会话中真正处于学习状态的时间，即扣除暂停时间后的投入。
 - 有效时间比：有效学习时间占实际使用时间的比例，用于观察学习是否被频繁中断。
 
+复习行为另用「复习耗时」计量，它与上述学习时间独立统计，见下文。
+
 ## 设计意图
 
 时间数据帮助用户建立对学习投入的感知，而不是用来评判用户。用户看到一次学习真正投入了多久，可以更合理地估计完成一个任务需要多长时间。
@@ -18,7 +20,18 @@
 - 番茄钟等时间刻度只是辅助参考，不是强制约束。
 - 系统记录数据，不把“效率低”当成错误，而是让用户看到实际情况。
 
+## 复习耗时
+
+复习耗时是一次复习行为的耗时。它与学习时间分属两条轴，不合并、不换算、不互相比较。
+
+- **覆盖范围**：回忆对比与引导追问。滚动浏览内容不计时。
+- **计时边界**：从行为开始到结束；超过 5 分钟没有任何交互，则把耗时截断到上一次交互时间。复习没有“暂停”动作，这条截断规则用来替代暂停。
+- **不叫“有效复习时间”，也不套用 10 分钟最小阈值**：复习行为天然是分钟级，套用会话口径会把几乎所有复习耗时清零。
+- **用途**：在复习总览中按任务与学习时长并列展示，回答“我在这块内容上复习了多少”。不设目标、不做提醒、不参与“该复习什么”的排序。
+
 ## 相关概念
 
-- 学习会话：时间数据记录在会话上。
-- 学习任务：任务层面的累计学习时间来自多次会话。
+- 学习会话：学习时间数据记录在会话上。
+- 复习行为：回忆对比与引导追问，复习耗时的来源。
+- 复习总览：按任务并列展示学习时长与复习耗时。
+- 学习任务：任务层面的累计学习时间来自多次会话，累计复习耗时来自多次复习行为。

docs/design/module-boundaries.md

@@ -25,6 +25,7 @@
 - 滚动展示知识碎片（复习 Feed）。
 - 维护标准思维导图。
 - 提供回忆对比、回忆记录和遗漏项回溯。
+- 记录复习耗时（回忆对比与引导追问）。
 - 承接内容归属的调整动作与待归类内容的处理入口。
 
 复习模块不要求用户逐条整理学习材料，材料是自动整理和对照分析的数据来源。复习按内容归属聚合，而不是按内容产生于哪次会话：这是归类动作与复习动作放在一起的原因。复习不做调度：不生成到期清单，只影响内容的出现概率。
@@ -48,5 +49,5 @@ AI 能力可替换、可降级，不影响学习执行和复习的基本流程
 - 执行模块产生数据。
 - 复习模块消费数据并形成反馈。
 - 应用场景定义学习目标。
-- 时间轴与内容轴分离：时间按学习会话统计，内容按内容归属聚合。
+- 时间轴与内容轴分离：时间按行为统计（学习会话→学习时间，复习行为→复习耗时），内容按内容归属聚合。
 - AI 模块增强整理与对比，但不承担核心闭环的完整性。

docs/design/review-loop.md

@@ -33,13 +33,17 @@
 | 应用场景 | 复习的现实语境，参与导图 |
 | 回忆记录 | 复习产生的历史，用于展示掌握变化与计算任务掌握度 |
 
-学习时间与效率数据不进入复习内容：它们属于时间轴，回答的是投入了多少，而不是记得怎么样。
+学习时间与复习耗时都不进入复习内容：它们回答的是投入了多少，而不是记得怎么样。复习耗时只在复习总览里与学习时长并列呈现。
 
 ## 复习的两个层级
 
 - **任务级**：复习总览回答“从哪个任务开始复习”，见 [复习总览](../concepts/review-overview.md)。
 - **内容级**：复习 Feed 回答“这次遇到哪条内容”，见 [复习 Feed](../concepts/review-feed.md)。
 
+## 复习耗时
+
+复习行为（回忆对比、引导追问）会记录耗时，与学习时间独立统计：不合并、不换算，也不参与“该复习什么”的排序。口径、截断规则与展示方式见[时间与效率](../concepts/time-and-efficiency.md)与[复习总览](../concepts/review-overview.md)。
+
 ## 从轻量复习到深度复习
 
 ```text

docs/design/system-structure.md

@@ -74,9 +74,9 @@ LPT 的全部能力最终只服务于三个问题：
 
 以下六条是设计目标的支点。改动它们属于设计变更，必须先改文档再改实现：
 
-1. **时间按学习会话统计**。会话是唯一真实发生的事实。
+1. **时间按真实发生的行为统计**。学习时间来自学习会话，复习耗时来自复习行为（回忆对比、引导追问），两者独立统计、不合并。
 2. **一次学习会话只属于一个学习任务**。
-3. **三类时间规则**：番茄钟长度（单个学习段落的上限）、遗忘判定阈值（判断用户是否忘记暂停或结束）、不计入总时长的最小值。
+3. **三类时间规则**：番茄钟长度（单个学习段落的上限）、遗忘判定阈值（判断用户是否忘记暂停或结束）、不计入总时长的最小值。这三条只用于学习会话；复习耗时的挂机截断窗口不属于它们。
 4. **学习报告是会话产出的真实记录**，形态为会话摘要、预期达成判断、按归属分组的碎片与自由总结。碎片是原料，报告是收敛，报告不做美化；旁支碎片留在本次报告中单独呈现，不参与正文推演。
 5. **复习是偶遇加主动提取**，不是清单、不是打卡、不是必须完成的任务。
 6. **AI 只增强不依赖**。报告聚合、导图生成、回忆对比都必须有内置规则可独立完成。
@@ -85,10 +85,10 @@ LPT 的全部能力最终只服务于三个问题：
 
 系统正在形成两条互不干扰的轴：
 
-- **时间轴**：按学习会话统计投入。回答"我花了多少时间、效率如何"。
+- **时间轴**：按真实发生的行为统计投入——学习会话贡献学习时间，复习行为贡献复习耗时。回答“我花了多少时间、复习投入了多少”。
 - **内容轴**：按内容归属聚合知识。回答"这块知识属于哪里、我掌握到什么程度"。
 
-两条轴的分工是：**时间按会话，内容按归属**。这解释了一个看起来矛盾的现象——一次会话产生的知识碎片不一定属于这次会话的学习任务（旁支碎片仍在该报告中单独呈现），而一份学习报告一定属于这次会话。细节见 [内容归属](../concepts/knowledge-ownership.md)。
+两条轴的分工是：**时间按行为，内容按归属**。这解释了一个看起来矛盾的现象——一次会话产生的知识碎片不一定属于这次会话的学习任务（旁支碎片仍在该报告中单独呈现），而一份学习报告一定属于这次会话。细节见 [内容归属](../concepts/knowledge-ownership.md)。
 
 ## 七、判断改动是否触及设计目标