
5分钟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/graphifygraphify 是一款开源的代码知识图谱工具在 AI 编程助手里输入一条/graphify命令它就能把整个项目——代码、文档、SQL 表结构、配置文件甚至 PDF——映射成一张可查询的知识图谱替代翻文件和 grep。本文带你用仓库自带的超小示例项目跑一遍完整流程逐步拆解第一次运行/graphify时背后发生了什么。为什么是图谱而不是向量检索graphify 的设计很克制代码部分完全用本地 tree-sitter 做确定性 AST 解析不经过任何大模型数据不出你的电脑也不依赖向量数据库而是构建一张真实的、可以遍历的图。每条边还会打上EXTRACTED源码中直接存在或INFERRED工具推断得出的置信度标签读图时你能分清哪些是读出来的哪些是猜出来的。30秒安装 graphify两步完成打开终端执行两条命令uv tool install graphifyy # 或 pipx install graphifyy graphify install # 把 /graphify 技能注册到你的 AI 助手⚠️ 注意PyPI 上的包名是graphifyy双 y而命令行工具叫graphify单 y。支持 20 个 AI 助手Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等用--platform参数指定例如graphify install --platform codex。第一个项目上运行 /graphify 发生了什么打开你装好的 AI 助手在示例目录如worked/example里输入/graphify .随后 graphify 按**三遍three passes**处理文件Pass 1 — 代码结构免费无 API 调用tree-sitter 解析代码文件抽取类、函数、导入、调用关系和内联注释支持约 40 种语言SQL 文件还会被确定性地解析出表、视图、外键和 JOIN 关系。如果语料里只有代码文件后面语义提取直接跳过token 成本为 0。Pass 2 — 音视频本地用 faster-whisper 本地转写结果自动缓存重跑会跳过已处理文件。Pass 3 — 文档/论文/图片会消耗 token并行子代理读取 Markdown、PDF、图片输出节点与边的 JSON 片段再合并进同一张图。每份文件都会做 SHA256 内容指纹缓存存放在graphify-out/cache/第二次运行时没改动的文件会直接跳过。你会得到什么graphify-out 目录下的三个文件文件作用graph.html交互式知识图谱浏览器打开即可点击节点、按社区筛选、搜索GRAPH_REPORT.md高光报告核心概念、惊人连接、社区划分、建议问题graph.json完整图数据NetworkX 节点-边格式随时查询无需重读源码graphify 把 FastAPI 代码库映射成的交互式知识图谱右侧图例是按 Leiden 算法检测出的社区子系统怎么读第一份图谱报告以 6 文件示例为例仓库里有一个合成示例项目worked/httpx/6 个 Python 文件实际输出是144 个节点、330 条边、6 个社区提取占比 53% EXTRACTED / 47% INFERREDtoken 成本为 0。报告worked/httpx/GRAPH_REPORT.md里有几块特别值得看God Nodes枢纽节点连接数最多的核心抽象。示例中前几名是Client26 条边、AsyncClient、Response——一眼看出整个架构围绕哪些概念运转。Surprising Connections意外连接比如Timeout --uses-- BaseTransport这种你没想到会连上的跨文件关系每条都标注了来源文件和置信度。Suggested Questions图会自动建议值得追问的问题例如为什么Client同时连接 4 个社区它是跨社区桥梁节点。对于小项目图的价值在于结构清晰度依赖关系、枢纽模块、文档与代码的对应关系一屏看全。建好图之后用三个命令代替 grep图建好后日常提问直接对着graph.json走graphify query 问题用自然语言提问返回一个范围受控的子图graphify path FastAPI ModelField追踪任意两个概念之间的最短路径示例中为 3 跳graphify explain APIRouter解释一个概念——来源文件行号、所属社区、连接数、全部连边官方 README 中演示的输出FastAPI --uses-- DefaultPlaceholder --references-- get_request_handler() --references-- ModelField每一步都有据可查。新手常见坑一次说清现象原因与解决装完提示graphify: command not found~/.local/bin不在 PATH执行uv tool update-shell后重开终端安装时找不到包包名是graphifyy双 y命令才是graphifyPowerShell 里/graphify .报错斜杠是路径分隔符请用graphify .担心代码上传云端代码解析纯本地完成只有文档/图片的语义 Pass 3 才需要模型且仅在你配置后端时才发生下一步挑个示例项目亲手跑一遍想立刻验证效果可以克隆仓库里面有可直接复现的示例git clone https://gitcode.com/GitHub_Trending/graph/graphify推荐先试worked/example/7 个文件、两种语言的迷你文档管线含 architecture.md 风格的架构说明跑完后向 AI 助手提问什么直接调用了 storageparser 和 processor 之间的最短路径是什么。完整工作原理、社区检测算法和图格式说明见文档 docs/how-it-works.mddocs/how-it-works.md。小结5 分钟你完成了安装 CLIgraphifyy、注册技能graphify install、运行/graphify .并收获了三个文件可点选的graph.html、有洞察的GRAPH_REPORT.md、可随时查询的graph.json。代码建图免费、本地、确定性强每条边都解释得清——把 grep 换成图查询这就是 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),仅供参考