Knowledge Graph

为知识条目建立有意义的关联,构建相互连接的信息网络。

什么是 Knowledge Graph?

Knowledge Graph 将存储的条目从平铺列表转化为互联网络。每条关系描述两个知识片段的连接方式,帮助 Claude 更好地理解上下文并找到相关信息。

例如,Bug 报告可以关联到其依赖的功能规格,决策文档可以取代旧版本,测试模式可以引用所覆盖的 Hook。

关系类型

类型含义示例
related_to通用关联"Auth Flow" ↔ "Login Bug"
references引用或提及"Design Doc" → references → "API Spec"
depends_on依赖对方才能运行"Feature X" → depends on → "Auth System"
implements实现对方所描述的内容"PR #42" → implements → "Feature Spec"
extends在对方基础上扩展"V2 Plan" → extends → "V1 Plan"
part_of是对方的组成部分"Login Page" → part of → "Auth Module"
similar_to内容相似"Error Handling v1" ↔ "Error Handling v2"
derived_from基于对方创建"Summary" → derived from → "Meeting Notes"
supersedes取代对方"New Policy" → supersedes → "Old Policy"
contradicts与对方冲突"Requirement A" ↔ "Requirement B"

创建关系

通过 Claude(MCP)

最自然的创建方式是在终端中向 Claude 提问,Claude 会自动使用 MCP 工具。

关联两个条目

"The Auth Flow item depends on the Login Bug, link them"

双向关联

"Connect Test Patterns and Pre-Push Hook, they're related to each other"

查询关联

"What's connected to Auth Flow?"

探索知识网络

"What do I have about testing and how is it all connected?"

通过仪表盘

也可直接在仪表盘中创建关系:

  1. 打开 Space 并点击任意 Knowledge Item
  2. 在抽屉中向下滚动到 Related Items,点击 + Link 按钮
  3. 从下拉菜单中选择目标条目
  4. 选择关系类型
  5. 可选勾选 Bidirectional 以创建双向关联
  6. 点击 Link

单向与双向关联

单向

关联只有一个方向,适用于有明确方向性的关系。

示例: Feature X → implements → Spec Y

双向

关联双向有效,适用于对称关系。

示例: Doc A ↔ related to ↔ Doc B

查看关系

查看关系的几种方式:

  • Space 统计网格——显示该 Space 的关系总数
  • 条目列表——有关联的条目会显示"Linked to..."标签,列出关联条目名称
  • 条目抽屉——Related Items 区块显示所有关联,包含方向指示和关系类型标签
  • Claude——询问"[条目]关联了什么?",Claude 会使用 memory_list_relationships 展示关联内容

删除关系

在条目抽屉中,将鼠标悬停在任意关系行上,点击垃圾桶图标即可删除。对于双向关系,删除时会同时移除两个方向的关联。

MCP 工具参考

memory_relate

在两个条目之间创建关系。

source_id——源条目的 UUID

target_id——目标条目的 UUID

relationship_type——上表中列出的类型之一

weight——关系强度(0-1,默认:0.5)

bidirectional——是否创建双向关联(默认:false)

memory_list_relationships

列出某个知识条目的所有关系。

item_id——要查询的条目 UUID