Document Knowledge Graph zh CN

文档知识图（记忆图网）

语言： English · 简体中文

文档知识图也称记忆图网，用于连接当前 Wiki Page 与不可变 Source。它回答词法搜索无法直接回答的结构问题：哪些页面引用了这份证据、页面之间如何相连、两个概念能否沿关系到达，以及依赖变化可能影响哪里。

权威数据与投影

SQLite 始终是规范存储，图只是根据当前文档与关系重建的投影，不能成为第二套事实来源。

LWC 会投影：

• 每篇当前 Page 对应一个节点（page:<slug>）；
• 每份当前 Source 对应一个节点（source:<id>）；
• 从 [[wiki-links]] 提取的 LINKS_TO 边；
• 从页面引用生成的 CITES 边；
• 经过审计的显式语义关系。

旧 Source 版本仍在 SQLite 中保持不可变；图只跟随当前路径 head 与当前页面正文。

什么时候使用

以下问题适合文档图：

• 探索未知拓扑和关系；
• 查看直接入站或出站邻居；
• 查找两个节点之间的最短类型路径；
• 分析反向依赖影响；
• 根据结构证据寻找相关页面；
• 记录需要审计轨迹的支持、矛盾、细化、取代、因果或依赖声明。

直接查找已知内容时使用 search、page show 或 source show。一篇已知文档足以回答问题时，图遍历不会带来额外价值。

启用一个图引擎

图存储默认关闭。启用或切换引擎会改变项目配置与投影状态，因此 Agent 必须先取得授权。

默认推荐嵌入式 Grafeo：

lwc --scope project config set --graph grafeo
lwc --scope project work watch <work-id>
lwc --scope project graph status
lwc --scope project graph verify

只有项目策略已经选择 SurrealDB 时才使用：

lwc --scope project config set --graph surrealdb

配置响应可能返回 Work。只有该 Work 达到 succeeded，并且 graph verify 返回 ok=true，才能视为完成；queued 或 running 都不算完成。

图 Work 活跃期间不得切换或关闭引擎，也不能复制、编辑或删除 LWC 管理的图 sidecar。

有界遍历

从足以回答问题的最小操作开始：

lwc graph overview --limit 10
lwc graph node page:projection-policy
lwc graph neighbors page:projection-policy --direction outgoing --limit 100
lwc graph path page:implementation page:policy --max-depth 6 --limit 200
lwc graph explore page:policy --direction both --depth 2 --limit 100

• overview 汇总节点、关系数量和枢纽。
• node 解析一个标识符，并返回有界度数信息。
• neighbors 返回直接类型邻居。
• path 解释一条最短类型路径。
• explore 在限定范围内遍历邻域；只有需要代表性宏观视图时才省略节点标识符。

只关心特定关系时，可以重复使用 --edge-type 过滤。用于自动化时，应明确指定上限与深度。

相关页面

lwc graph related customer-membership --limit 20

related 只会对存在结构证据的页面排序。它综合双向 Wiki 链接、共享 Source 引用和 Adamic–Adar 共同邻居证据；页面 kind 亲和度只负责进一步调整这些候选。响应会展示每一项信号，便于 Agent 解释排序原因。

这是结构相关性，不代表语义声明正确。依赖结果前仍需打开页面并检查证据。

影响分析

lwc graph impact page:policy --max-depth 4 --limit 100

impact 沿反向依赖传播，并把受影响节点分为必须处理或需要复核。它是一项有界变更审查辅助，不能据此断定每个返回节点都必须修改。

显式语义关系

自动边只表达引用和 Wiki 链接。强语义声明必须使用以下受支持类型显式写入：

• SUPPORTS
• CONTRADICTS
• REFINES
• SUPERSEDES
• CAUSES
• DEPENDS_ON

创建或替换一条关系：

lwc graph relation set page:implementation DEPENDS_ON page:policy \
  --provenance source-grounded \
  --source 12 \
  --reason "Source 12 states the required policy" \
  --confidence 0.95

检查并撤回关系：

lwc graph relation list --from page:implementation --limit 100
lwc graph relation retract page:implementation DEPENDS_ON page:policy \
  --reason "The dependency was superseded"

每条显式关系都必须附带简明 provenance、原因和置信度。source-grounded 关系必须引用所有支持它的 Source ID。原因属于持久内容，不得写入秘密或私密推理。

投影生命周期

启用图后，Page 与 Source 变更会排入文档粒度 Work。应跟踪响应返回的 Work，不能因为写入命令退出就认定投影已经完成：

lwc work status <work-id>
lwc work watch <work-id>

投影仍在等待或失败时，规范搜索与读取仍然可用。校验报告 missing、mismatched 或 stale 文档时，应通过受支持的配置、Work、checkpoint 或 changeset 恢复流程修复，禁止直接修改 sidecar。

Changeset 使用彼此隔离的草稿 Work 与图状态。提交后投影 live 文档；丢弃草稿只会删除该草稿的派生状态。

完成证据

文档图只有满足以下条件才算就绪：

• 配置报告预期引擎与作用域；
• 每项相关 Work 都达到 succeeded；
• graph status 报告预期的当前文档；
• graph verify 返回 ok=true，且没有 missing、mismatched 或 stale 项；
• 显式关系使用受支持类型并具备完整审计元数据；
• 遍历使用了适合当前问题的有界深度、上限和过滤器。

下一篇：代码图