Graphify 入门：把代码仓库建成知识图谱，用命令和 MCP 代替 grep

开源代码知识图谱，本地建图、查调用、接 MCP

入门3 课时60 分钟图文实操

免费学习无需登录

开始学习查看课程目录

你将学会

用 uv 装好 graphifyy
不用 API Key 给仓库建代码图谱
看懂 graphify-out 各文件用途
用 god-nodes 找核心符号
用 explain 和 path 追调用关系
处理同名符号与退出码 3、4
用 query 和 affected 取上下文、看影响
用 update 和 Git 钩子保持图谱新鲜
用 graphify-mcp 把图谱交给智能体

适合谁

在大仓库里让编程助手反复读代码的开发者
想给 Claude Code、Codex 加代码结构记忆的工程师
要在脚本或 CI 里分析调用关系的团队

课前准备

会用 Linux 或 macOS 终端和 Git
Python 3.10 以上或已装 uv
第 3 课 MCP 演示需要 curl

课程目录

3 课时 · 60 分钟

01安装 Graphify，给仓库建出第一张代码图谱用 uv 装好 graphifyy 0.9.108，用 --code-only 在本机 3 秒给 click 仓库建出 2080 个节点的图谱，不调用模型；再生成报告和可视化页面，看懂 graphify-out 里每个文件的用途。图文15 分钟开始本课
02查图谱：god-nodes、explain、path、query、affected用 god-nodes 找核心类，用 explain 看符号的位置和连接，用 path 追两个符号的最短路径；处理同名符号的歧义和退出码 3、4，再用 query 取预算内的子图、用 affected 估算改动影响。图文25 分钟开始本课
03保持图谱新鲜，并用 MCP 交给编程助手改代码后用 graphify update 增量更新，装 Git 钩子并看清它不刷新提交号的情况；用 codex install 写好智能体规则，再启动 graphify-mcp，用 curl 验证 API Key 并调用 graph_stats 和 shortest_path。图文20 分钟开始本课

课程说明

Graphify 是 Graphify Labs（YC S26）以 Apache-2.0 开源的代码知识图谱工具，PyPI 包名是 graphifyy，命令是 graphify。它用 tree-sitter 在本机解析代码，把函数、类、文件和它们之间的调用、导入、继承关系存成一张 graph.json。之后你和编程助手都可以直接查这张图，回答「谁调用了它」「两个符号怎么连起来」，不用再逐个文件 grep。

本课按 Graphify 官方文档的 CLI quickstart、Querying、Keep the graph fresh 和 MCP server quickstart 整理，全部在 2026-11-15 用 graphifyy 0.9.108 实跑。测试机是一台 8 核、无显卡的 Debian 13 云主机，Python 3.13，示例仓库是 pallets/click 的 8.2.1 版。整课只用 --code-only 建代码图，不调用任何模型，不需要 API Key。对照结果都是这台机器的真实输出，你的节点数会随仓库不同而不同。没有实测的部分会在正文里写明：文档和图片的语义抽取、托管的 Graphify Cloud，以及 macOS 和 Windows。

你会学到

用 uv 装好 graphifyy，给一个真实仓库建出代码图谱，看懂 graphify-out 里的每个文件
用 god-nodes、explain、path、query、affected 五个命令回答不同类型的问题
处理同名符号的歧义，以及退出码 3 和 4 的含义
用 graphify update 和 Git 钩子让图谱跟上代码，知道钩子什么时候不会刷新
用 graphify codex install 写好智能体规则，用 graphify-mcp 把图谱以 MCP 工具提供出去

适合

在大仓库里经常让编程助手「先读一遍代码」的开发者
想给 Claude Code、Codex、Cursor 加一层代码结构记忆的工程师
需要在脚本或 CI 里分析调用关系和改动影响的团队

先修

会用 Linux 或 macOS 终端和 Git
本机有 Python 3.10 以上，或者装好 uv
第 3 课的 MCP 演示需要 curl；接入编程助手需要你已经装好对应的客户端