lpt-docs/docs/concepts/time-and-efficiency.md

时间与效率

定义

系统用三个时间概念描述一次学习会话：

• 实际使用时间：会话从开始到结束的总体时间。
• 有效学习时间：会话中真正处于学习状态的时间，即扣除暂停时间后的投入。
• 有效时间比：有效学习时间占实际使用时间的比例，用于观察学习是否被频繁中断。

复习行为另用「复习耗时」计量，它与上述学习时间独立统计，见下文。

设计意图

时间数据帮助用户建立对学习投入的感知，而不是用来评判用户。用户看到一次学习真正投入了多久，可以更合理地估计完成一个任务需要多长时间。

设计思路

• 暂停是一个显式动作：暂停之前的时间都属于有效学习时间。
• 番茄钟等时间刻度只是辅助参考，不是强制约束。
• 系统记录数据，不把“效率低”当成错误，而是让用户看到实际情况。

复习耗时

复习耗时是一次复习行为的耗时。它与学习时间分属两条轴，不合并、不换算、不互相比较。

• 覆盖范围：回忆对比与引导追问。滚动浏览内容不计时。
• 计时边界：从行为开始到结束；超过 5 分钟没有任何交互，则把耗时截断到上一次交互时间。复习没有“暂停”动作，这条截断规则用来替代暂停。
• 不叫“有效复习时间”，也不套用 10 分钟最小阈值：复习行为天然是分钟级，套用会话口径会把几乎所有复习耗时清零。
• 用途：在复习总览中按任务与学习时长并列展示，回答“我在这块内容上复习了多少”。不设目标、不做提醒、不参与“该复习什么”的排序。

相关概念

• 学习会话：学习时间数据记录在会话上。
• 复习行为：回忆对比与引导追问，复习耗时的来源。
• 复习总览：按任务并列展示学习时长与复习耗时。
• 学习任务：任务层面的累计学习时间来自多次会话，累计复习耗时来自多次复习行为。