graphify 仓库中文介绍文档

graphify 是一款AI编码助理技能工具，通过将代码、文档、论文、图像或视频文件夹转换为可查询的知识图谱，帮助开发者快速理解代码库并发现架构决策背后的“为什么”，由 safishamsi 提供，汇聚了Claude Code、Codex、OpenCode、Cursor、Gemini CLI、GitHub Copilot CLI、OpenClaw、Factory Droid、Trae、Google Antigravity等AI编码助理的技能。

要点：

开头就要说清楚：这是什么工具、解决什么问题
包含Stars数（如有）、维护者信息
1-3句话，简洁有力

一、核心信息速览

维度	详情
:---	:---
仓库地址	[graphify](https://github.com/safishamsi/graphify)
许可证	MIT License
核心定位	将代码、文档、论文、图像或视频文件夹转换为可查询的知识图谱
主要语言	Python
适用人群	开发者、研究人员、数据科学家、AI工程师
关键亮点	多模态支持；知识图谱构建；持久化存储；高效查询

二、核心功能

功能模块	描述	典型场景
:---	:---	:---
知识图谱构建	从代码、文档、论文、图像或视频中提取概念和关系，构建知识图谱	快速理解复杂代码库结构
多模态支持	支持处理代码、PDF、Markdown、截图、图表、白板照片、图像、视频和音频文件	处理多样化数据源
持久化存储	生成的图谱可以长期保存，方便后续查询	长期跟踪项目进展
视频转录	使用Whisper对视频进行本地转录，并基于语料库生成领域提示	分析视频内容
图谱可视化	生成交互式HTML图谱，支持节点点击、搜索和社区过滤	可视化分析复杂关系
缓存机制	基于SHA256缓存处理过的文件，避免重复处理	提高处理效率
自定义忽略规则	通过`.graphifyignore`文件排除不需要的文件或目录	精准控制图谱内容
跨平台支持	支持多种编程语言（如Python、JS、TS、Go、Rust等）	适用于多语言项目

三、快速上手

1. 环境准备

Python 3.8及以上版本
安装依赖项（如networkx、faster-whisper等）

2. 安装方式

pip install graphify

3. 基础配置

创建 .graphifyignore 文件以排除不需要的文件：

# .graphifyignore
vendor/
node_modules/
dist/
*.generated.py

4. 核心示例

/graphify .

四、核心亮点

多模态支持：支持处理代码、PDF、Markdown、截图、图表、白板照片、图像、视频和音频文件。
知识图谱构建：从各种类型的数据中提取概念和关系，构建结构化的知识图谱。
持久化存储：生成的图谱可以长期保存，方便后续查询。
高效查询：相比直接阅读原始文件，减少71.5倍的token使用量。

五、适用场景

代码库理解：帮助开发者快速理解复杂的代码库结构。
研究分析：用于分析论文、技术文档和实验数据。
项目管理：追踪项目中的关键概念和关系，提高协作效率。
AI辅助开发：与AI编码助手结合，提升开发效率和代码质量。
知识整理：将非结构化数据转化为结构化知识，便于后续分析和应用。

六、优缺点

优势

支持多模态数据处理
构建的知识图谱易于查询和分析
提供持久化存储功能
高效的处理性能

不足

对于大型项目可能需要较多计算资源
初始配置和安装较为复杂
部分功能依赖外部工具（如Whisper）

七、与同类工具对比（可选）

工具	类型	核心差异
:---	:---	:---
graphify	AI编码助理工具	免费开源；多模态支持；高效查询
GitHub Copilot	AI编码助手	商业付费；仅支持代码补全；不提供知识图谱