graphify 是什么?

Graphify 是一个 AI 编码助手技能:在你的助手里输入 /graphify,它就把整个项目——代码、SQL schema、R/shell 脚本、文档、论文、图片、视频——映射成一个可查询的知识图谱,让你用「查图」代替「grep 翻文件」。它把应用代码 + 数据库结构 + 基础设施收进同一张图,产出三个文件:graph.html(浏览器里点节点/筛选/搜索)、GRAPH_REPORT.md(关键概念、意外关联、建议提问)、graph.json(完整图,随时查询而无需重读文件)。支持 Claude Code、Codex、OpenCode、Cursor、Gemini CLI、Copilot、OpenClaw、Hermes、Pi、Antigravity 等众多助手。Python 实现、MIT 开源、YC S26、约 5.2 万星,PyPI 包名为 graphifyy(双 y)。

⭐ 54,622 Stars 🍴 5,769 Forks Python 作者: safishamsi
来源:README 顶部简介/Install、GitHub meta(safishamsi/graphify,Python,MIT,homepage graphifylabs.ai) 查看 GitHub 仓库 →

为什么值得关注

AI 编码助手在大型/异构项目里靠反复 grep 与读文件理解代码,效率低、易漏关联。Graphify 把整个项目(不止代码,还含 schema、文档、论文、图像、视频)抽成一张知识图谱,让助手与人都能直接查询关系而非翻文件,且代码部分用 tree-sitter 本地解析、不外传。一行 /graphify 即用、跨十几种助手、产出可交互 HTML 报告,加上 YC 背书与极强的社区反响,使它成为现象级项目(约 5.2 万星,多语言文档)。

来源:README 顶部简介/Privacy、GitHub meta(stars 52161、created_at 2026-04-03、pushed_at 2026-05-22)

核心功能

一键把项目变知识图谱

在助手里 `/graphify .` 即把整个项目映射成知识图谱,产出 graph.html(可交互:点节点、筛选、搜索)、GRAPH_REPORT.md(关键概念、意外连接、建议问题)与 graph.json(完整图,随时查询无需重读文件)。

来源:README 顶部简介(三文件输出)
多类型内容统一入图

不止代码:把应用代码、数据库 schema、R/shell 脚本、文档、PDF/论文、图片、视频等放进同一张图,能看出跨层(代码↔schema↔基础设施)的关联。

来源:README 顶部简介/What files it handles 段
本地代码解析 + 置信度标注

代码用 tree-sitter 在本地做 AST 提取、无 API 调用、不离开机器;其它内容经助手模型 API 处理。每条推断关系标注 EXTRACTED/INFERRED/AMBIGUOUS,让你分清「找到的」与「猜的」。

来源:README What's in the report(confidence tags)/What files it handles(本地解析)/Privacy
社区检测与调用流导出

可选 Leiden 社区检测对图聚类(Python<3.13);`graphify export callflow-html` 导出带 Mermaid 调用流图的可读架构页;还有 deep 模式做更激进的关系提取、LLM 去重消歧等命令。

来源:README Optional extras(leiden)/顶部(callflow-html)/Full command reference
跨多助手、多种安装

`uv tool install graphifyy`(或 pipx/pip)装包后 `graphify install` 注册技能;支持 Claude Code、Codex、OpenCode、Copilot CLI、VS Code Copilot、Aider、OpenClaw 等多平台,可用 --project 装到当前仓库,团队可共享。

来源:README Install/Pick your platform/Team setup 段

技术架构

Graphify 是 Python 实现、以 PyPI 包 graphifyy 分发的 AI 助手技能 + CLI。核心在 graphify/:提取流水线对项目各类文件构建知识图谱——代码走 tree-sitter 本地 AST(无 API、不外传),文档/论文/图像/视频等经助手模型 API 处理;可选 Leiden 做社区检测聚类,关系带 EXTRACTED/INFERRED/AMBIGUOUS 置信度。输出落到 graphify-out/(graph.html 交互视图、GRAPH_REPORT.md 报告、graph.json 完整图),并可导出带 Mermaid 调用流的架构 HTML。它把自己注册成各助手的 skill:`graphify install` 写入用户或项目级(如 .claude/skills/graphify/SKILL.md、.agents/skills/...),支持 Claude Code/Codex/OpenCode/Copilot/Aider/OpenClaw 等多平台。仓库还含 docs/(多语言 + how-it-works)、tests/、worked/(示例)。提供 deep 模式、LLM 去重消歧等命令与丰富配置。

来源:README Install/What's in the report/Privacy/Full command reference、仓库目录树(graphify/docs/tests/worked)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) tree-sitter(本地代码 AST 提取)tree-sitter(… Leiden 社区检测(可选,Python<3.13)Leiden 社区检测… 助手模型 API(非代码内容提取/消歧)助手模型 API(… uv / pipx / pip(安装)uv / pipx / pi… 一键把项目变知识图谱 多类型内容统一入图 本地代码解析 + 置信度标注本地代码解析 + 置信度… 社区检测与调用流导出 跨多助手、多种安装 graphify 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Python(3.10+)框架AI 助手技能 + 知识图谱提取流水线(GraphRAG 风格)
tree-sitter(本地代码 AST 提取)Leiden 社区检测(可选,Python<3.13)助手模型 API(非代码内容提取/消歧)uv / pipx / pip(安装)
PyPI 包 graphifyy、CLI graphify;本地运行,代码本地解析不外传;输出到 graphify-out/,跨多助手注册 skill
来源:README Prerequisites/Install/Privacy、topics(tree-sitter/leiden/graphrag)

快速上手

前置:Python 3.10+,推荐用 uv。安装:`uv tool install graphifyy`(或 pipx/pip;注意官方包是双 y 的 graphifyy,CLI 仍是 graphify),然后 `graphify install` 把技能注册到你的助手(可加 --platform codex/opencode/... 或 --project 装到当前仓库)。之后在助手里 `/graphify .` 即把项目建成知识图谱,得到 graphify-out/ 下的 graph.html、GRAPH_REPORT.md、graph.json。要架构页用 `graphify export callflow-html`,更激进的关系提取用 `/graphify ./raw --mode deep`。PowerShell 用 `graphify .`(不带斜杠)。代码本地解析、其它内容走助手模型 API。
来源:README Prerequisites/Install/Full command reference 段

使用场景

适合用 AI 助手在中大型或异构项目里工作的开发者:把代码 + schema + 基础设施 + 文档/论文/图像建成一张图,快速摸清架构与跨层关联、用「查图」替代翻文件、让助手据图回答而非反复 grep;用置信度区分确证与推断、用调用流图理解执行路径;团队可共享项目级图谱。也适合做代码库理解、架构梳理、知识沉淀,或研究「把多模态项目内容做成 GraphRAG 知识图谱」的实现。

来源:README 顶部简介/What files it handles/Team setup

优势与局限

优势

  • 一行即用、跨十几种助手:/graphify 把整个项目变可查询知识图谱,产出交互 HTML + 报告 + JSON,上手极简。
  • 范围广:不止代码,还吃 schema、脚本、文档、论文、图像、视频,能看出跨层关联。
  • 隐私与可信兼顾:代码用 tree-sitter 本地解析不外传,关系带 EXTRACTED/INFERRED/AMBIGUOUS 置信度标注。
  • 工程与社区成熟:Leiden 社区检测、调用流导出、deep 模式、多语言文档、YC S26、约 5.2 万星,MIT 开源。

局限

  • 非代码内容(文档/图像/视频)经助手模型 API 处理,会产生模型调用成本,且效果与所用模型相关。
  • 推断关系可能有误(故有 AMBIGUOUS 标注),大型项目的图可能出现重复节点等需去重处理。
  • 依赖 Python 与各助手的 skill 机制,PyPI 包名易混(官方为 graphifyy),安装需注意 PATH。
  • Leiden 社区检测仅 Python<3.13 可用等版本约束,部分功能有环境限制。
来源:README Privacy/What's in the report/Troubleshooting/Optional extras

最新版本

项目以 PyPI 包 graphifyy 持续发布(CI 在 v8 分支),跨多助手提供 skill 安装。功能已覆盖一键建图、多类型内容、tree-sitter 本地解析、置信度标注、Leiden 社区检测、调用流 HTML 导出与 deep 模式等。多语言文档齐全,YC S26、约 5.2 万星。仓库最近一次更新在 2026-05-22。

来源:README 徽章(PyPI/CI v8)/Full command reference、GitHub meta pushed_at 2026-05-22、created_at 2026-04-03

总结评价

Graphify 解决了 AI 助手在大型/异构项目里「靠 grep 理解代码」的低效:一行 /graphify 就把代码、schema、文档、论文乃至图像视频映射成可查询的知识图谱,产出可点选的 HTML、带建议提问的报告与完整 JSON,让助手与人都能据图回答而非翻文件,代码还本地解析不外传、关系带置信度。它跨十几种助手、文档多语言、YC 背书、五万多星,已是该方向的现象级项目,对做代码库理解与架构梳理的开发者价值很高。要清楚非代码内容走模型 API 有成本、推断关系可能有误需去重、包名 graphifyy 易混、部分功能有 Python 版本约束。作为「把项目变成可查询知识图谱」的助手技能,它的实用性与完成度都很突出。

来源:综合 README、提取流水线、隐私与置信度及 GitHub meta 的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-23 19:52. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件