3.0 KiB
3.0 KiB
内容归属与标记
- 功能:区分知识碎片的「记录上下文」与「内容归属」两个维度,并统一管理标记元信息。
- 何时用:改动碎片归属、生成或查看报告、取材导图、新增或检索标记时。
内容归属与结构化报告(归属-01 / 报告-01)
知识碎片有两个互相独立的维度,改动任何一处都要先分清是哪一维:
- 记录上下文(
context_type+context_num):产生于哪次学习会话或复习行为。由系统确定、不可变、不可为空;用于时间统计与「这份报告里有哪些碎片」。 - 内容归属(
owner_task_num):内容在知识结构上属于哪个任务。由用户确定、可变、可为空(为空即待归类);用于导图取材、按任务检索与统计。
由此得出的几条硬约束:
- 导图、按任务检索、碎片计数一律按内容归属(
owner_task_num),不再用「该任务的会话所产生的报告/碎片」。 - 报告按会话生成,报告的任务来自它所属会话——这与上一条是两个视角,是有意为之,不是重复。
- 新建碎片时内容归属默认取该会话所属任务;用户可以改到别的任务或清空为待归类。
- 归属变化(或碎片删除)会把原任务与新任务的标准导图标记为
needs_update=1;重建由用户手动触发,不自动跑 AI。 - 报告只落库三段文本(
session_summary/expectation_verdict/free_summary);「按归属分组的碎片」不落库,查看时按当前归属实时聚合,以免与导图取材出现两套口径。文档里的展示顺序是:会话摘要 → 预期达成判断 → 按归属分组的碎片 → 自由总结。 - 删除报告不连带删除碎片;删除任务时碎片保留并把归属置空(进入待归类),其余(会话、报告、导图、回忆记录、应用场景)随任务软删除。
标记(标记-01)
标记是附加在对象上的轻量元信息,统一存放,新增一种标记不改各功能表结构。
- 可挂对象只有知识碎片与学习任务:报告是会话的派生结果且已有「按归属分组」这一维度;会话是时间轴对象,其流程性信息留在主体上。
- 两类彻底分开:系统标记走
SystemMarkerEnum固定词表、由系统写入、用户只读;用户标签自由增删改。分开的理由是「找出所有来自 X 的内容」这类检索必须可靠。 - 系统标记成对(名 = 值),用户标签只有名(标签名本身就是全部信息)。
- 检索只提供单一标记筛选;标记对用户全部可见,标签可改名可删除(改名安全:标记不参与聚合口径)。
- 标记不是状态:会话状态、报告可否修订、导图是否待更新这类流程判断留在主体上。碎片上的复习反馈(已掌握/稍后再看)也因此落在碎片自身字段,不进标记表。
- 对象被删除时清理其标记(
MarkerService.removeAllMarkers)。