Files
lpt-be/roles/ownership-and-markers.md
T

3.0 KiB
Raw Blame History

内容归属与标记

  • 功能:区分知识碎片的「记录上下文」与「内容归属」两个维度,并统一管理标记元信息。
  • 何时用:改动碎片归属、生成或查看报告、取材导图、新增或检索标记时。

内容归属与结构化报告(归属-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)。