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，团队共享结构化知识，降低沟通成本。
与传统工具对比
常见问题：
官方解答：
个人总结：
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 .
全文干货，大家有什么问题也可以一起讨论。
喜欢留个关注，会持续输出，谢谢。
