快速结论
Graphify 是 Graphify Labs 维护的开源代码知识图谱工具,官方产品名仍是 Graphify,准确官网是 graphify.com,源码仓库是 Graphify-Labs/graphify,PyPI 包名则是容易写错的 graphifyy。它不是一款新的 AI 编辑器,也不是托管式向量数据库,而是安装到现有 AI 编码助手旁边的本地上下文层:先把函数、类、导入和调用关系整理成图,再让助手按关系查询代码,而不是每轮都从全文搜索开始。
它最值得关注的地方不是“知识图谱”这个标签,而是证据边界清楚。代码关系由 Tree-sitter 在本机解析,标记为 EXTRACTED;文档、PDF、SQL 等非代码关系可由用户配置的模型推断,标记为 INFERRED;无法完全确定的关系标记为 AMBIGUOUS。如果你经常让 Claude Code、Cursor 或 GitHub Copilot 理解大型仓库,Graphify 值得测试。若项目很小、内置搜索已经够用,额外维护一张图未必划算。
核心功能
- 本地 AST 建图:官方文档称可用 Tree-sitter 解析 36 种代码语言,提取文件、函数、类、方法、导入与调用关系;同一份代码可得到确定性结果,不需要模型参与代码解析。
- 可追溯查询:
graphify query、graphify path和graphify explain用图遍历回答模块连接、依赖路径和变更影响问题,并返回文件与行号线索。 - 渐进式工作流:在助手中运行
/graphify .首次构建,之后可用--update更新;结果保存在graphify-out/下的graph.json、graph.html和GRAPH_REPORT.md。 - 非代码语义连接:文档、PDF、SQL schema、PostgreSQL 与 Terraform 可交给已配置的 Claude、OpenAI、Gemini、DeepSeek、Kimi、Bedrock、Azure 或本地 Ollama 后端处理。
- MCP 与 CLI:同一张图既可由命令行查询,也可通过 stdio 或 HTTP MCP server 暴露查询、邻居、最短路径、社区、关键节点和 PR 影响等工具。
- 多助手接入:官方列出 17 个 AI 编码助手集成,包括 Claude Code、Cursor、Codex、Gemini CLI、Aider、GitHub Copilot 和 OpenCode。
适合人群
- 维护中大型代码库的开发者:需要跨文件追踪调用链、依赖方向和改动影响,而不只是搜索同名文本。
- 频繁切换 AI 助手的人:希望把可复用的代码关系图放在助手之外,减少每个客户端重复建立上下文。
- 平台与架构团队:需要审查关键节点、模块社区、循环依赖或 PR 影响,并希望查询结果能够回到具体文件和行号。
- 隐私要求较高的个人和团队:愿意本地安装 Python 工具,并明确区分本地 AST 解析与可选的外部模型调用。
- 不太适合的人群:只处理小型单文件项目、希望开箱即用的图形化 IDE,或不愿维护本地工具链与生成目录的用户。
使用场景
接手陌生仓库时,可以先生成图,再查询“认证模块如何连接数据库”或某个服务的上游调用者,减少反复打开文件的成本。准备重构时,path、邻居和影响分析更适合确认调用方向与潜在波及范围;查看 PR 时,则可把改动映射回已有关系,辅助发现跨模块冲突。
Graphify 也适合代码、设计文档和数据库结构混合的项目,但这里要注意证据等级:AST 提取的调用关系与模型推断的文档关联不是同一种事实。团队流程应保留这些标签,并回到源码、测试和数据库定义复核,不能因为结果以“图路径”展示就跳过代码审查。
价格与版本
截至 2026-07-21,官方价格页将 Graphify 核心工具标为免费、MIT 开源、无需账号、无使用上限、无需银行卡,所以本站按“免费”收录,而不是“免费增值”。安装入口是 uv tool install graphifyy,也可使用 pipx 或 pip;不要误装其他同名或近似名称的 PyPI 包。
Graphify Labs 另有企业版早期访问计划,公开能力包括 merge gate 验证、图感知代码审查、工程摘要以及在客户 VPC 内自托管,但官方没有公布价格。企业采购不能把核心开源版的“免费”推导为企业功能免费,应向厂商确认报价、支持范围、部署责任与合规材料。
国内访问与使用体验
Graphify 的核心运行形态是本地 CLI,不要求创建 Graphify 账号,图文件也保存在本机;安装完成后,代码 AST 解析本身不依赖托管服务。实际获取安装包、访问 GitHub、调用外部模型以及连接 AI 编码助手时,仍受各自服务可用性影响,因此 needsVPN: false 只表示 Graphify 不是必须在线使用的海外 SaaS,不代表所有第三方模型都能稳定访问。
首次使用应从一个边界清楚的仓库开始,检查 graph.html、报告和查询引用是否与源码一致,再决定是否把 graphify-out/ 纳入团队流程。大型仓库的首次扫描、非代码语义推断和深度模式都会增加时间与模型成本;更新图之前也应明确忽略生成目录、依赖缓存和敏感文件。
优点
- 代码解析在本地完成,确定性 AST 关系不需要上传代码或调用模型。
EXTRACTED、INFERRED、AMBIGUOUS三类标签让事实、推断和歧义不会混在一起。- CLI、MCP 和 17 个助手集成让同一张图可以跨开发工具使用。
- 输出是本地可检查文件,不依赖厂商托管的私有索引。
- MIT 许可证允许使用、修改、分发和商业使用,仓库在截止日仍有高频提交与正式发布。
不足
- 需要 Python 工具链,团队还要管理安装版本、忽略规则和图更新时机。
- 文档、PDF、数据库等非代码内容仍可能经过所选模型后端;选择云模型时,数据边界由该模型服务的条款决定。
- 动态调用、反射和运行时依赖不可能仅靠静态分析完全还原,
AMBIGUOUS结果必须人工确认。 - 对小仓库或简单问答,编辑器已有搜索与索引可能更直接,建图会增加步骤和磁盘产物。
- 企业版仍处早期访问且没有公开价格;官方仅称 SOC 2 Type II 正在推进,不能视为已经取得认证。
替代品对比
| 工具 | 产品形态 | 更适合谁 | 主要取舍 |
|---|---|---|---|
| Graphify | 本地代码知识图谱与 MCP/CLI | 已有 AI 助手、需要关系查询的人 | 不替代编辑器,需自行构建和更新图 |
| Claude Code | 终端 AI 编码助手 | 偏好命令行任务执行与代理工作流的人 | 能直接修改代码,但模型与订阅成本另计 |
| Cursor | AI 原生编辑器 | 希望在 IDE 内完成索引、编辑和对话的人 | 使用顺手,但需要迁移或适应编辑器工作流 |
| GitHub Copilot | IDE 与 GitHub 编码助手 | 重视企业集成和广泛 IDE 支持的团队 | 平台成熟,但不是独立、开放的本地图谱层 |
Graphify 可以与这三款工具配合,而不只是替代关系。选择时先问自己缺的是“能执行编码任务的助手”,还是“能跨会话保存并查询代码关系的结构层”;前者优先选编码助手,后者才是 Graphify 的核心价值。
常见问题 FAQ
Graphify 现在的准确官网和仓库是什么?
准确官网是 https://graphify.com/,源码仓库是 https://github.com/Graphify-Labs/graphify。旧域名 graphifylabs.ai 已明确指向新官网,产品名和本站 slug 仍是 Graphify,因此不需要新建另一个产品条目。
Graphify 免费吗?
核心 CLI 和知识图谱工具免费、无账号、无公开使用上限,并采用 MIT 许可证。企业早期访问功能没有公开价格,需要单独联系 Graphify Labs。
Graphify 会上传我的代码吗?
代码的 Tree-sitter AST 解析、图文件和核心查询在本机完成,官方声明无遥测。若启用非代码语义推断,相关内容会由你配置的模型后端处理;选本地 Ollama 可保持本地,选云模型则应审查该供应商的数据政策。
Graphify 是否需要 API Key?
只建立代码 AST 图不需要 Graphify 账号或模型 API Key。处理文档、PDF、SQL 等语义关系时,云模型通常需要对应凭据,本地 Ollama 则不需要云端 API Key。
Graphify 和 RAG 或向量数据库有什么区别?
Graphify 的代码核心依赖 AST 节点和有类型的关系边,查询时沿调用、导入和引用关系遍历;传统 RAG 常按文本相似度检索片段。两者可以组合,但图路径更适合回答依赖和影响范围,相似度检索更适合寻找语义接近的文本。
Graphify 能替代 Cursor、Claude Code 或 GitHub Copilot 吗?
不能完整替代。Graphify 提供结构化代码上下文和查询工具,不负责成为完整编辑器或通用编码代理;它更常作为这些助手的补充层使用。
Graphify 的许可证和安全认证是什么状态?
公开仓库根目录的许可证是 MIT,版权声明为 2026 Safi Shamsi。官方安全页截至本页更新时间只声明企业方向的 SOC 2 Type II “进行中”,不是已完成认证;企业使用还应独立评估依赖、模型后端、部署和支持条款。
总结
Graphify 应当保留为 graphify:产品身份没有变化,变化的是官方域名从 graphifylabs.ai 收敛到 graphify.com,仓库也已归入 Graphify Labs 组织。截止 2026-07-21,项目当天仍发布 v0.9.23 并持续合入修复,活跃度足以排除归档判断。
它适合已经拥有 AI 编码助手、但仍缺少可持久查询代码关系的开发者。先用免费 MIT 版本对一个真实仓库建图,检查引用、更新速度和模型数据路径;只有当图查询确实减少重复搜索并提升变更判断质量时,再把它纳入团队标准流程。