把任意代码库（含文档、SQL 模式、配置、PDF、图片、视频）映射成可查询的知识图谱：在 AI 助手里输入 /graphify，30 秒生成三个文件（交互式 HTML 可视化、GRAPH_REPORT.md 高亮报告、graph.json 完整图谱）。代码解析用 tree-sitter AST 确定性完成，无需 LLM、不出本机；文档/PDF/图片用你的助手模型做语义路径。支持 Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等 20+ AI 助手，macOS / Linux / Windows 全平台。
怎么用
## 安装方法
### 步骤一：安装 CLI
```bash
uv tool install graphifyy # 推荐（或：pipx install graphifyy）
```
### 步骤二：注册技能
```bash
graphify install # 检测你的助手并注册技能
```
### 步骤三：在 AI 助手里使用
```
/graphify .
```
就这样。你得到**三个文件**：
- `graph.html`：在任何浏览器打开，点击节点、过滤、搜索
- `GRAPH_REPORT.md`：高亮内容：关键概念、意外连接、建议问题
- `graph.json`：完整图谱：随时查询，无需重读文件
## 使用方法
### 基本用法
```
/graphify # 对当前目录运行完整管道
/graphify <path> # 对特定路径运行完整管道
/graphify https://github.com/<owner>/<repo> # 克隆仓库然后运行完整管道
```
### 进阶用法
```
/graphify <path> --mode deep # 彻底提取，更丰富的 INFERRED 边
/graphify <path> --update # 增量 - 仅重新提取新/变更文件
/graphify <path> --force # 完全重建允许图谱收缩
/graphify <path> --directed # 构建有向图
/graphify <path> --cluster-only # 对现有图谱重新运行聚类
/graphify <path> --no-viz # 跳过可视化，仅报告 + JSON
/graphify <path> --svg # 也导出 graph.svg
/graphify <path> --graphml # 导出 graph.graphml
/graphify <path> --neo4j # 生成 cypher.txt 供 Neo4j
/graphify <path> --mcp # 启动 MCP stdio 服务器
/graphify <path> --watch # 监视文件夹，代码变更时自动重建
/graphify <path> --wiki # 构建 agent 可爬取的 wiki
```
### 查询图谱
```
/graphify query "<question>" # BFS 遍历 - 广泛上下文
/graphify query "<question>" --dfs # DFS - 追踪特定路径
```
### 常用场景
- **代码理解**：新接手一个项目，用 `/graphify .` 快速生成知识图谱，点击节点理解架构
- **文档整合**：把分散的文档、PDF、配置映射成统一图谱，方便查询
- **跨仓库分析**：克隆多个仓库，合并成一个跨仓库图谱，追踪依赖关系
- **代码审查**：用 Graphify Cloud 的形式化验证和代码审查功能，从鸟瞰视角审查 SDLC
- **知识管理**：把个人笔记、论文、教程映射成图谱，构建第二大脑
详细说明
## 这是什么
Graphify 是一个把任意代码库（含文档、SQL 模式、配置、PDF、图片、视频）映射成可查询知识图谱的工具。在 AI 助手里输入 `/graphify`，30 秒生成三个文件：
```
graphify-out/
├── graph.html 在任何浏览器打开：点击节点、过滤、搜索
├── GRAPH_REPORT.md 高亮内容：关键概念、意外连接、建议问题
└── graph.json 完整图谱：随时查询，无需重读文件
```
**核心特性**：
- **代码地图免费、完全本地**：代码用 tree-sitter AST 解析，确定性、无 LLM、不出本机。（文档、PDF、图片、视频用你的助手模型或配置的 API key 做语义路径。）
- **每条边都有解释**：每个连接都标记 `EXTRACTED`（源文件中明确存在）或 `INFERRED`（由 graphify 推断），让你能区分直接读取和推断的内容。
- **不是向量索引**：无嵌入、无向量存储：一个真实的图供你遍历。问一个问题，追踪两个事物之间的路径，或解释一个概念。
- **社区检测**：自动识别代码中的功能模块/社区，用颜色区分，帮助理解架构
- **God Nodes**：识别高连接度的核心节点（如主入口、核心类），突出显示
- **多 AI 助手支持**：Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot、Devin、Aider、Kilo、Kiro、OpenCode、Pi、Trae、VS Code、Windows 等 20+ 助手
- **全平台**：macOS、Linux、Windows
- **持久化图谱**：包含 `graph.schema_version` 和 `graph.graphify_version`，集成可检测不兼容的格式变更
## 使用门槛
- **Python 3.10+** 和 **uv**（或 pipx）
- **AI 助手**：任意支持 Skill 的 AI 助手（Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等 20+）
- **代码解析免费本地**：tree-sitter AST，无需 LLM、不出本机
- **文档/PDF/图片/视频**：用你的助手模型或配置的 API key 做语义路径（消耗 token）
- **Graphify Cloud（可选）**：always-on 记忆，跨整个 SDLC 保持图谱活跃，monorepo 和跨仓库支持、形式化验证、代码审查，Sentry/Jira 等连接器。**免费开始，无需信用卡**
## 快速开始
```bash
uv tool install graphifyy # 安装 CLI（或：pipx install graphifyy）
graphify install # 检测你的助手并注册技能
```
然后在 AI 助手里：
```
/graphify .
```
就这样。你得到**三个文件**：
- `graph.html`：在任何浏览器打开，点击节点、过滤、搜索
- `GRAPH_REPORT.md`：高亮内容：关键概念、意外连接、建议问题
- `graph.json`：完整图谱：随时查询，无需重读文件
## 常用命令
```
/graphify # 对当前目录运行完整管道（HTML 可视化；加 --obsidian 生成 vault）
/graphify <path> # 对特定路径运行完整管道
/graphify https://github.com/<owner>/<repo> # 克隆仓库然后运行完整管道
/graphify <path> --mode deep # 彻底提取，更丰富的 INFERRED 边
/graphify <path> --update # 增量 - 仅重新提取新/变更文件
/graphify <path> --force # 完全重建允许图谱收缩（例如删除文件后）
/graphify <path> --directed # 构建有向图（保留边方向：source→target）
/graphify <path> --cluster-only # 对现有图谱重新运行聚类
/graphify <path> --no-viz # 跳过可视化，仅报告 + JSON
/graphify <path> --svg # 也导出 graph.svg（嵌入 Notion、GitHub）
/graphify <path> --graphml # 导出 graph.graphml（Gephi、yEd）
/graphify <path> --neo4j # 生成 graphify-out/cypher.txt 供 Neo4j
/graphify <path> --mcp # 启动 MCP stdio 服务器供 agent 访问
/graphify <path> --watch # 监视文件夹，代码变更时自动重建（无需 LLM）
/graphify <path> --wiki # 构建 agent 可爬取的 wiki（index.md + 每个社区一篇文章）
/graphify add <url> # 获取 URL，保存到 ./raw，更新图谱
/graphify query "<question>" # BFS 遍历 - 广泛上下文
/graphify query "<question>" --dfs # DFS - 追踪特定路径
```
## 版本信息
- 最新版本：v0.9.108（2026-11-12 发布）
- 构建状态：通过
- 许可证：Apache-2.0
- 星标：147,549
- YC S26
常见问题
它是做什么的？
把任意代码库（含文档、SQL 模式、配置、PDF、图片、视频）映射成可查询的知识图谱：在 AI 助手里输入 /graphify，30 秒生成三个文件（交互式 HTML 可视化、GRAPH_REPORT.md 高亮报告、graph.json 完整图谱）。代码解析用 tree-sitter AST 确定性完成，无需 LLM、不出本机；文档/PDF/图片用你的助手模型做语义路径。支持 Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等 20+ AI 助手，macOS / Linux / Windows 全平台。
怎么用？
## 安装方法
源码在哪里？
源码地址：https://github.com/Graphify-Labs/graphify
怎么安装？
安装在星算助手客户端里完成 —— 由它决定装进 Claude Code、Codex 还是别的工具，并写好对应配置。