# 内容归属与标记 - **功能**:区分知识碎片的「记录上下文」与「内容归属」两个维度,并统一管理标记元信息。 - **何时用**:改动碎片归属、生成或查看报告、取材导图、新增或检索标记时。 ## 内容归属与结构化报告(归属-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`)。