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?"通过仪表盘
也可直接在仪表盘中创建关系:
- 打开 Space 并点击任意 Knowledge Item
- 在抽屉中向下滚动到 Related Items,点击 + Link 按钮
- 从下拉菜单中选择目标条目
- 选择关系类型
- 可选勾选 Bidirectional 以创建双向关联
- 点击 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