Files
lpt-docs/docs/concepts/marker.md
T

4.1 KiB

标记

定义

标记是附加在系统对象上的一段轻量元信息,用来表达对象的来源、性质或用户自己的分类。所有标记统一存放,而不是在碎片等表结构里为每一种标记各加一个字段。

一条标记至少包含:

  • 对象:对象类型与对象标识(例如某条知识碎片、某个学习任务)。
  • 标记名与标记值:例如「来源 = 学习引导」「标签 = 英语」。
  • 种类:系统标记或用户标签。
  • 建立信息:建立者(系统或用户)与建立时间。

设计意图

  • 新增一种标记时不需要改动各功能表结构,避免碎片、报告等表被标记字段逐渐撑开。
  • 跨功能检索统一:按标记找对象只查一处。
  • 让「来源」「标签」这类弱信息有唯一的存放位置,语义清晰,不再散落在各功能里。

边界

标记不是状态,也不是归属:

  • 会话状态、报告能否修订、导图是否待更新这类会影响流程判断的信息,留在各自主体上,不进标记表。用标记表达状态会让流程判断变得不可枚举。
  • 标记只被读取和展示,不参与聚合口径,也不改变内容归属。
  • 内容归属是唯一的结构归属,标记不能用来表达第二归属。

现有与预期的标记

  • 标签(用户标签):用户自由建立的分类,多个、可为空、可变,只影响检索。
  • 来源标记:例如「来自学习引导」。系统标记,由系统在产出时写入,用户不可编辑。
  • 自动任务名标签:碎片获得内容归属时,由系统按所属任务自动写入一条用户标签,名字取任务当时的名字。它是用户标签而非系统标记:用户可以改名或删除;任务之后改名也不会回溯改写历史碎片上的标签。

标签字典

用户可以在打标签之前先把标签建出来,这些尚未挂在任何对象上的标签存放在统一的标签字典里。字典只是候选项的来源:

  • 打标签时输入即过滤字典(含自动任务名标签),也可以直接输入一个新名字。
  • 字典的改名与删除只影响候选,不影响任何对象上已经打好的标记。
  • 名字按去空格、大小写不敏感的口径去重,展示时保留用户输入的原样。

相关概念

  • 知识碎片:最常见的标记对象。
  • 内容归属:与标签互补——归属是唯一结构归属,标签是弱关联。
  • 学习引导:产出的碎片带来源标记。
  • 学习任务:标签也可以挂在任务上用于检索。

已确认的结论

  1. 可挂对象是知识碎片与学习任务。报告是会话的派生结果,而且它自身已经有一个「按归属分组」的维度,再挂标记会出现两套「分组」语义;会话是时间轴对象,其流程性信息按边界要求留在主体上。
  2. 两类标记彻底分开:系统标记的名字与值来自固定词表,由系统写入,用户只能查看;用户标签的名字由用户自由输入,可增删改。同一个对象上两类可以共存、互不覆盖。
  3. 系统标记成对、标签只有名:系统标记表达的是「名 = 值」(来源 = 学习引导),用户标签的一个词本身就是全部信息,不再附值。
  4. 检索只做单一标记筛选:点一个标记即筛选出带它的对象。不做多标记组合、不做跨对象统一搜索页——标签的唯一作用就是检索,检索入口是它存在的理由,但组合检索目前没有真实使用场景。
  5. 标签字典独立于标记存放。标记描述的是「某个对象上有一个标记」,缺了对象就不再是标记;字典是候选项,与标记是两份数据,因此不为「空标签」在标记表里造没有对象的行。
  6. 标记对用户全部可见,用户标签可改名、可删除。改名是安全的:标记不参与聚合口径,批量改名不会像改内容归属那样污染统计与检索口径。不做「废弃」这一状态——保留历史标记的收益很小,而它会给检索与展示增加判断分支。