diff --git a/docs/concepts/README.md b/docs/concepts/README.md index 58fe82e..134030c 100644 --- a/docs/concepts/README.md +++ b/docs/concepts/README.md @@ -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) | diff --git a/docs/concepts/error-record.md b/docs/concepts/error-record.md new file mode 100644 index 0000000..c80b3b6 --- /dev/null +++ b/docs/concepts/error-record.md @@ -0,0 +1,55 @@ +# 错误记录 + +> 状态:设计已定,实现未开始。本文只记录概念与设计取向,未定项集中在「待定」。 + +## 定义 + +错误记录是对「一次用错 / 做错」的记录,回答的是「我在哪里用了错误的做法、正确做法是什么」。它与知识碎片互补:碎片记录刚学到的东西,错误记录记录应用时暴露的缺口。 + +一条错误记录至少包含: + +- **题目或场景**:当时在做的一道题、一个操作或一个实际情境。 +- **当时的错误做法**:用户当时的判断或做法。 +- **正确的做法或正确答案**:事后确认的正确内容。 +- **关联的概念或导图节点**(可选):这条错误落到哪个知识点上。 +- **标签**(可选):复用[标记](marker.md)的自由标签。 + +## 设计意图 + +学习时间主要花在「识别概念」与「实际应用」上,而使用过程中产生的错误几乎全部发生在做题场景,不在学习页面。这类信息是查缺补漏最直接的线索: + +- 它天然带有「我错了」的定位,比碎片更接近问题本身。 +- 它发生在应用场景里,能反向说明概念理解在哪一步断了。 +- 关联到概念或导图节点后,可以形成「概念 → 它的高频误区」的回看路径。 + +因此录入必须能脱离学习页面:从题目直接记录,不要求先回到学习任务或学习会话。 + +## 与现有概念的关系 + +- **知识碎片**:并列关系,不是同一实体的变体。碎片不要求「对错」,错误记录的核心恰是错与对的对照;把错误塞进碎片需要额外的类型字段与语义分支,会把残片体系拖向通用笔记。 +- **标准思维导图**:错误记录可以挂到导图节点或概念上,从而按概念聚合回看。 +- **标记**:错误记录可以使用自由标签,标签语义与碎片上的标签一致。 +- **复习**:错误记录**不进**复习 Feed 的随机排序。它需要的是集中回看,而不是偶遇式接触。 +- **内容归属**:与碎片的归属关系尚未确定,见「待定」。 + +## 复习方式 + +错误记录走**单独的回看列表**,可按概念或标签聚合。理由是错误需要密集、可检索地回看,与 Feed「无压力偶遇」的立场相反;把错误混进 Feed 会同时破坏两种节奏。 + +## AI 的边界 + +一期不做 AI。二期可选「把同一概念下的错误归并成高频误区」,且**必须由用户手动触发**:错误记录的产生不附带 AI 调用,避免录入成本被计费与等待抬高。具体提示词与归并口径在实现该阶段前另定。 + +## 待定 + +- 错误记录与[内容归属](knowledge-ownership.md)的关系:是像碎片一样拥有独立归属,还是只挂在概念 / 导图节点上。 +- 回看列表与[复习总览](review-overview.md)的入口关系:独立页面,还是总览内的一块。 +- 删除口径:软删除?关联的导图节点被删除后,错误记录如何保留。 +- 错误记录是否参与学习报告与导出。 + +## 相关概念 + +- 知识碎片:并列的记录形态,记录「学到什么」。 +- 标准思维导图:错误记录可挂在它的节点与概念上。 +- 标记:错误记录使用自由标签。 +- 复习总览与复习 Feed:错误记录只在单独的回看列表里出现。 diff --git a/docs/concepts/marker.md b/docs/concepts/marker.md index 3d9b686..cd0ba25 100644 --- a/docs/concepts/marker.md +++ b/docs/concepts/marker.md @@ -29,6 +29,15 @@ - **标签**(用户标签):用户自由建立的分类,多个、可为空、可变,只影响检索。 - **来源标记**:例如「来自学习引导」。系统标记,由系统在产出时写入,用户不可编辑。 +- **自动任务名标签**:碎片获得内容归属时,由系统按所属任务自动写入一条用户标签,名字取任务当时的名字。它是用户标签而非系统标记:用户可以改名或删除;任务之后改名也不会回溯改写历史碎片上的标签。 + +## 标签字典 + +用户可以在打标签之前先把标签建出来,这些尚未挂在任何对象上的标签存放在统一的标签字典里。字典只是候选项的来源: + +- 打标签时输入即过滤字典(含自动任务名标签),也可以直接输入一个新名字。 +- 字典的改名与删除只影响候选,不影响任何对象上已经打好的标记。 +- 名字按去空格、大小写不敏感的口径去重,展示时保留用户输入的原样。 ## 相关概念 @@ -43,4 +52,5 @@ 2. **两类标记彻底分开**:系统标记的名字与值来自固定词表,由系统写入,用户只能查看;用户标签的名字由用户自由输入,可增删改。同一个对象上两类可以共存、互不覆盖。 3. **系统标记成对、标签只有名**:系统标记表达的是「名 = 值」(来源 = 学习引导),用户标签的一个词本身就是全部信息,不再附值。 4. **检索只做单一标记筛选**:点一个标记即筛选出带它的对象。不做多标记组合、不做跨对象统一搜索页——标签的唯一作用就是检索,检索入口是它存在的理由,但组合检索目前没有真实使用场景。 -5. **标记对用户全部可见,用户标签可改名、可删除**。改名是安全的:标记不参与聚合口径,批量改名不会像改内容归属那样污染统计与检索口径。不做「废弃」这一状态——保留历史标记的收益很小,而它会给检索与展示增加判断分支。 +5. **标签字典独立于标记存放**。标记描述的是「某个对象上有一个标记」,缺了对象就不再是标记;字典是候选项,与标记是两份数据,因此不为「空标签」在标记表里造没有对象的行。 +6. **标记对用户全部可见,用户标签可改名、可删除**。改名是安全的:标记不参与聚合口径,批量改名不会像改内容归属那样污染统计与检索口径。不做「废弃」这一状态——保留历史标记的收益很小,而它会给检索与展示增加判断分支。 diff --git a/docs/concepts/recall-review.md b/docs/concepts/recall-review.md index fd41bf3..feabe2f 100644 --- a/docs/concepts/recall-review.md +++ b/docs/concepts/recall-review.md @@ -2,7 +2,7 @@ ## 定义 -回忆对比是用户凭记忆重建某个学习任务的知识结构,并把它与标准思维导图进行比较的过程。 +回忆对比是用户凭记忆重建一个知识结构范围,并把它与对应的标准思维导图进行比较的过程。范围可以是一个学习任务(任务导图),也可以是一个标签集合(标签导图)。 对比结果把节点分为: @@ -21,6 +21,7 @@ 每一次回忆对比都会留下一条回忆记录,包含: - 发生时间。 +- 复习对象:这次对比的是任务导图还是标签导图,以及对应的任务或标签集合。 - 复习起点(或整棵树)。 - 命中、遗漏、额外的节点集合。 - 覆盖率。 @@ -56,7 +57,7 @@ ## 相关概念 -- 标准思维导图:对比的基准。 +- 标准思维导图:对比的基准,任务导图与标签导图各自对应一种复习范围。 - 复习起点:用户可以选择从某个节点开始,只复习该子树。 - 知识碎片与学习报告:遗漏项可追溯回原文。 - 复习总览:消费覆盖率形成的任务级掌握度。 diff --git a/docs/concepts/review-feed.md b/docs/concepts/review-feed.md index 169ac94..f32fb55 100644 --- a/docs/concepts/review-feed.md +++ b/docs/concepts/review-feed.md @@ -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 卡片,它们需要先展开内容、看到完整上下文再决定,放回详情页之后滚动列表也不再承担整理职责。 diff --git a/docs/concepts/review-overview.md b/docs/concepts/review-overview.md index e136fba..c61bafe 100644 --- a/docs/concepts/review-overview.md +++ b/docs/concepts/review-overview.md @@ -25,6 +25,7 @@ - 学习任务:总览的行单位。 - 内容归属:决定内容进入哪个任务,也决定待归类内容是否出现在这里。 +- 标记(标签):任务之外的另一个聚合维度,按标签复习走标签导图,与总览的任务级入口并存。 - 标准思维导图:从任务进入深度复习的对象。 - 回忆记录与覆盖率:掌握度的来源。 - 复习耗时:与学习时长并列的投入口径。 diff --git a/docs/concepts/standard-mind-map.md b/docs/concepts/standard-mind-map.md index 48c4e77..4b820e0 100644 --- a/docs/concepts/standard-mind-map.md +++ b/docs/concepts/standard-mind-map.md @@ -17,7 +17,8 @@ - 学习报告与知识碎片:导图的生成素材。 - 内容归属:决定哪些碎片进入本导图;素材按归属取材,而不是按产生于哪个学习会话。 - 应用场景:作为独立分支进入导图。 -- 回忆对比:标准导图是用户回忆结果的对照基准。 +- 回忆对比:标准导图是用户回忆结果的对照基准,任务导图与标签导图都可以作为对照对象。 +- 标记(标签):标签导图的取材范围。 - 节点溯源:导图节点可以关联回原始报告、碎片或应用场景。 - 学习引导:从导图节点发起,产出的碎片按归属进入本导图。 @@ -32,6 +33,17 @@ 重新生成导图时不覆盖用户的手工编辑,而是把新内容合并进来。 +## 导图的范围 + +导图按取材范围分两种: + +- **任务导图**:以学习任务为范围,取材于内容归属为该任务的碎片、报告与应用场景。 +- **标签导图**:以一个标签集合为范围,取材于带这些标签的内容。多个标签时由用户选择取并集(带任一标签)或交集(同时带全部标签)。 + +两种范围并存,互不替代:任务导图回答「这个任务学到了什么结构」,标签导图回答「这个概念在不同任务里呈现出什么结构」。范围用规范化的标签集合表达,集合相同即同一张导图。 + +标签导图的重算与任务导图遵循同一口径:素材变化只把导图标记为待更新,重建由用户手动触发。 + ## 设计思路 标准导图应同时适合人工编辑和机器处理。它既可以用缩进大纲的形式让用户直接修改,也可以用树结构参与算法比较。 diff --git a/docs/design/module-boundaries.md b/docs/design/module-boundaries.md index c5d2e5a..5a6f476 100644 --- a/docs/design/module-boundaries.md +++ b/docs/design/module-boundaries.md @@ -23,14 +23,17 @@ - 按任务汇总复习状态(复习总览)。 - 滚动展示知识碎片(复习 Feed)。 -- 维护标准思维导图。 -- 提供回忆对比、回忆记录和遗漏项回溯。 +- 维护标准思维导图,包括任务导图与按标签聚合的标签导图。 +- 提供回忆对比、回忆记录和遗漏项回溯,复习对象可以是任务或标签集合。 - 提供学习引导(开放式问题与概念边界纠正)。 +- 维护标记与标签字典(提前建标签、改名、删除、按标签检索)。 - 记录复习耗时(回忆对比与学习引导)。 - 承接内容归属的调整动作与待归类内容的处理入口。 复习模块不要求用户逐条整理学习材料,材料是自动整理和对照分析的数据来源。复习按内容归属聚合,而不是按内容产生于哪次会话:这是归类动作与复习动作放在一起的原因。复习不做调度:不生成到期清单,只影响内容的出现概率。 +复习内部分两处:**展示层**是首页的复习 Feed(落地页上的滚动条),只展示内容与导航,外加一次性完成的归类;**操作层**是残片详情页,打标签、反馈与学习引导都在这里。拦断写操作是为了让滚动保持低阻力,不把“看到”变成“必须处理”。 + ## 应用场景 应用场景属于学习任务,而不是复习模块。它表示任务完成后用户希望具备的应用能力,参与标准导图生成,为复习提供现实语境。 diff --git a/docs/design/review-loop.md b/docs/design/review-loop.md index 63f8a55..7f52f61 100644 --- a/docs/design/review-loop.md +++ b/docs/design/review-loop.md @@ -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. **标签复习与任务复习并存。** 复习范围既可以是任务,也可以是标签集合;标签导图以规范化标签集合为键,多标签由用户选择并集或交集,素材变化只置待更新、重建由用户手动触发。