如何用graphify阅读陌生开源项目6步法让AI替你导航【免费下载链接】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刚克隆下来一个陌生的开源项目面对成百上千个文件不知从何读起graphify是一款免费的开源代码知识图谱工具它在本地把整个代码库包括文档、SQL 结构、配置文件和 PDF解析成一张可查询的知识图谱让你在 AI 助手里用自然语言提问而不用再逐个文件翻代码。这篇教程用一个完整的 6 步法帮你在 10 分钟内让 AI 替你做项目导航。阅读陌生代码的三个痛点传统读代码方式graphify 知识图谱方式逐文件打开翻 1 小时还没找到入口一条命令生成可导航的项目地图靠 Grep 搜符号名、靠上下文猜关系自然语言提问返回精准的子图模块职责全靠脑子记社区检测自动划分子系统每条边都有依据graphify 与向量检索最大的不同它不是向量库而是一张真正可遍历的图——可以问问题、可以追踪两个概念之间的路径、可以解释单个概念且代码解析全程在本地完成不消耗 LLM 额度。第1步30秒安装graphify接入AI助手在终端执行两行命令即可完成 graphify 安装uv tool install graphifyy # 安装CLI注意包名是双y的graphifyy graphify install # 把/graphify技能注册到你的AI助手它支持 Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等 20 种 AI 助手。没有uv也可以用pipx install graphifyy替代。 安装后在终端敲graphify若提示找不到命令执行一次uv tool update-shell再打开新终端即可。第2步一条命令生成知识图谱进入目标开源项目目录打开你的 AI 助手输入/graphify .背后发生三件事代码结构tree-sitter AST 在本地确定性解析 36 种语言提取类、函数、导入、调用关系不花一分钱 LLM文档语义文档、PDF、图片等由你 IDE 会话中的模型做语义增强聚类分析用 Leiden 算法把图切成若干社区一个社区 ≈ 一个子系统。完成后项目里会多出graphify-out/目录里面有 3 个核心产出产出文件作用graph.html浏览器直接打开点节点、过滤、搜索GRAPH_REPORT.md高光报告核心概念、意外连接、推荐问题graph.json完整知识图谱随时查询、无需重读源码第3步打开graph.html一眼看懂开源项目全貌graphify 解析 FastAPI 代码库生成的知识图谱每个节点是一个概念颜色是自动检测出的社区子系统右侧是社区清单阅读建议先看度最高的节点God Nodes——所有逻辑都要流经它们它们就是这个项目的核心抽象。图中APIRouter96 条连接、HTTPException30 条就是 FastAPI 的枢纽再看社区的颜色区块快速建立项目分几块的宏观认知。第4步读GRAPH_REPORT.md找上帝节点和意外连接报告里有 4 个必读板块God Nodes——连接最多的概念项目骨架一目了然Surprising Connections——跨模块、跨文件里你猜不到的调用按意外程度排序The Why——# NOTE:/# WHY:注释、文档字符串、设计决策被抽成独立节点和代码挂钩Suggested Questions——4~5 个这张图最擅长回答的问题照着问就行。每条边还带置信度标签让你分清读到的和猜到的标签含义EXTRACTED源码中明确存在函数调用、导入置信度 1.0INFERREDgraphify 的合理推断附带 0.55~0.95 的置信分AMBIGUOUS不确定报告中单独列出供人工确认想亲手验证仓库里备有真实语料示例如 worked/httpx/GRAPH_REPORT.md6 个文件解析出 144 节点、330 条边、6 个社区。第5步用三个导航命令让AI替你查代码图建好后你就查询图而不是读文件了/graphify query 认证流程是怎么连到数据库的 /graphify path UserService DatabasePool /graphify explain RateLimiterquery自然语言提问返回一个范围内的子图附代码位置path追踪任意两个概念之间的最短路径比如FastAPI --uses-- DefaultPlaceholder --references-- ModelFieldexplain解释单个节点——出处、所属社区、所有连接。更划算的是首次建图花一次 token之后每次提问只读紧凑的图。官方在 52 个文件的混合语料上测得每次查询比直接读原始文件少 71.5 倍 token详见 docs/how-it-works.md。第6步保持图谱常新与团队共享地图graphify hook install # 每次git提交后自动重建图仅AST零API成本 /graphify . --update # 只重新提取发生变化的文件团队玩法把graphify-out/提交进 git一个人建图、全队 clone 即得地图hook 还配置了 git 合并驱动两人同时提交时graph.json自动合并、永不冲突。生成代码、依赖目录不想入图就建一个.graphifyignore语法同.gitignore排除。上手小贴士纯代码项目加--code-only完全离线、零 API key不止是代码SQL 表与外键、Terraform、MCP 配置、PDF、图片、视频都能进同一张图想深挖原理阅读 docs/how-it-works.md 了解提取管线或 ARCHITECTURE.md 了解模块结构。总结用 graphify 阅读陌生开源项目的 6 步① 安装并注册技能 → ②/graphify .一键建图 → ③ 打开graph.html看全局 → ④ 读GRAPH_REPORT.md找核心节点与意外连接 → ⑤ 用query/path/explain让 AI 导航 → ⑥ hook 自动更新并共享给团队。从此告别CtrlF 式读代码——先建图再提问最后才读源码。【免费下载链接】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），仅供参考