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 @@
重新生成导图时不覆盖用户的手工编辑,而是把新内容合并进来。
## 导图的范围
导图按取材范围分两种:
- **任务导图**:以学习任务为范围,取材于内容归属为该任务的碎片、报告与应用场景。
- **标签导图**:以一个标签集合为范围,取材于带这些标签的内容。多个标签时由用户选择取并集(带任一标签)或交集(同时带全部标签)。
两种范围并存,互不替代:任务导图回答「这个任务学到了什么结构」,标签导图回答「这个概念在不同任务里呈现出什么结构」。范围用规范化的标签集合表达,集合相同即同一张导图。
标签导图的重算与任务导图遵循同一口径:素材变化只把导图标记为待更新,重建由用户手动触发。
## 设计思路
标准导图应同时适合人工编辑和机器处理。它既可以用缩进大纲的形式让用户直接修改,也可以用树结构参与算法比较。