企业官网建设流程全解析

如何在Cursor、Codex、Gemini CLI上安装graphify：20+个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 是一款开源的本地代码知识图谱工具：在 AI 编程助手里输入/graphify，它就能把代码、文档、SQL 配置和 PDF 解析成可查询的 knowledge graph，之后用自然语言提问，替代反复 grep 翻文件。代码部分完全走本地 tree-sitter AST 解析，免费、无向量库、不消耗 LLM 额度。本文以 Cursor、Codex、Gemini CLI 三个主流平台为例，带你在 20+ 个 AI 助手上完成 graphify 一键配置，全程只需几条命令。

为什么需要 graphify 知识图谱

运行一次后会产出三个文件：graph.html（浏览器里点节点、筛社区）、GRAPH_REPORT.md（架构亮点报告）、graph.json（完整图谱，可随时查询）。工作机制详见 docs/how-it-works.md。

graphify 把 FastAPI 代码库映射成的交互式图谱：每个节点是一个概念，颜色代表自动检测出的社区，整张图都可以在浏览器里点击查询。

安装前准备：30 秒确认环境

macOS 可一键装齐：brew install python@3.12 uv；Windows 用winget install astral-sh.uv。安装器逻辑位于 graphify/install.py，CLI 入口在 graphify/cli.py。

⚠️ 注意：PyPI 上的官方包名是graphifyy（双 y），其他graphify*包均非官方；命令行仍然是graphify。

三步完成 graphify 安装

第 1 步：安装命令行工具（推荐 uv 隔离环境，避免 PATH 与环境冲突）：

uv tool install graphifyy # 推荐 # 备选： pipx install graphifyy pip install graphifyy # 可能需要自行配置 PATH

第 2 步：把技能注册给你的 AI 助手（默认注册 Claude Code）：

graphify install

第 3 步：在助手里输入/graphify .，等待生成图谱即可。

Cursor 安装步骤

graphify cursor install

一条命令完成两件事：

1. 注册/graphify技能到 Cursor；
2. 写入.cursor/rules/graphify.mdc并设置alwaysApply: true，Cursor 会在每次对话中自动带上"优先查图谱"的规则，无需额外 hook。

配置完成后，在 Cursor 对话框输入/graphify .即可开始建图。

Codex 安装步骤

graphify install --platform codex

Codex 有两个专属注意点：

• 并行抽取：需要在~/.codex/config.toml的[features]下开启multi_agent = true，否则子代理并行建图不可用；
• 调用语法：Codex 用$graphify .而不是/graphify .（$是 Codex 的技能调用符）。

Gemini CLI 安装步骤

graphify install --platform gemini

Gemini CLI 属于 hook 平台：安装时会注册PreToolUsehook，当助手准备用搜索类工具翻文件时自动触发，引导它改走graphify query "<问题>"的图谱路径。

20+ 个 AI 助手平台一键配置清单

同一个 graphify，换平台只需换一条命令（完整列表见 README.md 的 Install 章节）：

💡 想只装到当前仓库（供团队共享）而不是个人配置目录，加--project：

graphify install --project --platform codex

让 AI 助手始终优先查图谱

建好图后，再执行一次同名安装命令即可写入"always-on"配置，让助手回答架构类问题时优先跑graphify query "<问题>"，而不是逐文件读源码：

• Hook 平台（Claude Code、Gemini CLI）：注册PreToolUsehook，搜索/读文件前自动提醒走图谱；
• 指令文件平台（Codex、Cursor 等）：写入AGENTS.md、.cursor/rules/等持久化规则文件。

安装后如何验证

/graphify . # Codex 用 $graphify . graphify explain "APIRouter" # 解释一个概念的所有连接 graphify path "FastAPI" "ModelField" # 追踪两节点最短路径

看到graphify-out/目录下生成graph.html、GRAPH_REPORT.md、graph.json三个文件，即安装成功。

常见问题（FAQ）

Q1：提示graphify: command not found？uv/pipx把命令放在~/.local/bin，新装后未加入 PATH。运行uv tool update-shell（或pipx ensurepath）后重开终端即可。

Q2：Mac/Windows 上ModuleNotFoundError: No module named 'graphify'？尽量别用裸pip install——技能会在运行时从graphify-out/.graphify_python解析 Python 环境，和 pip 装的环境不一致就会报错。用uv tool install或pipx install隔离环境最省心。

Q3：PowerShell 里/graphify .不生效？PowerShell 中前导/是路径分隔符，请改用graphify .。

Q4：升级 graphify 后 hook 失效？graphify hook install会把当时的解释器路径写进 hook 脚本，重装/升级后重跑一次即可刷新。

Q5：想彻底移除？

graphify uninstall --purge # 从所有平台移除，并删除 graphify-out/

按平台移除可用graphify cursor uninstall、graphify codex uninstall等命令。

小结

graphify 的安装路径非常统一：装 CLI（graphifyy双 y）→ 按平台执行一条 install 命令 → 助手里输入/graphify .。Cursor 写.cursor/rules/规则、Codex 开multi_agent、Gemini CLI 挂 PreToolUse hook——差异都被封装在一条命令里。本地 AST 解析不花一分钱，每条边带置信标签，比向量检索更可控。装完之后，你的 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