站点图标 小满的博客 专题、文章与长期积累
ARTICLE

01 标签与关系词典

标签与关系词典

标签用于机器检索,关系用于表达 note 之间的语义连接。标签名尽量使用英文 snake_case,正文保持中文。本词典对齐 Trilium 版 Engram runtime。

基础标签

  • #ai_context:AI-Context 范围标记,根节点继承。
  • #memory_type=preference:用户偏好。
  • #memory_type=fact:稳定事实。
  • #memory_type=decision:决策或 ADR。
  • #memory_type=gotcha:踩坑经验。
  • #memory_type=episode:一次交互或事件记录。
  • #memory_type=pattern:可复用模式、约定或代码结构。
  • #memory_type=config:配置、环境或工具设置。
  • #memory_type=protocol:记忆协议。
  • #memory_type=template:模板。
  • #memory_type=workflow:读写流程。
  • #memory_type=schema:标签、关系、结构词典。

范围标签

  • #memory_scope=global:全局生效。
  • #memory_scope=project:项目内生效。
  • #memory_scope=tool:某个工具内生效。
  • #memory_scope=ops:运维场景生效。
  • #project_xxx:具体项目,例如 #project_ekyc
  • #platform_android#platform_ios:平台范围。

Topic Key

  • #topic_key=memory/ai-context-runtime:同一主题的稳定 upsert 键。
  • topic_key 使用路径式命名:scope/domain/topic
  • 同一 topic_key 的新信息优先更新原 note,不重复建条。
  • 不同主题必须使用不同 topic_key,不允许用一个 note 承载多个无关主题。

状态和置信度

  • #memory_status=active:当前有效,默认可召回。
  • #memory_status=superseded:已被新记忆取代,默认不召回。
  • #memory_status=archived:归档,仅历史查询使用。
  • #memory_status=pending_review:存在冲突或低置信,需要用户确认。
  • #confidence=confirmed:用户明确确认或事实已验证。
  • #confidence=inferred:从交互中推断,使用时应保守。
  • #confidence=tentative:临时假设,不应作为硬约束。

来源标签

  • #source_tool=codex
  • #source_tool=claude_code
  • #source_tool=cursor
  • #source_tool=manual

推荐关系

  • ~supersedes:当前 note 取代旧 note。
  • ~derived_from:从某次记录、决策或资料沉淀而来。
  • ~related_project:关联项目节点。
  • ~related_tool:关联工具节点。
  • ~related_gotcha:关联踩坑条目。
  • ~evidence:指向证据 note。
  • ~conflicts_with:与另一条记忆存在冲突,需要判断。
  • ~scoped_with:与另一条记忆都有效,但适用范围不同。
  • ~compatible_with:与另一条记忆兼容,可同时保留。

冲突处理状态

  • 确认覆盖:新 note 添加 ~supersedes,旧 note 标记 #memory_status=superseded
  • 范围不同:双方保留 active,添加 ~scoped_with,正文写清 scope。
  • 暂不确定:双方保留,新增 ~conflicts_with,并把新 note 标记 #memory_status=pending_review