docs: 标记、复习回路与内容归属的待决问题改为结论

This commit is contained in:
cat-shark
2026-10-09 17:53:11 +08:00
parent 39efbb6612
commit 8c55b865fd
3 changed files with 24 additions and 16 deletions
+9 -1
View File
@@ -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 里混排并打标、归类就在卡片上完成。
+6 -6
View File
@@ -37,10 +37,10 @@
- 学习引导:产出的碎片带来源标记。
- 学习任务:标签也可以挂在任务上用于检索。
## 待决问题
## 已确认的结论
1. 标记可以挂在哪些对象上(知识碎片 / 学习报告 / 学习任务 / 学习会话)?
2. 标记名的受控方式:系统标记用固定词表、用户标签自由输入;是否允许用户在系统标记上叠加自己的值。
3. 标记值是否只在需要时使用(布尔开关 / 枚举 / 自由文本)。
4. 是否需要按标记检索的入口(例如“找出所有来自学习引导的碎片”),以及需要哪些索引。
5. 标记名如何治理(能否重命名或废弃),以及哪些标记对用户展示。
1. **可挂对象是知识碎片与学习任务**。报告是会话的派生结果,而且它自身已经有一个「按归属分组」的维度,再挂标记会出现两套「分组」语义;会话是时间轴对象,其流程性信息按边界要求留在主体上。
2. **两类标记彻底分开**:系统标记的名字与值来自固定词表,由系统写入,用户只能查看;用户标签的名字由用户自由输入,可增删改。同一个对象上两类可以共存、互不覆盖。
3. **系统标记成对、标签只有名**:系统标记表达的是「名 = 值」(来源 = 学习引导),用户标签的一个词本身就是全部信息,不再附值。
4. **检索只做单一标记筛选**:点一个标记即筛选出带它的对象。不做多标记组合、不做跨对象统一搜索页——标签的唯一作用就是检索,检索入口是它存在的理由,但组合检索目前没有真实使用场景。
5. **标记对用户全部可见,用户标签可改名、可删除**。改名是安全的:标记不参与聚合口径,批量改名不会像改内容归属那样污染统计与检索口径。不做「废弃」这一状态——保留历史标记的收益很小,而它会给检索与展示增加判断分支。
+9 -9
View File
@@ -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. **排序信号强度按三档预设对用户开放**:时间为主(默认)/均衡/掌握度为主。不给精确数值:现有排序是两个因子相乘而非加权求和,百分比是假精度,而三个档位已经覆盖真实意图。