diff --git a/docs/concepts/knowledge-ownership.md b/docs/concepts/knowledge-ownership.md index 79de5b5..03ab5b6 100644 --- a/docs/concepts/knowledge-ownership.md +++ b/docs/concepts/knowledge-ownership.md @@ -1,6 +1,6 @@ # 内容归属 -> 状态:**设计已确认,实现待安排**。三个待决问题已于 2026-09-19 由维护者确认,结论见文末。 +> 状态:**设计已确认**。三个待决问题于 2026-09-19 确认,四项实现级取舍于 2026-10-09 确认,结论均见文末。 ## 定义 @@ -97,3 +97,11 @@ 1. **碎片不可脱离记录上下文。** 不存在没有记录上下文的内容:每一条碎片都产生于某次学习会话或某次复习行为(回忆对比、学习引导),因此一定有可追溯的产生场景。代价是系统不向可以随手记录的通用笔记工具演进,这是有意的边界。 2. **学习报告改为结构化呈现。** 报告由会话摘要、预期达成判断、按归属分组的碎片和自由总结组成;旁支碎片仍留在本次报告中,只单独标注归属、不参与正文推演。自由总结必须保留,否则卡点与下一步无处表达。 3. **内容归属保持单一,跨领域关联由标签承担。** 学习内容很少只属于一个领域:一份侧重 A 领域的材料仍会带来 B 领域的碎片,但它仍归属 A,与 B 的关联用标签表达。如果用户持续在同一领域积累旁支碎片,说明该领域已值得作为独立学习任务,此时走“待归类内容升格为学习任务”的路径,而不是给它第二个归属。 + +### 实现级结论(2026-10-09 确认) + +4. **报告里的分组是实时聚合,不做快照。** 报告只保存三段文本(会话摘要、预期达成判断、自由总结);「按归属分组的碎片」在查看时按碎片的当前归属聚合。理由是它与标准导图的取材口径必须一致,否则会出现「报告说属于甲、导图放在乙」的两套口径,而这正是内容归属要消灭的东西。旁支碎片由此也不需要额外字段——它就是归属不等于本会话所属任务的那部分。 +5. **迁移历史内容时保留原会话。** 记录上下文「不可为空」是硬约束,不为迁移放宽。历史碎片会连同它产生时的那次会话一起进来,因此它仍然能回答「当时在学什么的时候记的」。 +6. **删除报告不连带删除碎片。** 两者是并列关系而不是包含关系:报告是这次会话的收敛结果,碎片是原料。删报告时如果连带删碎片,会删掉那些已经被归类到其他任务的内容。 +7. **删除学习任务时,碎片保留并降为空归属(进入待归类)**,会话、报告、标准导图、回忆记录与应用场景随任务一并软删除。删任务撤销的是「这次学习的时间记录与收敛结果」,不是知识本身;碎片不因归属消失而消失。 +8. **待归类在两处出现**:复习总览里独立成一块,复习 Feed 里混排并打标、归类就在卡片上完成。 diff --git a/docs/concepts/marker.md b/docs/concepts/marker.md index c7de436..3d9b686 100644 --- a/docs/concepts/marker.md +++ b/docs/concepts/marker.md @@ -37,10 +37,10 @@ - 学习引导:产出的碎片带来源标记。 - 学习任务:标签也可以挂在任务上用于检索。 -## 待决问题 +## 已确认的结论 -1. 标记可以挂在哪些对象上(知识碎片 / 学习报告 / 学习任务 / 学习会话)? -2. 标记名的受控方式:系统标记用固定词表、用户标签自由输入;是否允许用户在系统标记上叠加自己的值。 -3. 标记值是否只在需要时使用(布尔开关 / 枚举 / 自由文本)。 -4. 是否需要按标记检索的入口(例如“找出所有来自学习引导的碎片”),以及需要哪些索引。 -5. 标记名如何治理(能否重命名或废弃),以及哪些标记对用户展示。 +1. **可挂对象是知识碎片与学习任务**。报告是会话的派生结果,而且它自身已经有一个「按归属分组」的维度,再挂标记会出现两套「分组」语义;会话是时间轴对象,其流程性信息按边界要求留在主体上。 +2. **两类标记彻底分开**:系统标记的名字与值来自固定词表,由系统写入,用户只能查看;用户标签的名字由用户自由输入,可增删改。同一个对象上两类可以共存、互不覆盖。 +3. **系统标记成对、标签只有名**:系统标记表达的是「名 = 值」(来源 = 学习引导),用户标签的一个词本身就是全部信息,不再附值。 +4. **检索只做单一标记筛选**:点一个标记即筛选出带它的对象。不做多标记组合、不做跨对象统一搜索页——标签的唯一作用就是检索,检索入口是它存在的理由,但组合检索目前没有真实使用场景。 +5. **标记对用户全部可见,用户标签可改名、可删除**。改名是安全的:标记不参与聚合口径,批量改名不会像改内容归属那样污染统计与检索口径。不做「废弃」这一状态——保留历史标记的收益很小,而它会给检索与展示增加判断分支。 diff --git a/docs/design/review-loop.md b/docs/design/review-loop.md index a5134a4..6270a1b 100644 --- a/docs/design/review-loop.md +++ b/docs/design/review-loop.md @@ -120,7 +120,7 @@ - **无需记录的反馈**:展开查看、进入回忆对比,本身就是复习行为,不产生额外数据。 - **需要记录的反馈**:用户主动标记“已掌握”或“稍后再看”,用于调整出现概率。 -反馈动作的存在方式列入待决问题:它既可能帮助系统更准地安排内容,也可能把复习拖回清单模式。 +反馈动作确定为两个轻量动作:**已掌握**与**稍后再看**。它们只调整内容的出现概率,不产生状态展示、不统计总数、不形成待复习列表;「已掌握」降低出现概率但不归零,随机性仍然保留。此外,展开查看与进入回忆对比会刷新「上次复习时间」,让它成为继时间效应与任务掌握度之后的第三个信号。 ## AI 在复习中的边界 @@ -128,13 +128,13 @@ - 归类建议由 AI 增强,AI 不可用时降级为关键词与历史归属的规则建议;规则也不可用时不做建议,不影响复习流程。 - AI 不参与“该复习什么”的判定:排序信号来自时间与回忆记录,AI 只影响匹配与建议。 -## 待决问题 +## 已确认的结论 -以下问题需要维护者确认后再进入实现: +以上问题已由维护者确认,结论如下: -1. **Feed 是否包含学习报告?** 本文档的取向是:Feed 只出知识碎片,报告以“会话完整结果”的形态从任务记录进入,不与碎片并列成条目,避免同一段内容以两种形态重复出现。 -2. **复习反馈动作的形态。** 可选:只读(现状)/加“已掌握 / 稍后再看”轻反馈并参与权重/只提供“稍后再看”而不提供“已掌握”。轻反馈是否会演变成清单,是本项的核心顾虑。 -3. **覆盖率口径。** 本文档暂按“最近一次回忆对比”计算;另一种做法是取最近若干次的加权结果,代价是变化被平滑、遗忘的征兆出现得更晚。 -4. **待归类内容的呈现方式。** 在复习总览中独立成一类“待归类”,还是在 Feed 中与其他内容混排并打标;以及归类动作是否必须在卡片上可完成。 -5. **遗漏项的语义。** 本文档按“每次对比的快照 + 可回看原文”设计,不做跨次累计的待处理集合。若改为累计,需要重新论证它不会变成待办清单。 -6. **排序信号是否可配置。** 掌握度与时间效应的强度是否像任务优先级权重那样对用户开放,还是固定为默认值。 +1. **Feed 不含学习报告。** Feed 只出知识碎片;报告以「一次会话的完整结果」的形态从任务记录进入,不与碎片并列成条目,避免同一段内容以两种形态重复出现。 +2. **反馈动作取「已掌握 + 稍后再看」两个轻量动作**,并让「上次复习时间」成为第三个权重信号。不统计「已掌握」的总数、不做待复习列表、不把动作结果展示成状态,以此避免演变成清单。 +3. **覆盖率取最近一次回忆对比。** 不做最近若干次的加权平均:加权会让变化被平滑、遗忘的征兆出现得更晚,而覆盖率是事实而非成绩,越直接越好。 +4. **待归类内容两处都要出现。** 复习总览里独立成一块(回答「还欠多少」),复习 Feed 里与其他内容混排并打标,且归类动作就在卡片上完成,一次交互可结。理由:复习的日常入口常常是 Feed 而不是总览,只放一处会漏。 +5. **遗漏项是每次对比的快照**,可回看原文,不做跨次累计的待处理集合。跨次累计会把它变成一份待办清单,与复习的立场冲突。 +6. **排序信号强度按三档预设对用户开放**:时间为主(默认)/均衡/掌握度为主。不给精确数值:现有排序是两个因子相乘而非加权求和,百分比是假精度,而三个档位已经覆盖真实意图。