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

57 lines
4.1 KiB
Markdown

# 标记
## 定义
标记是附加在系统对象上的一段轻量元信息,用来表达对象的来源、性质或用户自己的分类。所有标记统一存放,而不是在碎片等表结构里为每一种标记各加一个字段。
一条标记至少包含:
- **对象**:对象类型与对象标识(例如某条知识碎片、某个学习任务)。
- **标记名与标记值**:例如「来源 = 学习引导」「标签 = 英语」。
- **种类**:系统标记或用户标签。
- **建立信息**:建立者(系统或用户)与建立时间。
## 设计意图
- 新增一种标记时不需要改动各功能表结构,避免碎片、报告等表被标记字段逐渐撑开。
- 跨功能检索统一:按标记找对象只查一处。
- 让「来源」「标签」这类弱信息有唯一的存放位置,语义清晰,不再散落在各功能里。
## 边界
标记不是状态,也不是归属:
- 会话状态、报告能否修订、导图是否待更新这类会影响流程判断的信息,留在各自主体上,不进标记表。用标记表达状态会让流程判断变得不可枚举。
- 标记只被读取和展示,不参与聚合口径,也不改变内容归属。
- 内容归属是唯一的结构归属,标记不能用来表达第二归属。
## 现有与预期的标记
- **标签**(用户标签):用户自由建立的分类,多个、可为空、可变,只影响检索。
- **来源标记**:例如「来自学习引导」。系统标记,由系统在产出时写入,用户不可编辑。
- **自动任务名标签**:碎片获得内容归属时,由系统按所属任务自动写入一条用户标签,名字取任务当时的名字。它是用户标签而非系统标记:用户可以改名或删除;任务之后改名也不会回溯改写历史碎片上的标签。
## 标签字典
用户可以在打标签之前先把标签建出来,这些尚未挂在任何对象上的标签存放在统一的标签字典里。字典只是候选项的来源:
- 打标签时输入即过滤字典(含自动任务名标签),也可以直接输入一个新名字。
- 字典的改名与删除只影响候选,不影响任何对象上已经打好的标记。
- 名字按去空格、大小写不敏感的口径去重,展示时保留用户输入的原样。
## 相关概念
- 知识碎片:最常见的标记对象。
- 内容归属:与标签互补——归属是唯一结构归属,标签是弱关联。
- 学习引导:产出的碎片带来源标记。
- 学习任务:标签也可以挂在任务上用于检索。
## 已确认的结论
1. **可挂对象是知识碎片与学习任务**。报告是会话的派生结果,而且它自身已经有一个「按归属分组」的维度,再挂标记会出现两套「分组」语义;会话是时间轴对象,其流程性信息按边界要求留在主体上。
2. **两类标记彻底分开**:系统标记的名字与值来自固定词表,由系统写入,用户只能查看;用户标签的名字由用户自由输入,可增删改。同一个对象上两类可以共存、互不覆盖。
3. **系统标记成对、标签只有名**:系统标记表达的是「名 = 值」(来源 = 学习引导),用户标签的一个词本身就是全部信息,不再附值。
4. **检索只做单一标记筛选**:点一个标记即筛选出带它的对象。不做多标记组合、不做跨对象统一搜索页——标签的唯一作用就是检索,检索入口是它存在的理由,但组合检索目前没有真实使用场景。
5. **标签字典独立于标记存放**。标记描述的是「某个对象上有一个标记」,缺了对象就不再是标记;字典是候选项,与标记是两份数据,因此不为「空标签」在标记表里造没有对象的行。
6. **标记对用户全部可见,用户标签可改名、可删除**。改名是安全的:标记不参与聚合口径,批量改名不会像改内容归属那样污染统计与检索口径。不做「废弃」这一状态——保留历史标记的收益很小,而它会给检索与展示增加判断分支。