
![](https://developer.qcloudimg.com/http-save/yehe-10389108/326a3a7dc258e28eeec2ec80980d3047.png)
**Graphify** 是一款开源、本地优先的多模态知识图谱构建工具，主打 “一条命令把任意文件夹（代码 / 文档 / 图片 / PDF 等）转成可查询、持久化的知识图谱”，2026 年 4 月由开发者 Safi Shamsi 发布，短时间内获得高人气。它常作为 Claude Code / OpenCode / Cursor 等 AI 编程助手的核心插件（Skill），核心解决大模型处理大型项目时Token 消耗高、上下文易丢失、关系理解弱的痛点。

**废话不多说，先说使用方法：**

前置要求：

Python 3.10+
任一 AI 编程助手：
- Claude Code
- Codex
- OpenCode
- OpenClaw
- Factory Droid

安装步骤：

```
# 1. 安装 graphify（PyPI 包名暂时为 graphifyy）
pip install graphifyy

# 2. 安装到你的 AI 编程助手
graphify install
```

平台特定安装：

```
平台	安装命令
Claude Code (Linux/Mac)	graphify install
Claude Code (Windows)	graphify install --platform windows
Codex	graphify install --platform codex
OpenCode	graphify install --platform opencode
OpenClaw	graphify install --platform claw
Factory Droid	graphify install --platform droid
```

验证安装：

```
# 检查安装
graphify --version

# 查看帮助
graphify --help
```

使用方法：

```
在你的 AI 编程助手中输入：
/graphify .
这会在当前目录构建知识图谱。

指定目录
/graphify ./my-project
深度模式
/graphify ./raw --mode deep
更激进的推断边提取，发现更多隐藏关系。

增量更新
/graphify ./raw --update
只重新提取变更的文件，合并到现有图谱中。

只重新聚类
/graphify ./raw --cluster-only
在现有图谱上重新运行聚类，不重新提取。
```

Graphify 会在 graphify-out/ 目录生成以下文件：

```
graphify-out/
├── graph.html          # 交互式图谱（点击节点、搜索、按社区过滤）
├── GRAPH_REPORT.md     # 核心节点、意外连接、建议问题
├── graph.json          # 持久化图谱（数周后仍可查询）
└── cache/              # SHA256 缓存（只处理变更文件）
```

亲身体验！
可能会出现找不到包的情况、或者pip安装失败的问题，需要使用pipx或sudo安装。

这里就不过多介绍完整命令了，详细的命令可以到github中查看，主要说一下怎么用，有哪些常见问题。

**一句话定义：把项目全量材料（代码 + 文档 + 多媒体）自动抽取实体与关系，构建显式知识图谱，后续查询走图遍历而非全文检索，实现71.5 倍 Token 压缩。**

**核心特点**
多模态全覆盖：代码、文档、图片（视觉模型解析）、PDF、音视频统一入图，打破 “仅代码分析” 的局限。

- 三级置信度标签：
  - EXTRACTED：代码中显式存在（如函数调用），置信度 1.0。
  - INFERRED：合理推断（如语义相似），置信度 0.6–0.9。
  - AMBIGUOUS：不确定，留待人工审核。
- 零向量数据库依赖：用图拓扑（Leiden 算法）做社区发现，无需 Embedding / 向量检索，数据永不离机。
- 持久化与增量更新：图谱存本地，跨会话复用；支持 --update 增量刷新，Git 钩子可自动触发。
- 安全可控：零遥测、无厂商锁定、本地处理，符合隐私合规。

成本与效率优化：

- Token 消耗降低 71.5 倍：预构建图谱，查询仅遍历图，不读原始文件。
- 减少幻觉：结构化知识提供精准上下文，降低大模型错误推理。
- 跨会话持久化：图谱长期有效，避免重复解析。

**适用场景：**
- 大型代码库维护：快速定位调用链、依赖冲突、架构冗余，支持重构与审计。
- AI 编程助手增强：为 Claude Code/OpenCode 注入结构化理解，回答架构 / 流程 / 模块关系问题更精准。
- 多模态项目管理：统一管理代码、设计图、会议录、论文，构建项目级知识网络。
- 知识沉淀与协作：导出 Obsidian/Wiki，团队共享结构化知识，降低沟通成本。

**与传统工具对比**

![](https://developer.qcloudimg.com/http-save/yehe-10389108/db0afba57cd56d76072ab35b6c681fee.png)

**常见问题：**

官方解答：
![](https://developer.qcloudimg.com/http-save/yehe-10389108/3f2662cfe08df0f6c03bade24518789c.png)

个人总结：

Q：pip install graphify 报错 / 找不到包

A:

```
pip install graphifyy

pip install --upgrade graphifyy
```


Q：安装后命令不存在 / 提示不是内部命令

A:

```
# 查看安装位置
pip show graphifyy
# 将 Scripts 目录加入 PATH（示例，按你的 Python 路径调整）
export PATH="$HOME/.local/bin:$PATH"   # Linux/macOS
set PATH=%APPDATA%\Python\Python311\Scripts;%PATH%   # Windows
```

Q：构建时报错：Claude API key not found / 401 Unauthorized

A:

```
# Linux/macOS
export ANTHROPIC_API_KEY=sk-xxx

# Windows PowerShell
$env:ANTHROPIC_API_KEY="sk-xxx"

# Claude Code 用户通常自动读取 ~/.claude/credentials.json
cat ~/.claude/credentials.json
```

Q：超时、连接失败、速率限制

A:

```
# 限制单次 Token，避免过大请求
graphify build . --budget 2000

# 超时跳过坏文件，不阻塞整体
graphify build . --timeout 30
```

Q：增量更新后图谱不一致、有 “幽灵节点”（已删文件还在图里）

A:

```
# 增量+清理已删除节点
graphify build . --update --prune

# 缓存损坏/哈希不一致：全量重建
rm -rf graphify-out/cache
graphify build .
```

全文干货，大家有什么问题也可以一起讨论。

喜欢留个关注，会持续输出，谢谢。


Graphify 是一款开源、本地优先的多模态知识图谱构建工具，主打 “一条命令把任意文件夹（代码  文档  图片  PDF 等）转成可查询、持久化的知识图谱”，2026 年 4 月由开发者 Safi Shamsi 发布，短时间内获得高人气。它常作为 Claude Code  OpenCode / Cursor 等 AI 编程助手的核心插件（Skill），核心解决大模型处理大型项目时Token 消耗高、上下文易丢失、关系理解弱的痛点。

一文读懂 Graphify 知识图谱

Graphify 是一款开源、本地优先的多模态知识图谱构建工具，主打 “一条命令把任意文件夹（代码  文档  图片  PDF 等）转成可查询、持久化的知识图谱”，2026 年 4 月由开发者 Safi Shamsi 发布，短时间内获得高人气。它常作为 Claude Code  OpenCode / Cursor 等 AI 编程助手的核心插件（Skill），核心解决大模型处理大型项目时Token 消

架构师

人工智能

开发工具

后端

Graphify是一款开源本地知识图谱工具，可将代码/文档/图片等自动构建为可查询图谱。支持多模态分析、增量更新和71.5倍Token压缩，有效解决大模型处理大型项目时的上下文丢失问题。安装简单，兼容主流AI编程助手，适合代码维护、项目管理等场景。

向量数据库

数据库

Windows

Python

Linux

2026采购季 | AI焕新·智启新局

tcap

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

一文读懂 Graphify 知识图谱-腾讯云开发者社区-腾讯云

一文读懂 Graphify 知识图谱

一文读懂 Graphify 知识图谱

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐