Deepseek ArtifactsDeepseek Artifacts
第三方 · Apache-2.0 · Python

Graphify:给 Claude Code 用的代码库知识图谱

Graphify 把整个仓库——代码、文档、SQL schema、配置和 PDF——变成一张可直接查询的知识图谱。tree-sitter 本地解析,每条边都带标注,不是向量库。

一句话看懂 Graphify

  • 它是第三方开源项目(Graphify-Labs/graphify,Apache-2.0,Python 编写),不是 Anthropic 官方产品。它提供一个 `/graphify` skill,供 Claude Code、Cursor、Codex、Gemini CLI 等助手使用。
  • 代码用 tree-sitter 解析成 AST,全程本地、确定性,不调模型。每条边都标成 `EXTRACTED`(源码里写明)或 `INFERRED`(由 Graphify 推断)。
  • 它是可以遍历的图,不是向量索引:没有 embedding,也没有向量库。`/graphify query` 只返回回答所需的节点和边。
  • 三条命令上手:`uv tool install graphifyy`、`graphify install`,然后在仓库里 `/graphify .`。产物落在 `graphify-out/`。

Graphify-Labs/graphify — repository and README

来源github.com2026-11-15

打开

Graphify Quickstart

来源docs.graphify.com2026-11-15

打开

GitHub REST API — repos/Graphify-Labs/graphify

来源api.github.com2026-11-15

打开

本页的命令、参数与文件名均来自上面三个来源,读取时间为 2026-11-15。命令与路径故意不翻译——翻译过的命令是跑不起来的。

核查日期 2026-11-15。仓库默认分支为 v8,最后一次 push 是 2026-11-14;star 与 fork 数每天都在变,引用前请重新读一次 API。

Graphify 到底是什么

项目自己的描述:把任意代码库连同它的文档、SQL schema、配置和 PDF,转成一张可查询的知识图谱——为 Claude Code、Cursor、Codex 和 Gemini CLI 提供的 `/graphify` skill,本地确定性 AST 解析,每条边都有解释,且不含向量库。

实际用过一遍是这样的:先装一个 CLI(`graphify`)和一个 skill,然后在助手里输入 `/graphify`。助手完成 detection、extraction、clustering,把图写进 `graphify-out/`,之后答题靠遍历这张图,而不是 grep 整个目录树。

许可证
Apache-2.0
语言
Python(包名 graphifyy)
star / fork
147,983 / 14,194 —— 2026-11-15 快照
状态
第三方;默认分支 v8;最近 push 2026-11-14

不是 Anthropic 官方项目

Graphify 由 Graphify-Labs 组织以 Apache-2.0 发布(GitHub API 显示 is_verified: false)。Anthropic 不维护它,Claude Code 也不自带它:需要你自己安装,它跑在你自己的文件上。

图是怎么建出来的

代码先用 tree-sitter 解析成 AST。这一步是确定性的、在你机器上跑:不调 LLM,也不往外传任何东西。跨文件关系(calls、imports、inherits、mixes_in)由 AST 得出,覆盖约 40 种语言;`# NOTE:` / `# WHY:` 注释以及 ADR、RFC 引用同样会变成节点。

文档、PDF、图片和视频会走第二遍语义处理,用的是你助手的模型,或你配置的 API key。消耗 token 的是这一段,代码图本身不消耗。

每条边都有解释

每条连接都带标记:源码里写明的关系标 `EXTRACTED`,由 Graphify 解析出来的标 `INFERRED`。你能分清哪些是从代码里读到的,哪些是推出来的。

不是向量索引

没有 embedding,也没有向量库。产物是一张真正的图——节点、边、社区、god node——用 `query`、`path`、`explain` 去遍历它。

给 Claude Code 安装 Graphify

三条命令。`graphify install` 默认目标就是 Claude Code,换别的助手只差一个参数。

安装 CLI

包名是 `graphifyy`——两个 y。它装出 `graphify` 和 `graphify-mcp` 两个命令。需要 Python 3.10 或更高版本,三个包管理器任选其一。

# Python 3.10 or lateruv tool install graphifyy# or: pipx install graphifyy# or: pip install graphifyy

注意拼写:要装的是 `graphifyy`,敲的是 `graphify` 和 `graphify-mcp`。

注册 skill

不带参数时 `graphify install` 针对 Claude Code:把 skill 复制到 `~/.claude/skills/graphify/SKILL.md`,并注册进 `~/.claude/CLAUDE.md`。换其它助手就加 `--platform`。

graphify install# Claude Code (default): ~/.claude/skills/graphify/SKILL.md# registered in ~/.claude/CLAUDE.md# another assistant: graphify install --platform codex

例如 `graphify install --platform codex`。如果之后 `/graphify` 仍不被识别,重启助手,或确认 `~/.claude/skills/graphify/SKILL.md` 是否存在。

在仓库里运行

在助手里打开仓库,运行 `/graphify .`。agent 会做 detect、extract、cluster,然后汇总报告;代码在本地解析,文档与论文走 agent 自己的模型。

/graphify .

接着提问:`/graphify query "how does authentication reach the database"` 只返回回答所需的节点与边,并按 token 预算裁剪。

开始之前

  • 1Python 3.10 或更高版本。
  • 2uv、pipx 或 pip——用你平时装 CLI 的那个就行。
  • 3一个 `graphify install` 支持的编码助手(默认 Claude Code),以及一个要索引的仓库——本地路径,或给 `/graphify <url>` 用的公开 GitHub 地址。

真正会用到的命令

以上命令照抄文档的 quickstart 与命令表。以 `/` 开头的是在助手里输入,其余在 shell 里跑。

命令作用
/graphify query "…"提一个问题;只返回回答所需的节点和边,并裁剪到 token 预算内。
/graphify path "AuthModule" "Database"显示两个节点之间的最短路径——这里是 AuthModule 到 Database。
/graphify explain "SessionStore"解释单个节点:它是什么、连着什么、为什么这么连。
/graphify . --update在已有图上增量刷新,不必从头重建。
/graphify . --mode deep走更深的抽取模式——更慢,但解析出的关系更多。
/graphify . --wiki额外生成一份 wiki 风格的图谱说明。
/graphify https://github.com/<owner>/<repo>直接指向一个公开仓库 URL,而不是本地路径。
graphify hook install装 git hooks(post-commit、post-checkout、post-merge、post-rewrite,外加 merge driver),让图跟着仓库走;`graphify hook status` 应把四项都列为 installed。
graphify god-nodes --top 5打印连接最多的节点——快速确认图已生成、结构正常。
graphify extract . --code-only只跑代码抽取,跳过文档与多媒体的 LLM 步骤。
graphify uninstall卸载 skill 及其注册项。

如果命令找不到图,就到含 `graphify-out/` 的目录里运行,或显式传 `--graph graphify-out/graph.json`。

graphify-out/ 里有什么

文档给出的目录结构,原文照抄:

graphify-out/├── graph.json├── graph.html├── GRAPH_REPORT.md├── manifest.json└── cache/
  • 1`graph.json`——完整的图,别的工具要读数据就读它。
  • 2`graph.html`——浏览器视图:点节点、筛选、搜索。
  • 3`GRAPH_REPORT.md`——要点、意外发现的连接,以及建议提问的问题。
  • 4`manifest.json`——记录这次索引了哪些内容的清单。
  • 5`cache/`——本地工作数据,建议加进 `.gitignore` 而不要提交。

该提交哪些

文档建议提交 `graph.json` 与 `GRAPH_REPORT.md`,并把 `cache/` 写进 `.gitignore`。README 的简版说你会得到“三个文件”(`graph.html`、`GRAPH_REPORT.md`、`graph.json`),quickstart 则列出五项。两者说的是同一个目录,只是详略不同。

持久化的图里还会记录 `graph.schema_version` 与 `graph.graphify_version`。升级 CLI 后要检查这两项:旧版图可能需要重建。

让图保持新鲜

图的 freshness 只等于上一次构建,所以要接进 git:

graphify hook installgraphify hook status# → 4 hooks installed, merge driver: registered

`graphify hook install` 会接上 post-commit、post-checkout、post-merge、post-rewrite 四个钩子以及 merge driver。之后 `graphify hook status` 应显示四个钩子 installed,并显示 “merge driver: registered”。

文档或图片变了,就重跑 `/graphify . --update`,不必整图重建。

什么场景合适,它不做什么

Graphify 是代码地图工具。当“仓库的形状”比“某个文件的原文”更重要时,它才值得装。

适合的场景

  • 1接手陌生代码库,想在看文件之前先看清模块、god node 和社区结构。
  • 2问题本身是关系问题——这个怎么走到那个、谁调用了它——这类问题 grep 答不好。
  • 3你希望把地图提交进仓库,让团队或 agent 反复读取,而不用每次重付构建成本。

需要知道的限制

  • 1免费且完全本地的部分只覆盖代码。文档、PDF、图片和视频的语义处理要走模型,这部分要么耗 token,要么需要 API key。
  • 2`INFERRED` 边是 Graphify 的解析结果,不是源码里的事实。信任某条连接之前先看标记。
  • 3图是快照。不装 hooks 也不用 `--update`,它就会像 README 一样过期。
  • 4它是个年轻的第三方项目:它的价值论证来自自己的 README,而不是独立评测。

项目在 README 里给出自己的 benchmark 表——例如 n=300 时 LOCOMO recall@10 为 0.497。那是维护者自己的测量,不是独立结论,请当作一条待验证的说法,在自己的仓库上复核。

DeepSeek Harness 侧的 Graphify

DeepSeek Harness 的插件目录里还有一个第三方的原生插件。它属于社区作品,与 Graphify-Labs 仓库没有隶属关系。

查看插件详情

Graphify 常见问题

接着看