Graphify 操作笔记及核心作用
Graphify 是一个面向 AI 编程助手的知识图谱工具，可将代码、文档等项目资料转换为结构化图谱，帮助 AI 在复杂项目中优先通过图谱导航，而不是直接进行全文搜索。本文记录 Graphify 的常用操作步骤及其核心作用。
1. 全局技能安装
首先执行全局安装命令，使 Graphify 支持指定平台：
$ graphify install --platform opencode
该命令用于为 opencode 平台安装 Graphify 相关技能，使后续 AI 助手可以识别并调用 Graphify 能力。
2. 项目级始终开启配置
进入具体应用目录后，执行以下命令：
$ graphify opencode install
执行后会在项目中完成以下配置：
- 在项目根目录生成
AGENTS.md文件 - 安装
tool.execute.before插件 - 插件路径为
.opencode/plugins/graphify.js
该配置的作用是让 Graphify 在项目级别持续生效。当 AI 即将执行 Bash 工具调用前，插件会提前触发，并引导 AI 优先通过知识图谱结构理解项目，而不是直接依赖关键词全文搜索。
3. 生成知识图谱
项目级配置完成后，进入 opencode，在 skill 中执行：
/graphify
执行后，Graphify 会基于当前项目生成知识图谱。后续 AI 助手在分析代码、文档或跨模块问题时，可以优先通过图谱结构导航，从而减少直接读取大量原始文件的情况。
4. 安装 Git 钩子
执行以下命令安装 Git 钩子：
$ graphify hook install
该命令会自动安装以下 Git Hook：
post-commit
post-checkout
安装后，当执行 git commit 或切换分支时，Graphify 会基于 AST 解析自动重建代码相关图谱。
5. Git 钩子的作用
Git 钩子主要用于保持代码图谱的实时性。
当项目代码发生提交或分支切换时，Graphify 会自动重新分析代码结构，并更新图谱中的代码部分。由于该过程基于 AST 解析完成，不依赖 LLM 推理，因此不会额外消耗 LLM Token。
6. 核心解决问题
6.1 降低 Token 消耗
在混合语料库场景下，如果 AI 每次都读取全部代码和文档，Token 消耗会非常高。Graphify 通过将原始资料压缩为结构化知识图谱，让 AI 优先读取图谱信息，从而显著减少上下文输入量。
在实际场景中，单次查询的 Token 消耗可降低约 71.5 倍。
6.2 理解复杂架构
传统代码检索通常只能回答代码做了什么，而 Graphify 更适合帮助 AI 理解代码之间的结构关系、模块依赖和架构决策。
它不仅关注代码功能本身，也帮助 AI 理解背后的设计逻辑，即从 What 扩展到 Why。
6.3 消除信息孤岛
复杂项目中的资料通常分散在多个位置，例如：
- 源代码
- 设计文档
- 会议记录
- 视频转录
- 研究论文
- 项目说明文档
Graphify 可以将这些分散信息整合成统一图谱，让 AI 在一个结构化视图中理解项目上下文。
6.4 本地优先与隐私保护
Graphify 的代码解析和语音转录流程可以在本地完成，减少敏感代码和原始资料外发的风险。
需要注意的是，文档和图像的语义提取可能会调用 AI 模型 API，因此对于包含敏感信息的资料，应提前做好脱敏处理。
7. 提升 AI 导航效率
Graphify 的核心价值不是替代搜索，而是让 AI 从“关键词匹配”转向“结构化导航”。
传统方式中，AI 可能会通过 grep 或全文搜索查找关键词；而在 Graphify 支持下，AI 可以基于图谱关系定位模块、依赖、文档和上下游逻辑，更适合处理跨模块、跨文件、跨资料源的复杂问题。
8. 常用命令汇总
# 全局安装 Graphify 技能
$ graphify install --platform opencode
# 在当前项目中安装 opencode 始终开启配置
$ graphify opencode install
# 在 opencode skill 中生成知识图谱
/graphify
# 安装 Git 钩子，自动维护代码图谱
$ graphify hook install
9. 使用建议
- 在大型项目或多资料源项目中优先启用 Graphify。
- 首次使用时先执行项目级配置，再生成知识图谱。
- 对频繁提交和切换分支的代码仓库，建议安装 Git 钩子。
- 对包含敏感信息的文档、图片和转录资料，应在语义提取前先做脱敏。
- 当 AI 分析复杂架构问题时，应优先引导其基于图谱结构导航，而不是直接全文搜索。