docs: 补充标签字典、标签导图与错误记录概念

This commit is contained in:
cat-shark
2026-10-10 14:21:00 +08:00
parent 2be6f5024c
commit 5d784b2193
9 changed files with 110 additions and 17 deletions
+4 -2
View File
@@ -9,9 +9,11 @@
| 学习预期 | 开始学习前对本次学习目标的描述 | [学习预期](learning-expectation.md) |
| 学习录音 | 学习会话期间对设备全部播放声音的连续采集,只采系统输出 | [学习录音](study-recording.md) |
| 知识碎片 | 学习中随手记录的不完整内容,也称“学习报告残片” | [知识碎片](knowledge-fragment.md) |
| 错误记录 | 对一次用错/做错的记录,含错做法与正确做法,可关联概念 | [错误记录](error-record.md) |
| 内容归属 | 一条知识碎片在知识结构上属于哪个学习任务 | [内容归属](knowledge-ownership.md) |
| 记录上下文 | 碎片产生于哪次学习会话或复习行为,不可变且不可为空 | [内容归属](knowledge-ownership.md) |
| 标记 | 附加在对象上的轻量元信息(来源、标签等),统一存放 | [标记](marker.md) |
| 标签字典 | 尚未挂在任何对象上的候选标签;改名与删除只影响候选 | [标记](marker.md) |
| 待归类 | 尚未确定内容归属的碎片状态 | [内容归属](knowledge-ownership.md) |
| 学习报告 | 一次学习结束后汇总出的结构化学习结果 | [学习报告](learning-report.md) |
| 有效学习时间 | 学习会话中未暂停的实际投入时间 | [时间与效率](time-and-efficiency.md) |
@@ -19,8 +21,8 @@
| 任务优先级 | 由多个维度综合计算出的学习任务排序依据 | [任务优先级](priority.md) |
| 应用场景 | 学到的知识可以被使用到什么地方 | [应用场景](application-scenario.md) |
| 复习总览 | 按任务汇总可复习内容、掌握度与最近复习时间的入口 | [复习总览](review-overview.md) |
| 复习 Feed | 滚动展示知识碎片的记忆触发物,只显示摘要 | [复习 Feed](review-feed.md) |
| 标准思维导图 | 每个学习任务对应的知识结构基准 | [标准思维导图](standard-mind-map.md) |
| 复习 Feed | 滚动展示知识碎片的记忆触发物,只显示摘要;打标签与反馈在详情页 | [复习 Feed](review-feed.md) |
| 标准思维导图 | 一个知识结构范围的基准,范围可以是学习任务或标签集合 | [标准思维导图](standard-mind-map.md) |
| 回忆对比 | 用户凭记忆重建知识结构并与标准导图比较 | [回忆对比](recall-review.md) |
| 回忆记录 | 一次回忆对比的存档,含起点、三类节点与覆盖率 | [回忆对比](recall-review.md) |
| 覆盖率 | 本次对比命中节点占参与对比节点的比例 | [回忆对比](recall-review.md) |
+55
View File
@@ -0,0 +1,55 @@
# 错误记录
> 状态:设计已定,实现未开始。本文只记录概念与设计取向,未定项集中在「待定」。
## 定义
错误记录是对「一次用错 / 做错」的记录,回答的是「我在哪里用了错误的做法、正确做法是什么」。它与知识碎片互补:碎片记录刚学到的东西,错误记录记录应用时暴露的缺口。
一条错误记录至少包含:
- **题目或场景**:当时在做的一道题、一个操作或一个实际情境。
- **当时的错误做法**:用户当时的判断或做法。
- **正确的做法或正确答案**:事后确认的正确内容。
- **关联的概念或导图节点**(可选):这条错误落到哪个知识点上。
- **标签**(可选):复用[标记](marker.md)的自由标签。
## 设计意图
学习时间主要花在「识别概念」与「实际应用」上,而使用过程中产生的错误几乎全部发生在做题场景,不在学习页面。这类信息是查缺补漏最直接的线索:
- 它天然带有「我错了」的定位,比碎片更接近问题本身。
- 它发生在应用场景里,能反向说明概念理解在哪一步断了。
- 关联到概念或导图节点后,可以形成「概念 → 它的高频误区」的回看路径。
因此录入必须能脱离学习页面:从题目直接记录,不要求先回到学习任务或学习会话。
## 与现有概念的关系
- **知识碎片**:并列关系,不是同一实体的变体。碎片不要求「对错」,错误记录的核心恰是错与对的对照;把错误塞进碎片需要额外的类型字段与语义分支,会把残片体系拖向通用笔记。
- **标准思维导图**:错误记录可以挂到导图节点或概念上,从而按概念聚合回看。
- **标记**:错误记录可以使用自由标签,标签语义与碎片上的标签一致。
- **复习**:错误记录**不进**复习 Feed 的随机排序。它需要的是集中回看,而不是偶遇式接触。
- **内容归属**:与碎片的归属关系尚未确定,见「待定」。
## 复习方式
错误记录走**单独的回看列表**,可按概念或标签聚合。理由是错误需要密集、可检索地回看,与 Feed「无压力偶遇」的立场相反;把错误混进 Feed 会同时破坏两种节奏。
## AI 的边界
一期不做 AI。二期可选「把同一概念下的错误归并成高频误区」,且**必须由用户手动触发**:错误记录的产生不附带 AI 调用,避免录入成本被计费与等待抬高。具体提示词与归并口径在实现该阶段前另定。
## 待定
- 错误记录与[内容归属](knowledge-ownership.md)的关系:是像碎片一样拥有独立归属,还是只挂在概念 / 导图节点上。
- 回看列表与[复习总览](review-overview.md)的入口关系:独立页面,还是总览内的一块。
- 删除口径:软删除?关联的导图节点被删除后,错误记录如何保留。
- 错误记录是否参与学习报告与导出。
## 相关概念
- 知识碎片:并列的记录形态,记录「学到什么」。
- 标准思维导图:错误记录可挂在它的节点与概念上。
- 标记:错误记录使用自由标签。
- 复习总览与复习 Feed:错误记录只在单独的回看列表里出现。
+11 -1
View File
@@ -29,6 +29,15 @@
- **标签**(用户标签):用户自由建立的分类,多个、可为空、可变,只影响检索。
- **来源标记**:例如「来自学习引导」。系统标记,由系统在产出时写入,用户不可编辑。
- **自动任务名标签**:碎片获得内容归属时,由系统按所属任务自动写入一条用户标签,名字取任务当时的名字。它是用户标签而非系统标记:用户可以改名或删除;任务之后改名也不会回溯改写历史碎片上的标签。
## 标签字典
用户可以在打标签之前先把标签建出来,这些尚未挂在任何对象上的标签存放在统一的标签字典里。字典只是候选项的来源:
- 打标签时输入即过滤字典(含自动任务名标签),也可以直接输入一个新名字。
- 字典的改名与删除只影响候选,不影响任何对象上已经打好的标记。
- 名字按去空格、大小写不敏感的口径去重,展示时保留用户输入的原样。
## 相关概念
@@ -43,4 +52,5 @@
2. **两类标记彻底分开**:系统标记的名字与值来自固定词表,由系统写入,用户只能查看;用户标签的名字由用户自由输入,可增删改。同一个对象上两类可以共存、互不覆盖。
3. **系统标记成对、标签只有名**:系统标记表达的是「名 = 值」(来源 = 学习引导),用户标签的一个词本身就是全部信息,不再附值。
4. **检索只做单一标记筛选**:点一个标记即筛选出带它的对象。不做多标记组合、不做跨对象统一搜索页——标签的唯一作用就是检索,检索入口是它存在的理由,但组合检索目前没有真实使用场景。
5. **标记对用户全部可见,用户标签可改名、可删除**。改名是安全的:标记不参与聚合口径,批量改名不会像改内容归属那样污染统计与检索口径。不做「废弃」这一状态——保留历史标记的收益很小,而它会给检索与展示增加判断分支。
5. **标签字典独立于标记存放**。标记描述的是「某个对象上有一个标记」,缺了对象就不再是标记;字典是候选项,与标记是两份数据,因此不为「空标签」在标记表里造没有对象的行。
6. **标记对用户全部可见,用户标签可改名、可删除**。改名是安全的:标记不参与聚合口径,批量改名不会像改内容归属那样污染统计与检索口径。不做「废弃」这一状态——保留历史标记的收益很小,而它会给检索与展示增加判断分支。
+3 -2
View File
@@ -2,7 +2,7 @@
## 定义
回忆对比是用户凭记忆重建某个学习任务的知识结构,并把它与标准思维导图进行比较的过程。
回忆对比是用户凭记忆重建一个知识结构范围,并把它与对应的标准思维导图进行比较的过程。范围可以是一个学习任务(任务导图),也可以是一个标签集合(标签导图)。
对比结果把节点分为:
@@ -21,6 +21,7 @@
每一次回忆对比都会留下一条回忆记录,包含:
- 发生时间。
- 复习对象:这次对比的是任务导图还是标签导图,以及对应的任务或标签集合。
- 复习起点(或整棵树)。
- 命中、遗漏、额外的节点集合。
- 覆盖率。
@@ -56,7 +57,7 @@
## 相关概念
- 标准思维导图:对比的基准。
- 标准思维导图:对比的基准,任务导图与标签导图各自对应一种复习范围。
- 复习起点:用户可以选择从某个节点开始,只复习该子树。
- 知识碎片与学习报告:遗漏项可追溯回原文。
- 复习总览:消费覆盖率形成的任务级掌握度。
+9 -6
View File
@@ -21,18 +21,21 @@ Feed 的条目单位是知识碎片。学习报告不以条目形式出现在 Fe
- 复习总览:任务级入口,与 Feed 的条目级展示互补。
- 回忆卡片:点击 Feed 内容后,先让用户尝试回忆再展开原文。
- 回忆对比:Feed 是进入深度复习的入口之一。
- 学习引导:Feed 卡片是它的入口之一。
- 学习引导:详情页是它的入口之一。
- 标记(标签):标签是任务之外的另一个聚合维度,打标签动作在详情页完成。
- 复习排序:合并“多久没接触”与任务掌握度两个信号,只影响出现概率。
## 卡片上的动作
Feed 的每张卡片提供三类动作:
Feed 只做展示、导航与归类,不在卡片上做其他写操作:
- **展开查看**:本身是一次复习行为,会刷新“最近接触时间”,不产生额外数据。
- **进入回忆对比**:从当前内容出发做任务级的主动回忆。
- **反馈**:标记「已掌握」或「稍后再看」,用于调整出现概率。
- **进入详情**:点击内容进入详情页;打标签、反馈、学习引导都在详情页内完成。
- **待归类就地归类**:尚未确定内容归属的碎片,在卡片上直接选任务完成归类。
反馈刻意做得轻:不显示状态徽标、不统计总数、不形成待复习列表。一旦把这些结果展示成状态或数字,复习就会从“偶遇式接触”滑回“必须处理的清单”。
Feed 是“看到内容”的地方,详情页是“处理内容”的地方。把打标签、反馈与学习引导从滚动列表里移出,是为了让滚动保持低阻力:滚动时不该被迫做整理,也不该误触改变数据。归类是例外:它只是一次选择,而且复习是归类成本最低的时机。
反馈仍然刻意做得轻:不显示状态徽标、不统计总数、不形成待复习列表。一旦把这些结果展示成状态或数字,复习就会从“偶遇式接触”滑回“必须处理的清单”。
## 设计思路
@@ -40,4 +43,4 @@ Feed 的每张卡片提供三类动作:
Feed 只给摘要,全文在详情里按需展开:滚动场景下全文既拖慢浏览,也让用户跳过“先尝试回忆”这一步。
Feed 同时是归类成本最低的位置:看到一条内容时顺手确认它属于哪个任务,不需要额外的整理流程。归类动作与复习动作放在一起的原因见[模块边界](../design/module-boundaries.md)。
Feed 同时是归类成本最低的位置:看到一条内容时顺手确认它属于哪个任务,不需要额外的整理流程。归类动作与复习动作放在一起的原因见[模块边界](../design/module-boundaries.md)。打标签、反馈与学习引导不进 Feed 卡片,它们需要先展开内容、看到完整上下文再决定,放回详情页之后滚动列表也不再承担整理职责。
+1
View File
@@ -25,6 +25,7 @@
- 学习任务:总览的行单位。
- 内容归属:决定内容进入哪个任务,也决定待归类内容是否出现在这里。
- 标记(标签):任务之外的另一个聚合维度,按标签复习走标签导图,与总览的任务级入口并存。
- 标准思维导图:从任务进入深度复习的对象。
- 回忆记录与覆盖率:掌握度的来源。
- 复习耗时:与学习时长并列的投入口径。
+13 -1
View File
@@ -17,7 +17,8 @@
- 学习报告与知识碎片:导图的生成素材。
- 内容归属:决定哪些碎片进入本导图;素材按归属取材,而不是按产生于哪个学习会话。
- 应用场景:作为独立分支进入导图。
- 回忆对比:标准导图是用户回忆结果的对照基准。
- 回忆对比:标准导图是用户回忆结果的对照基准,任务导图与标签导图都可以作为对照对象。
- 标记(标签):标签导图的取材范围。
- 节点溯源:导图节点可以关联回原始报告、碎片或应用场景。
- 学习引导:从导图节点发起,产出的碎片按归属进入本导图。
@@ -32,6 +33,17 @@
重新生成导图时不覆盖用户的手工编辑,而是把新内容合并进来。
## 导图的范围
导图按取材范围分两种:
- **任务导图**:以学习任务为范围,取材于内容归属为该任务的碎片、报告与应用场景。
- **标签导图**:以一个标签集合为范围,取材于带这些标签的内容。多个标签时由用户选择取并集(带任一标签)或交集(同时带全部标签)。
两种范围并存,互不替代:任务导图回答「这个任务学到了什么结构」,标签导图回答「这个概念在不同任务里呈现出什么结构」。范围用规范化的标签集合表达,集合相同即同一张导图。
标签导图的重算与任务导图遵循同一口径:素材变化只把导图标记为待更新,重建由用户手动触发。
## 设计思路
标准导图应同时适合人工编辑和机器处理。它既可以用缩进大纲的形式让用户直接修改,也可以用树结构参与算法比较。
+5 -2
View File
@@ -23,14 +23,17 @@
- 按任务汇总复习状态(复习总览)。
- 滚动展示知识碎片(复习 Feed)。
- 维护标准思维导图。
- 提供回忆对比、回忆记录和遗漏项回溯。
- 维护标准思维导图,包括任务导图与按标签聚合的标签导图。
- 提供回忆对比、回忆记录和遗漏项回溯,复习对象可以是任务或标签集合。
- 提供学习引导(开放式问题与概念边界纠正)。
- 维护标记与标签字典(提前建标签、改名、删除、按标签检索)。
- 记录复习耗时(回忆对比与学习引导)。
- 承接内容归属的调整动作与待归类内容的处理入口。
复习模块不要求用户逐条整理学习材料,材料是自动整理和对照分析的数据来源。复习按内容归属聚合,而不是按内容产生于哪次会话:这是归类动作与复习动作放在一起的原因。复习不做调度:不生成到期清单,只影响内容的出现概率。
复习内部分两处:**展示层**是首页的复习 Feed(落地页上的滚动条),只展示内容与导航,外加一次性完成的归类;**操作层**是残片详情页,打标签、反馈与学习引导都在这里。拦断写操作是为了让滚动保持低阻力,不把“看到”变成“必须处理”。
## 应用场景
应用场景属于学习任务,而不是复习模块。它表示任务完成后用户希望具备的应用能力,参与标准导图生成,为复习提供现实语境。
+9 -3
View File
@@ -33,6 +33,7 @@
| 学习报告 | 一次会话的完整结果,从任务记录进入回顾 |
| 标准思维导图 | 深度复习的对照基准与结构来源 |
| 应用场景 | 复习的现实语境,参与导图 |
| 标记(标签) | 复习的另一个聚合维度:标签导图按标签集合取材,跨任务聚合同一概念的碎片 |
| 回忆记录 | 复习产生的历史,用于展示掌握变化与计算任务掌握度 |
学习时间与复习耗时都不进入复习内容:它们回答的是投入了多少,而不是记得怎么样。复习耗时只在复习总览里与学习时长并列呈现。
@@ -40,6 +41,7 @@
## 复习的两个层级
- **任务级**:复习总览回答“从哪个任务开始复习”,见 [复习总览](../concepts/review-overview.md)。
- **标签级**:按标签复习回答“这个概念在哪些任务里出现过”,取材与导图口径见 [标准思维导图](../concepts/standard-mind-map.md)。
- **内容级**:复习 Feed 回答“这次遇到哪条内容”,见 [复习 Feed](../concepts/review-feed.md)。
## 复习耗时
@@ -88,9 +90,10 @@
## 进入回忆对比的入口
回忆对比不应该只有一个入口。系统提供三种入口,它们对应不同的复习心态:
回忆对比不应该只有一个入口。系统提供四种入口,它们对应不同的复习心态:
- 从复习总览进入:用户主动想复习某个学习任务,此时默认面对整棵标准导图,可以选择任意节点作为起点。
- 从按标签复习进入:用户想围绕一个概念复习,系统把带该标签(集合)的碎片聚合成标签导图作为对照基准。
- 从某条知识碎片或学习报告详情进入:用户在看具体内容时想深挖,系统根据这段内容定位到最相关的节点,直接以该节点为复习起点。
- 从首页回忆卡片进入:用户在滚动 Feed 上随手回忆后想继续,同样自动定位到对应节点。
@@ -114,6 +117,7 @@
- 待归类内容在复习总览中可见,在 Feed 中可归类。
- 归类动作就近提供,一次交互完成;AI 只给建议,用户可一键接受或忽略。
- 内容获得归属(产生时即有,或之后归类)时,系统自动补上一条任务名标签,见[标记](../concepts/marker.md)。
- 归属改变后,内容进入新任务的导图取材范围,原任务与新任务的导图都标记为待更新;复习排序权重按任务掌握度自动跟随,不需要单独处理。
## 复习中的反馈动作
@@ -123,7 +127,7 @@
- **无需记录的反馈**:展开查看、进入回忆对比,本身就是复习行为,不产生额外数据。
- **需要记录的反馈**:用户主动标记“已掌握”或“稍后再看”,用于调整出现概率。
反馈动作确定为两个轻量动作:**已掌握**与**稍后再看**。它们只调整内容的出现概率,不产生状态展示、不统计总数、不形成待复习列表;「已掌握」降低出现概率但不归零,随机性仍然保留。此外,展开查看与进入回忆对比会刷新「上次复习时间」,让它成为继时间效应与任务掌握度之后的第三个信号。
反馈动作确定为两个轻量动作:**已掌握**与**稍后再看**。它们只调整内容的出现概率,不产生状态展示、不统计总数、不形成待复习列表;「已掌握」降低出现概率但不归零,随机性仍然保留。此外,展开查看与进入回忆对比会刷新「上次复习时间」,让它成为继时间效应与任务掌握度之后的第三个信号。两个动作在残片详情页提供,Feed 卡片不再放置它们。
## AI 在复习中的边界
@@ -138,6 +142,8 @@
1. **Feed 不含学习报告。** Feed 只出知识碎片;报告以「一次会话的完整结果」的形态从任务记录进入,不与碎片并列成条目,避免同一段内容以两种形态重复出现。
2. **反馈动作取「已掌握 + 稍后再看」两个轻量动作**,并让「上次复习时间」成为第三个权重信号。不统计「已掌握」的总数、不做待复习列表、不把动作结果展示成状态,以此避免演变成清单。
3. **覆盖率取最近一次回忆对比。** 不做最近若干次的加权平均:加权会让变化被平滑、遗忘的征兆出现得更晚,而覆盖率是事实而非成绩,越直接越好。
4. **待归类内容两处都要出现。** 复习总览里独立成一块(回答「还欠多少」),复习 Feed 里与其他内容混排并打标,且归类动作就在卡片上完成,一次交互可结。理由:复习的日常入口常常是 Feed 而不是总览,只放一处会漏。
4. **待归类内容两处都要出现,归类留在 Feed 卡片上。** 复习总览里独立成一块(回答「还欠多少」),复习 Feed 里与其他内容混排并打标,且归类动作就在卡片上完成,一次交互可结。理由:复习的日常入口常常是 Feed 而不是总览,只放一处会漏;归类只是一次选择,留在这里不违背「Feed 不做整理」的口径。
5. **遗漏项是每次对比的快照**,可回看原文,不做跨次累计的待处理集合。跨次累计会把它变成一份待办清单,与复习的立场冲突。
6. **排序信号强度按三档预设对用户开放**:时间为主(默认)/均衡/掌握度为主。不给精确数值:现有排序是两个因子相乘而非加权求和,百分比是假精度,而三个档位已经覆盖真实意图。
7. **详情页是残片的操作落点。** Feed 卡片只保留展开、导航与归类;打标签、反馈、学习引导改在残片详情页完成。Feed 负责「看到内容」,详情页负责「处理内容」,滚动列表不承担整理职责。
8. **标签复习与任务复习并存。** 复习范围既可以是任务,也可以是标签集合;标签导图以规范化标签集合为键,多标签由用户选择并集或交集,素材变化只置待更新、重建由用户手动触发。