GitNexus 是一个为 AI 智能体构建代码理解神经系统的工具，它通过将代码库索引为知识图谱来增强 AI 编程助手对代码结构的深度理解。以下是关于该项目的全面介绍、部署安装步骤及使用指南。
一、GitNexus 概述
1.1 GitNexus 解决的核心问题
传统 AI 代码助手（如 Cursor、Claude Code、Windsurf）虽然强大，但缺乏对代码库深层结构的理解。当 AI 编辑代码时，无法感知跨文件的依赖关系，容易导致破坏性变更被发布。GitNexus 通过构建完整的代码知识图谱，追踪每个依赖、调用链、集群和执行流程，为 AI 提供全局架构视野。
1.2 GitNexus 预计算的关系智能
与传统 Graph RAG 需要 LLM 多轮探索不同，GitNexus 在索引时预计算结构（聚类、追踪、评分），工具一次调用即可返回完整上下文。例如，询问'UserService 依赖什么？'时，impact 工具能一次性返回所有调用者、集群和置信度，而非需要多次查询。
1.3 项目数据
- GitHub Stars: 约 10,800+
- 许可证: PolyForm Noncommercial License 1.0.0（仅限非商业用途）
- 支持语言: TypeScript、JavaScript、Python、Java、Kotlin、C、C++、C#、Go、Rust、PHP、Swift 等 11+ 种语言
二、GitNexus 功能
2.1 双模式架构
| 模式 | 定位 | 规模限制 | 存储 | 解析 | 隐私 |
|---|---|---|---|---|---|
| CLI + MCP | 日常开发，AI 智能体集成 | 完整仓库，任意大小 | KuzuDB 原生（快速、持久化） | Tree-sitter 原生绑定 | 完全本地，无网络调用 |
| Web UI | 快速探索、演示、一次性分析 | 受浏览器内存限制（约 5k 文件） | KuzuDB WASM（内存中，每会话） | Tree-sitter WASM | 完全在浏览器中，无服务器 |
2.2 知识图谱构建流程
GitNexus 通过多阶段索引管道构建完整的知识图谱：
- 结构扫描（0-15%）：遍历文件系统，建立 File/Folder 节点
- AST 解析（15-70%）：使用 Tree-sitter 并行解析，提取符号
- 导入解析（70-75%）：语言感知的导入解析，建立 IMPORTS 关系
- 调用解析（75-80%）：建立 CALLS 关系（带置信度）
- 继承解析（80-85%）：提取 EXTENDS/IMPLEMENTS 关系
- 社区检测（85-90%）：使用 Leiden 算法进行功能聚类
- 流程追踪（90-95%）：从入口点追踪执行流程
- 嵌入生成（95-98%）：生成符号嵌入向量
