docs: 补充报告作为导图参考上下文与标签导图默认入口

This commit is contained in:
cat-shark
2026-10-22 21:55:36 +08:00
parent f6369b3b39
commit cd1c2a444e
3 changed files with 16 additions and 7 deletions
+2 -2
View File
@@ -30,9 +30,9 @@
- 知识碎片:报告的主要来源,按内容归属分组。
- 学习预期:报告中回答“实际学了什么”。
- 内容归属:决定碎片在报告中的分组,也决定它进入哪份标准思维导图。
- 标准思维导图:报告参与导图生成。
- 标准思维导图:报告作为导图生成的参考上下文——只有实质讨论相关碎片同一主题、且领域一致时,其内容才由 AI 提取进导图。
- 复习 Feed:Feed 的条目单位是碎片;报告以会话完整结果的形态从任务记录进入回顾。
## 设计思路
降低报告的仪式感:用户的主要书写单元是知识碎片,报告允许先由系统根据碎片生成结构化草稿(摘要、达成判断、分组建议、总结草稿),再由用户修改确认。AI 不可用时降级为规则拼接:按内容归属分组碎片并生成摘要,自由总结留给用户填写。
降低报告的仪式感:用户的主要书写单元是知识碎片,报告允许先由系统根据碎片生成结构化草稿(摘要、达成判断、分组建议、总结草稿),再由用户修改确认;用户也可以在结束会话总结里点「AI 重新生成」重跑草稿(三段非空时先确认再覆盖)。AI 不可用时降级为规则拼接:按内容归属分组碎片并生成摘要,自由总结留给用户填写。
+13 -4
View File
@@ -2,7 +2,7 @@
## 定义
标准思维导图是每个学习任务对应的知识结构基准,由系统从**归属为该任务**的学习报告、知识碎片和应用场景中提取整理而成。用户可以查看、编辑它,也可以用它作为复习的对照对象。
标准思维导图是每个学习任务对应的知识结构基准,由系统从**归属为该任务**的知识碎片和应用场景中提取整理而成;与碎片同源会话的**学习报告**作为参考上下文参与生成(见「导图的范围」)。用户可以查看、编辑它,也可以用它作为复习的对照对象。
## 设计意图
@@ -14,7 +14,8 @@
## 相关概念
- 学习报告与知识碎片:导图的生成素材。
- 知识碎片:导图的取材单位,按内容归属或标签集合取。
- 学习报告:与碎片同源(同一学习会话)时作为参考上下文,由 AI 判断相关性后提取。
- 内容归属:决定哪些碎片进入本导图;素材按归属取材,而不是按产生于哪个学习会话。
- 应用场景:作为独立分支进入导图。
- 回忆对比:标准导图是用户回忆结果的对照基准,任务导图与标签导图都可以作为对照对象。
@@ -26,7 +27,7 @@
标准导图区分四种来源,用于说明当前这份导图是怎么来的:
- 内置规则:不依赖 AI,按学习会话分组,对报告、碎片和应用场景做去重与合并。
- 内置规则:不依赖 AI,按学习会话分组,对碎片和应用场景做去重与合并(报告只作 AI 路径的参考,内置规则不使用)。
- AI 生成:由 AI 从学习材料中提取缩进大纲后解析成树。
- 用户编辑:用户直接修改导图内容。
- 用户合并:增量生成时保留用户已编辑的内容,再追加新产生的学习内容。
@@ -37,13 +38,21 @@
导图按取材范围分两种:
- **任务导图**:以学习任务为范围,取材于内容归属为该任务的碎片、报告与应用场景。
- **任务导图**:以学习任务为范围,取材于内容归属为该任务的碎片与应用场景。
- **标签导图**:以一个标签集合为范围,取材于带这些标签的内容。多个标签时由用户选择取并集(带任一标签)或交集(同时带全部标签)。
两种范围并存,互不替代:任务导图回答「这个任务学到了什么结构」,标签导图回答「这个概念在不同任务里呈现出什么结构」。范围用规范化的标签集合表达,集合相同即同一张导图。
标签导图的重算与任务导图遵循同一口径:素材变化只把导图标记为待更新,重建由用户手动触发。
## 报告作为参考上下文
一次总结往往会把若干碎片拼接出新的定义与观点,这些内容只存在于报告里、不在碎片里。因此导图取材时,把碎片**同源会话**(报告与碎片按会话隐式绑定:碎片记录上下文为 SESSION 时,其 contextNum 即报告的 sessionNum)的报告一并带上作为参考。
报告只是参考而不是素材:是否采用由 AI 按相关性判断——只有当报告**实质讨论**了相关碎片的同一主题、且与本批碎片领域一致时,才可提取其中的新定义/观点进入导图;报告只是顺带提及或根本没有提到该主题时,完全不用;报告与主干强相关时可以参考其组织结构。内置规则降级路径不做语义判断,因此不携带报告。
报告的新增、编辑、删除与碎片、标签的变化同口径:只把相关导图置为待更新,重建仍由用户手动触发。
## 设计思路
标准导图应同时适合人工编辑和机器处理。它既可以用缩进大纲的形式让用户直接修改,也可以用树结构参与算法比较。
+1 -1
View File
@@ -93,7 +93,7 @@
回忆对比不应该只有一个入口。系统提供四种入口,它们对应不同的复习心态:
- 从复习总览进入:用户主动想复习某个学习任务,此时默认面对整棵标准导图,可以选择任意节点作为起点。
- 从按标签复习进入:用户想围绕一个概念复习,系统把带该标签(集合)的碎片聚合成标签导图作为对照基准。
- 从按标签复习进入:用户想围绕一个概念复习,系统把带该标签(集合)的碎片聚合成标签导图作为对照基准。这一页以**已生成过导图的标签集合**为默认入口——导图生成后标签集合一般不再变化,用户通常直接从已有导图进入,或把新碎片补充进现有结构;手动选标签新建范围是次要入口。
- 从某条知识碎片或学习报告详情进入:用户在看具体内容时想深挖,系统根据这段内容定位到最相关的节点,直接以该节点为复习起点。
- 从首页回忆卡片进入:用户在滚动 Feed 上随手回忆后想继续,同样自动定位到对应节点。