graphify的10种用法：快速理解大型遗留代码库的实战手册

graphify的10种用法快速理解大型遗留代码库的实战手册【免费下载链接】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变成一张可查询的知识图谱。对于接手遗留代码库的开发者它意味着不用再满屏 grep、翻文件——直接在 AI 编程助手里输入/graphify几秒钟就能拿到代码结构地图、核心模块排行和跨文件调用关系而且代码解析完全本地运行、不消耗 LLM 额度。用法一30秒安装 graphify最快配置方法graphify 是一个 CLI 工具官方 PyPI 包名为graphifyy双 y命令仍叫graphifyuv tool install graphifyy # 或 pipx install graphifyy graphify install # 把技能注册到你的 AI 助手它支持 20 种 AI 编程助手Claude Code、Cursor、Codex、Gemini CLI、Copilot 等一条命令选平台例如graphify install --platform codex。如果只想注册到当前仓库而不是用户目录加--project参数即可。用法二一键构建项目知识图谱在 AI 助手里运行/graphify .graphify 用 tree-sitter AST 本地解析代码确定性、无需大模型、代码不出本机覆盖约 36 种语言的语法文件。运行结束后你会得到graphify-out/目录下的三个文件graph.html—— 浏览器打开即可点击、筛选、搜索的交互式图谱GRAPH_REPORT.md—— 报告高亮核心概念、意外连接、建议提问graph.json—— 完整图谱随时可查询无需重新读源码不想看图只要报告时加--no-viz只索引代码跳过文档/图片、完全离线用--code-only。用法三打开交互式图谱直观看代码结构用浏览器打开graph.html每个节点是一个概念颜色代表聚类检测出的社区子系统整个图都可以点击。比如上图就是 graphify 对 FastAPI 代码库的映射——一眼就能看出哪些模块彼此纠缠、哪些是孤立孤岛。用法四用 God Nodes 定位遗留代码的核心枢纽报告中的God Nodes神节点列出连接数最多的概念——它们就是整个系统一切流量经过的地方。接手陌生遗留代码库时这是最快的切入点先读这些节点对应的类/函数架构主干立刻清晰。以官方实战案例worked/httpx/GRAPH_REPORT.md为例前几名是Client、AsyncClient、Response、Request——这正是理解该库最该先看的四个概念。用法五社区聚类看清子系统边界graphify 用 Leiden 算法把图谱切分成社区每个社区大致对应一个子系统认证、传输层、异常体系……且不依赖向量库。报告里还会给出意外连接Surprising Connections——跨模块的隐藏依赖往往正是遗留代码最容易埋雷的地方。想调整粒度可以只重跑聚类graphify cluster-only . --resolution 1.5得到更细的社区--exclude-hubs 99可把工具类超级枢纽从排名中排除。聚类实现见graphify/cluster.py。用法六自然语言查询代码库图谱建好后查询代替读文件graphify query what connects auth to the database?它会返回与问题相关的子图。在 AI 助手里则写成/graphify query 认证流程是怎么走到数据库的。配合graphify claude install等常开配置助手遇到代码问题会优先查图谱而不是逐个翻文件。用法七追踪任意两个概念之间的最短路径这是遗留代码库排查问题时的杀手锏graphify path UserService DatabasePool输出类似UserService --calls-- ... --references-- DatabasePool的逐跳路径让你立刻看懂两个看似无关的模块是怎么连起来的。用法八一步解释单个概念的全部关联graphify explain RateLimiter返回该概念的源码位置、所属社区、连接数以及每一条连接的去向。特别注意每条边都带置信标签EXTRACTED源码中明确存在或INFERRED由 graphify 解析推断你能分清哪些是读到的、哪些是推出来的。用法九增量更新让知识图谱常鲜代码在变图谱也要跟着变/graphify . --update—— 只重新提取有变化的文件graphify watch ./src—— 文件变动时自动同步graphify hook install—— 每次 git commit 后自动重建纯 AST无 API 成本还会配置 git 合并驱动让两个开发者同时提交时graph.json自动并集合并、永不出现冲突标记文档、PDF 变更后跑一次--update即可刷新对应节点重构删了大量文件后可加--force强制覆盖旧图。用法十团队协作共享同一张代码地图官方推荐的团队工作流一人运行/graphify .并把graphify-out/提交进仓库其他人 pull 下来助手就能直接读图谱再装 hook 让每次提交自动增量重建。更大的团队可以把图谱作为 MCP 服务共享python -m graphify.serve graphify-out/graph.json --transport http --port 8080团队成员的 IDE 指向同一个 URL 即可查询整库图谱无需每人本地装 graphify。进阶小贴士 导出 Wiki / 图谱文件/graphify . --wiki生成 Markdown 维基--obsidian生成 Obsidian 笔记库--svg、--graphml、--neo4j可导出到 Gephi 或 Neo4j 继续深挖私有化代码解析全程本地、无遥测文档/PDF 的语义提取才会调用你配置的模型后端可用--backend ollama做到完全本地推理原理与基准提取管线、置信度打分细节见docs/how-it-works.md官方实测每次查询 token 消耗比直接读原始文件少约 71.5 倍基准数据见BENCHMARKS.md过滤文件项目根目录放一个.graphifyignore语法同.gitignore自动生成代码不入库从满屏 grep到一问即答graphify 把大型遗留代码库变成了一张能问、能追、能看的关系网——先跑一次/graphify .剩下的交给上面这 10 种用法。【免费下载链接】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），仅供参考