docs: 确认内容归属与结构化报告方案

README.md

@@ -1,6 +1,6 @@
 # LPT 概念与设计文档
 
-> 更新日期：2026-08-05
+> 更新日期：2026-09-19
 
 本项目只维护 LPT（Learning Progress Tracker）的系统概念与设计思路，不保存开发记录、系统中间态或开发过程中的中间产物。
 

docs/concepts/README.md

@@ -9,8 +9,9 @@
 | 学习预期 | 开始学习前对本次学习目标的描述 | [学习预期](learning-expectation.md) |
 | 知识碎片 | 学习中随手记录的不完整内容，也称“学习报告残片” | [知识碎片](knowledge-fragment.md) |
 | 内容归属 | 一条知识碎片在知识结构上属于哪个学习任务 | [内容归属](knowledge-ownership.md) |
+| 记录上下文 | 碎片产生于哪次学习会话与任务，不可变且不可为空 | [内容归属](knowledge-ownership.md) |
 | 待归类 | 尚未确定内容归属的碎片状态 | [内容归属](knowledge-ownership.md) |
-| 学习报告 | 一次学习结束后汇总出的完整学习结果 | [学习报告](learning-report.md) |
+| 学习报告 | 一次学习结束后汇总出的结构化学习结果 | [学习报告](learning-report.md) |
 | 有效学习时间 | 学习会话中未暂停的实际投入时间 | [时间与效率](time-and-efficiency.md) |
 | 任务优先级 | 由多个维度综合计算出的学习任务排序依据 | [任务优先级](priority.md) |
 | 应用场景 | 学到的知识可以被使用到什么地方 | [应用场景](application-scenario.md) |

docs/concepts/ai-task.md

@@ -4,7 +4,7 @@
 
 AI 任务是系统使用 AI 完成的三类学习处理能力：
 
-- 聚合报告：把知识碎片整理成学习报告草稿。
+- 聚合报告：把知识碎片整理成结构化学习报告草稿——会话摘要、预期达成判断、按归属分组的碎片，以及自由总结草稿。
 - 生成导图：从报告、碎片和应用场景中提取标准思维导图。
 - 回忆对比：对用户回忆与标准导图进行语义层面的比较。
 
@@ -12,13 +12,13 @@ AI 任务是系统使用 AI 完成的三类学习处理能力：
 
 AI 用于降低用户的书写和整理负担：
 
-- 报告不必从零开始写，AI 先给草稿，用户再修改。
+- 报告不必从零开始写，AI 先给结构化草稿（含碎片分组建议），用户再修改。
 - 导图不必用户手工搭建，AI 可以先提取结构。
 - 回忆对比可以容忍同义表达，而不只是机械文字匹配。
 
 ## 设计思路
 
-AI 是增强能力，而不是单点依赖。AI 不可用时，系统应能用内置规则继续完成报告拼接、导图生成和字符串匹配，保证核心学习流程不中断。
+AI 是增强能力，而不是单点依赖。AI 不可用时，系统应能用内置规则继续完成报告拼接、导图生成和字符串匹配，保证核心学习流程不中断：报告降级为按内容归属分组碎片并生成摘要，自由总结留空由用户填写。
 
 ## 相关概念
 

docs/concepts/knowledge-fragment.md

@@ -21,9 +21,12 @@
 - 复习 Feed：碎片是滚动展示的核心内容。
 - 标准思维导图：碎片参与导图生成，并可追溯到原文。
 - 内容归属：碎片产生于某个会话，但它可以归属到另一个学习任务。
+- 记录上下文：碎片产生于哪次学习会话与任务，不可变且不可为空。
 
 ## 设计思路
 
 碎片不应被要求“整理得非常完美”。它是学习过程的原料，后续由用户或 AI 汇总成更结构化的内容。
 
 碎片“产生于某个任务”只说明它出现在哪里，不代表它只能属于那里：记录上下文不可变，内容归属可以调整，尚未确定的内容进入待归类状态。区分两者后，旁支知识不会污染原任务的知识结构。
+
+碎片一定产生于某次学习会话，不存在脱离会话的碎片：待归类只表示内容归属尚未确定，记录上下文始终存在。

docs/concepts/knowledge-ownership.md

@@ -1,6 +1,6 @@
 # 内容归属
 
-> 状态：**草案，待维护者确认后实施**。文末列出三个待决问题，确认前不要按本文档改动实现。
+> 状态：**设计已确认，实现待安排**。三个待决问题已于 2026-09-19 由维护者确认，结论见文末。
 
 ## 定义
 
@@ -15,6 +15,8 @@
 
 **待归类**是没有确定归属的状态。处于待归类的内容不会消失，也不阻塞任何流程，只是暂时不进入任何任务的知识结构。
 
+碎片一定产生于某次学习会话，不存在脱离会话的碎片：待归类只表示内容归属尚未确定，记录上下文始终存在。
+
 ## 要解决的问题
 
 在只有记录上下文的情况下，系统会强制把"记录地点"当成"内容归属"，由此产生三个后果：
@@ -66,7 +68,7 @@
 
 ### 报告保持真实，旁支内容单独呈现
 
-一次会话产生的碎片可能归属不同任务。学习报告只收敛归属当前任务的碎片；旁支碎片在报告中单独呈现并标注其归属，不参与本次报告的正文推演。这样既保住报告的真实性，也避免报告与导图被无关内容带偏。
+一次会话产生的碎片可能归属不同任务。学习报告的摘要、预期达成判断与正文推演只使用归属当前任务的碎片；旁支碎片仍留在本次报告中，单独分组呈现并标注其归属，不参与正文推演。这样既保住报告的真实性，也避免报告与导图被无关内容带偏。
 
 ## 修改归属的后果
 
@@ -84,10 +86,10 @@
 - 复习 Feed：归类动作的最低成本落点，也是旁支内容的复习入口。
 - AI 任务：只提供归属建议，不作为判定依据。
 
-## 待决问题
+## 已确认的结论
 
-以下三点需要维护者确认后再进入实现：
+以下三点于 2026-09-19 由维护者确认：
 
-1. **是否允许碎片脱离学习会话存在？** 允许后可以在任何场景随手记一条内容，代价是系统有向通用笔记工具漂移的倾向。若允许，这类碎片不参与时间统计、不产生学习报告。
+1. **碎片不可脱离学习会话。** 不存在没有记录上下文的内容：任何碎片都产生于某次会话，因此必然参与时间统计，也不存在“无处挂载的碎片”。代价是系统不向可以随手记录的通用笔记工具演进，这是有意的边界。
-2. **学习报告是否改为结构化呈现？** 即报告由"会话产出摘要 + 按归属分组的碎片"组成，而不是一段自由文本。结构化后旁支内容天然分离，但会改变报告的形态。
+2. **学习报告改为结构化呈现。** 报告由会话摘要、预期达成判断、按归属分组的碎片和自由总结组成；旁支碎片仍留在本次报告中，只单独标注归属、不参与正文推演。自由总结必须保留，否则卡点与下一步无处表达。
-3. **归属是否保持单一、由标签承担跨领域关联？** 本文档的建议是保持单一。
+3. **内容归属保持单一，跨领域关联由标签承担。** 学习内容很少只属于一个领域：一份侧重 A 领域的材料仍会带来 B 领域的碎片，但它仍归属 A，与 B 的关联用标签表达。如果用户持续在同一领域积累旁支碎片，说明该领域已值得作为独立学习任务，此时走“待归类内容升格为学习任务”的路径，而不是给它第二个归属。

docs/concepts/learning-report.md

@@ -4,6 +4,15 @@
 
 学习报告是一次学习会话结束后的完整学习结果汇总。它由本次会话产生的知识碎片综合而来，而不是要求用户从零开始写一篇长文。
 
+报告由四部分组成：
+
+- **会话摘要**：这次实际学了什么。
+- **预期达成判断**：对照学习预期，判断目标是否达成。
+- **按归属分组的碎片**：碎片按内容归属分组呈现；旁支碎片单独列出并标注其归属。
+- **自由总结**：用户对本次学习的叙述，包括卡点、疑问和下一步打算。
+
+报告一定属于产生它的那次会话。会话中产生的碎片无论最终归属哪个任务，都会出现在本次报告中，只是分组不同。
+
 ## 设计意图
 
 学习报告的价值在于：
@@ -12,13 +21,18 @@
 2. 与学习预期对照，判断学习目标是否达成。
 3. 作为复习材料和标准思维导图的输入。
 
+结构化不是为了形式整齐，而是让前两项可以直接被读取：预期与达成判断本来就是一组对照，不必藏在正文里做隐含比较；按归属分组则让报告与标准导图的取材口径一致。
+
+自由总结必须保留：报告同时承担叙述职责，卡点、疑问和下一步打算没有字段可以承载，取消它就失去了复盘的表达位。
+
 ## 相关概念
 
-- 知识碎片：报告的主要来源。
+- 知识碎片：报告的主要来源，按内容归属分组。
 - 学习预期：报告中回答“实际学了什么”。
+- 内容归属：决定碎片在报告中的分组，也决定它进入哪份标准思维导图。
 - 标准思维导图：报告参与导图生成。
 - 复习 Feed：报告也参与碎片化展示。
 
 ## 设计思路
 
-降低报告的仪式感：用户的主要书写单元是知识碎片，报告允许先由系统根据碎片生成草稿，再由用户修改确认。
+降低报告的仪式感：用户的主要书写单元是知识碎片，报告允许先由系统根据碎片生成结构化草稿（摘要、达成判断、分组建议、总结草稿），再由用户修改确认。AI 不可用时降级为规则拼接：按内容归属分组碎片并生成摘要，自由总结留给用户填写。

docs/concepts/learning-task.md

@@ -20,7 +20,7 @@
 ## 相关概念
 
 - 学习会话：属于某个学习任务。
-- 知识碎片与学习报告：在一次会话中产生，最终属于该任务。
+- 知识碎片与学习报告：都在某次学习会话中产生；碎片按内容归属、报告按会话所属指向该任务。
 - 标准思维导图：每个学习任务对应一份知识结构基准。
 - 应用场景：挂在学习任务下，表示该任务最终能用来做什么。
 - 任务优先级：决定多个学习任务之间的先后顺序。

docs/design/learning-loop.md

@@ -36,7 +36,7 @@
 
 ### 学习报告
 
-报告把碎片收敛成一次学习的完整结果。它可以由系统先聚合，再由用户修正，避免把完整报告变成书写压力。
+报告把碎片收敛成一次学习的完整结果：会话摘要、预期达成判断、按归属分组的碎片与自由总结。它可以由系统先生成结构化草稿，再由用户修正，避免把完整报告变成书写压力；旁支碎片留在本次报告中单独呈现，不参与正文推演。
 
 ### 复习与应用
 

docs/design/system-structure.md

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