supports 字段治理协议
问题
当前 frontmatter 的 supports 字段存在语义混用:
- 证据支撑:
supports指向提供 T0/T1 事实的来源页(sources)。 - 导航回链:
supports指向相关的 synthesis 页、dashboard 或入口页。 - 结构回链:
supports指向本页被哪些更大结构引用。
当三者混在同一个 supports 列表中,读者和代理无法判断哪些链接是证据、哪些是导航、哪些是结构依赖。
治理规则
语义定义
| 字段 | 含义 | 允许的值 |
|---|---|---|
supports |
本页的证据支撑。本页的关键事实判断来自这些页面。 | sources/**、entities/**(仅当实体页提供了关键事实)。 |
related_sources |
本页有关系但不直接作为证据的来源。 | sources/** 中有主题关联但非核心支撑的页面。 |
related_synthesis |
本页有关系的综合页、协议页、入口页。 | synthesis/**、meta/**。 |
related_concepts |
本页有关系的概念页。 | concepts/**。 |
写入规则
新页面创建时:
supports:
# 只放 sources/ 和 entities/ —— 提供核心事实的页面
- "某来源页"
related_sources:
# 有主题关联但非核心证据的来源
- "另一来源页"
related_synthesis:
# 综合页、协议页、入口页、dashboard
- "某综合页"
- "某看板(馆内参考,未随本文公开)"
related_concepts:
# 概念页
- "某概念"
例外:
- synthesis_hub、synthesis_protocol 类页面(如前厅、退役说明、本协议页)可以将其他 synthesis 页放入
supports,因为这些页面的"证据"就是其他综合判断。 - 纯导航/入口页可以将 synthesis 页放入
supports。
判断公式:
本页的核心事实判断是否直接依赖该链接页面的内容?
-> 是:放入 supports
-> 否,但有主题关联:放入 related_* 对应字段
-> 否,且只是结构引用(如"本页被前厅引用"):不放入任何关系字段,
因为反向引用由被引用页面自己维护
审计规则
对现有页面的 supports 审计,逐页执行:
- 读取
supports列表中的每个链接。 - 判断它是否直接为本页提供 T0/T1 事实。
- 如果不是:
- 如果是 synthesis/meta 类页面,移到
related_synthesis。 - 如果是 sources 类页面但非核心证据,移到related_sources。 - 如果是 concepts 类页面,移到related_concepts。 - 审计后更新
updated日期。
当前已知问题
| 问题 | 规模 | 说明 |
|---|---|---|
synthesis 页的 supports 包含其他 synthesis 页 |
广泛 | 多数 synthesis 页将入口页、看板和其他综合页放入 supports。按本协议应移到 related_synthesis。 |
sources 页的 supports 包含 synthesis 页 |
较少 | 部分来源页将引用自己的综合页放入 supports。按本协议应移到 related_synthesis。 |
concepts 页的 supports 包含 synthesis 页 |
较少 | 少数概念页将综合页放入 supports。按本协议应移到 related_synthesis。 |
129 个 concepts 页缺 related_sources |
129/246 | 需逐页补入相关来源链接。 |
563 个 synthesis 页缺 related_sources |
563/658 | 需逐页补入相关来源链接。 |
执行建议
| 批次 | 目标 | 操作 |
|---|---|---|
| 批次 A | 高频核心概念页(~20 个 active 概念) | 审计 supports,将非 sources 链接移到 related_synthesis。 |
| 批次 B | 高频 synthesis 页(~30 个核心综合页) | 同上。 |
| 批次 C | 剩余 concepts 页的 related_sources 补全 |
从正文中的来源引用反向填入 related_sources。 |
| 批次 D | 剩余 synthesis 页的 related_sources 补全 |
同上,可按主题分批。 |
使用边界
- 不批量修改现有页面的
supports;每次审计只处理一个页面。 - 不删除
supports中的链接,只移动到更合适的字段。 - 审计后不改变页面正文的双链结构;只调整 frontmatter。
supports为空不代表页面无效;有些页面(如本协议页)的支撑就是其他协议判断。
