graphify vs Sourcegraph:为什么代码理解需要知识图谱而不仅是搜索 📅 发布时间:2026/8/31 9:25:41 👁 浏览次数: graphify vs Sourcegraph为什么代码理解需要知识图谱而不仅是搜索【免费下载链接】graphifyTurn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.项目地址: https://gitcode.com/GitHub_Trending/graph/graphifygraphify是一个开源代码知识图谱工具它能把任意代码库连同文档、SQL 表结构、配置文件甚至 PDF 一起解析成一张可以查询的代码知识图谱让你问这两段代码是怎么连起来的而不是再翻几百个文件。作为 Claude Code、Cursor、Codex、Gemini CLI 等的/graphify技能它完全本地做 AST 解析不用向量库每条关系都会给出解释。搜索工具找得到代码但回答不了关系Sourcegraph、grep、IDE 全文搜索都是优秀工具它们的底层逻辑相同给你一个关键词还给你一批命中的文件和行号。这在这个函数定义在哪这类问题上够用但换个问题就不行了UserService和DatabasePool之间经过了哪几层调用 整个项目里哪些概念是所有代码都绕着它转的核心 认证模块改动后会波及哪些看似无关的子系统搜索只能返回位置无法返回结构。而理解代码本质上就是理解谁调用谁、谁依赖谁、谁解释谁——这是一张关系网的问题。graphify 的思路正是先用 tree-sitter 对约 36 种语言的代码做确定性 AST 解析本地运行、零 LLM、代码不出机器再对文档、PDF、图片做语义补全最终产出一张真正的图——节点是概念边是调用、导入、继承、引用等关系。整个过程和原理见 docs/how-it-works.md。一图看懂搜索 vs 代码知识图谱维度传统搜索grep / Sourcegraphgraphify 知识图谱输入关键词、正则自然语言问题输出命中的文件与行号子图、最短路径、概念解释关系理解❌ 无靠人脑拼凑✅ 每条边带EXTRACTED/INFERRED置信标签全局视角❌ 逐次搜索✅ God 节点核心概念、社区子系统一览存储方式索引真实图结构可遍历向量库部分方案需要不需要无嵌入、无向量库值得注意的一点graphify 里每条边都标注来源——EXTRACTED表示源码里明明白白写着的如 import、函数调用INFERRED表示工具推断出来的。这意味着你随时能分清读到的和猜到的而搜索工具从不告诉你命中是因为精确匹配还是模糊匹配。graphify 如何构建代码知识图谱构建过程分三步对新手很友好代码结构解析免费、本地tree-sitter 提取类、函数、导入、调用图SQL 文件还能确定性提取表、视图、外键和 JOIN 关系。纯代码仓库这一步之后就不需要任何 API Key。音视频转写本地本地 faster-whisper 转写且转写提示词会用当前图中最核心的概念做预热让转写更贴近你的领域。文档/PDF/图片语义提取需模型AI 并行读取文档输出节点与边的 JSON 片段并合并进同一张图。随后用 Leiden 算法做社区检测把图自动切成子系统再找出连接数最多的God 节点。细节含置信度评分规则都在 docs/how-it-works.md 里讲得很清楚。仓库里附带了可直接复现的示例worked/httpx/README.md 用 6 个文件模拟了一个 httpx 风格的库实际产出 144 个节点、330 条边、6 个社区报告就在 worked/httpx/GRAPH_REPORT.md——你能看到Client以 26 条边成为 God 节点以及DigestAuth和Response之间这条你可能不知道的跨文件关联。三个高频场景查询、路径、解释图建好后你不再读文件而是问图以下命令在终端或 AI 助手中均可用/graphify query auth 和数据库之间是怎么连通的 /graphify path UserService DatabasePool /graphify explain RateLimiterexplain给一个概念返回它的来源文件行号、所属社区、连接度和所有关系边如APIRouter有 47 条连接一眼看出它是路由中枢。path任意两个概念之间的最短路径逐跳展示比如FastAPI → DefaultPlaceholder → get_request_handler() → ModelField三跳直达。query把自然语言问题编译成一个作用域子图只给你相关的那部分而不是塞给你一整个代码库。配合 README.md 中的worked/示例如 worked/mixed-corpus/GRAPH_REPORT.md可以直观看到图谱对代码 论文 图片混合语料的效果相关数据与基准见 BENCHMARKS.md。快速上手2 条命令搭建你的代码知识图谱前置要求Python 3.10推荐搭配uv。uv tool install graphifyy # 安装 CLIpipx install graphifyy 亦可 graphify install # 把 /graphify 技能注册到你的 AI 助手然后在 AI 助手里输入/graphify .30 秒后你会得到三个文件graph.html—— 浏览器打开即可点击节点、按社区过滤、搜索就是文章开头那张图的交互版GRAPH_REPORT.md—— 核心概念、意外连接、建议提问的精华报告graph.json—— 完整图谱随时可查无需重读源文件。 PyPI 官方包名是graphifyy双 y命令仍是graphify注意别装错同名包。团队协作把图谱提交进仓库人人都能秒读项目graphify 建议把graphify-out/目录提交到 git一个人建图并提交其他人拉下来后其 AI 助手立刻就能基于图谱回答项目问题。再运行一次graphify hook install每次 git 提交后自动增量重建仅 AST 解析、零 API 费用并注册 git 合并驱动——两人并行提交时graph.json会自动做并集合并不会出现冲突标记。对新成员来说这是最大的福利入职第一天不需要读三周代码而是让助手对着图谱解释架构、定位核心概念、追踪调用链。总结搜索回答在哪图谱回答为什么找定义、找字面量搜索工具Sourcegraph、grep依然是最快的两者不冲突️理解架构、追踪依赖、评估改动影响把代码库变成知识图谱再提问效率是量级差异最省心的做法保留你的搜索习惯同时用 graphify 建一张图谱提交进仓库——搜索管定位图谱管理解。如果你正在接手一个陌生代码库或者想让 AI 助手真正读懂项目而不是逐文件瞎翻不妨按 README.md 的指引花两分钟建一个/graphify试试。【免费下载链接】graphifyTurn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.项目地址: https://gitcode.com/GitHub_Trending/graph/graphify创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考