Skip to content

关系图 · 字段含义速查 ​

关系图(plugin-user-relation 的数据,WebUI 关系图页与原始数据页显示)所用字段与 中文术语对照。命令 /relation compress | maintain 触发的压缩 / 体检 也使用同一套语义。

三类节点 ​

kind中文关系图页的分类色来源
person人物第 1 色observePerson(按 platform+userId upsert)
event事件第 2 色LLM 提取的对话事件
entity物(topic/place/thing/work)第 3 色LLM 提取的"被讨论的客体"

六类边 ​

kind中文示例语义
person-event人 → 事件角色 role 见下
person-entity人 → 物角色 role 见下
person-person人 → 人关系 relation 见下
event-event事件 → 事件因果 / 时间相邻 / 同主题
event-entity事件 → 物事件涉及到某物
entity-entity物 → 物part-of / alias / 层级 / 侧向父等

role 字段(仅人 → 事件 / 人 → 物) ​

人 → 事件:

token中文
initiator发起者 / 提起话题者
participant主要参与者
witness旁观者
target被指向 / 被评价
reporter转述 / 报告者(未亲历)

人 → 物:

token中文
enthusiast深度行为性卷入(≠ 单句"喜欢")
participant参与 / 使用
owner拥有
creator创作者
critic行为性批评(写评测 / 公开对抗)
visitor到访(适用于 place)
mentioned仅被提及,态度不明(搭配 sentiment)

单句态度声明("我喜欢 X")不在关系图记录,归 plugin-user-profile 画像层。

relation 字段(仅人 → 人) ​

人 → 人边默认有向(directed 缺省为 true,按单向声明记录),高低位(如师徒)由下文的 hierarchy 表达。

token中文
friend朋友
cpCP
rival对手
mentor师徒
colleague同事
familiar熟人
antagonist敌对
admirer仰慕者
is-alias-ofA 是 B 的别名 / 小号
alt-account-ofA 是 B 的小号

relation 只做大小写与空白规整(去首尾空白、转小写、空白换成下划线),模型自创的词原样保存,不归并成上表的词。

sentiment 字段(可附加在任意角色边上) ​

positive 积极 · negative 消极 · neutral 中性 · mixed 复杂。

hierarchy 字段(仅人 → 人,与 directed 正交) ​

token中文
superiorfrom 视角下高位(老板 / 师父 / 长辈)
peer明确平级
subordinate低位
unknown未知(默认)

三个数值指标 ​

合并强度 weight(0~1) ​

节点 / 边被重复合并的累计程度:事件 / 实体节点首建为 0.5,每次合并 +0.3(封顶 1); 边首次按 role 取默认权重(约 0.1~0.7),每次强化 prev + (1 - prev) · 0.1(封顶 1)。

语义 = 被强化次数,不是重要性。

图重要性 lastPageRank ​

最近一次 /relation compress | maintain,或提取后超配额触发的自动淘汰计算的全图 PageRank。 个性化种子按 kind 加权:人 = 2 · 物 = 1.5 · 事 = 1。 越高越靠近"核心人物 · 热门事件"。未跑过压缩则为空。

边淘汰分(仅边详情) ​

合并强度 × ((PR_from + PR_to) / 2)。 配额淘汰时按此升序删——分越低越先删。 让"弱权但连接重要节点"的边受保护。

压缩与孤儿清理 ​

/relation compress 与 /relation maintain 都走以下流程:

  1. 孤儿清理(与配额无关,无条件):所有"没有任何边端点引用" 的节点都删 —— person / event / entity 一视同仁。同一趟先清掉的悬空边 (端点指向不存在节点)不计作引用,故只被悬空边牵住的节点一趟即删。 被删的 person 下次发言时会由 observePerson 重建,所以安全。
  2. 配额淘汰(仅在 count > quota · (1+hysteresisPct) 触发): 按 (now - lastReinforcedAt) / (max(weight, 0.05) · max(PR, ε)) 降序删,直到 count ≤ floor(quota · targetPct)。不设硬豁免:重要性完全由 PageRank、 weight 衰减与 mentionCount 表达。
  3. 边按配额删:保留 合并强度 × 端点 PR 平均 最高的。

文档对应 dev@c4e046e41,core 0.21.0,构建于 2026-11-02
基于 MIT 许可发布