GitNexus是什么

GitNexus 是开源的代码知识图谱引擎，通过 Tree-sitter 解析将代码仓库构建为完整的依赖关系图，用 MCP 协议向 Cursor、Claude Code、Codex 等 AI 工具暴露结构化上下文。工具能预计算调用链、聚类、风险评分等关系，使 AI 一次调用可获得完整代码库视图，无需多轮查询。

GitNexus的主要功能

• 知识图谱构建：将代码仓库解析为节点（函数、类、方法、接口）和边（调用、继承、导入、实现）构成的图，支持 14 种主流语言。
• Impact 影响分析：输入任意符号，返回多层依赖影响范围，标注置信度和风险等级，改代码前即可预判哪些调用方会崩。
• 360° 符号上下文：查询单个符号时，同时返回其上游调用者、下游被调用者、所属执行流程及跨文件引用，消除 AI 的上下文盲区。
• 变更检测：对比 Git diff 与知识图谱，自动映射改动行到受影响符号和流程，评估风险等级。
• 多文件重命名：基于图谱依赖关系执行跨文件协调重命名，区分高置信度图编辑与低置信度文本搜索编辑。
• 混合搜索：BM25 + 语义向量 + RRF 融合检索，按执行流程分组返回结果，优先展示跨社区的关键路径。
• Cypher 图查询：直接对代码库执行 Cypher 图查询语言，自定义检索高置信度调用关系或特定社区结构。
• Wiki 自动生成：基于知识图谱结构调用 LLM 自动生成模块文档和架构总览，支持多语言输出。

GitNexus的技术原理

• 多阶段索引流水线：GitNexus 采用六阶段流水线将代码库转化为知识图谱。第一阶段遍历文件树建立目录结构映射；第二阶段通过 Tree-sitter 解析 AST，提取函数、类、方法、接口等符号节点；第三阶段执行跨文件解析，解决导入、调用、继承关系，推断构造函数及 self/this 接收者类型；第四阶段运用 Leiden 社区检测算法将相关符号聚类为功能模块；第五阶段从入口点出发追踪执行流程，生成带步骤索引的过程链；第六阶段构建混合搜索索引，融合 BM25 倒排、语义向量与 RRF 重排序。
• 图谱存储与并发：索引结果存入 LadybugDB，CLI 使用原生绑定，Web UI 使用 WASM 版本，数据完全本地持久化。解析阶段采用 Worker 线程池并发处理，通过分块调度与超时回退机制平衡吞吐量与稳定性；大规模仓库支持嵌入向量生成，默认 5 万节点安全上限防止内存溢出。
• 预计算关系智能：与传统 Graph RAG 将原始图边实时丢给 LLM 探索不同，GitNexus 在索引阶段即完成聚类、调用链追踪、风险置信度评分等计算。查询时通过 MCP 工具一次性返回结构化结果，AI 无需多轮交互即可获取完整的 360° 符号上下文、影响爆炸半径或变更检测报告。

如何使用GitNexus

• CLI + MCP 方式：

  • 全局安装：npm install -g gitnexus

  • 进入仓库根目录执行：npx gitnexus analyze

  • 一键配置编辑器：npx gitnexus setup

  • 在 Claude Code / Cursor 等工具中直接调用 MCP 工具

• Web UI 方式：

  • 访问 gitnexus.vercel.app，在浏览器中直接拖入 GitHub 仓库或 ZIP 文件

  • 或本地运行 npx gitnexus@latest serve 启动后端，前端自动连接

• Docker 方式：执行 docker compose up -d 同时启动后端（4747 端口）和前端（4173 端口）

GitNexus的核心优势

• 预计算关系智能：传统 Graph RAG 把原始图边丢给 LLM 自行探索，GitNexus 在索引阶段就完成聚类、调用链追踪和风险评分，AI 一次调用可拿到完整答案。
• 本地零服务器：CLI 全程本地运行，不联网、不上传代码；Web UI 仅在浏览器内处理，数据不出本机。
• 小模型友好：重活由工具层承担，模型不必具备超强推理能力，中小模型也能获得与大模型同等的架构清晰度。
• 多仓库全局注册：一个 MCP 服务器可同时服务多个已索引仓库，通过 ~/.gitnexus/registry.json 全局管理，无需逐项目配置。
• 深度编辑器集成：Claude Code 获得最完整支持（MCP + Skills + Pre/Post ToolUse 钩子），提交后自动检测索引过期并提示重索引。

GitNexus的项目地址

• 项目官网：https://gitnexus.vercel.app/
• GitHub仓库：https://github.com/abhigyanpatwari/GitNexus

GitNexus的同类竞品对比

GitNexus的应用场景

• 大型重构前评估：修改核心服务返回值前，先用 impact 工具查看所有依赖方和分层风险，避免牵一发而动全身。
• 新人代码熟悉：通过知识图谱和自动生成的 Wiki，快速理解陌生代码库的模块划分、执行流程和关键入口。
• Bug 根因追踪：用 context 和 query 沿调用链反向追踪，定位跨文件传播的缺陷路径。
• PR 影响审查：提交前运行 detect_changes，将 diff 映射到受影响符号和流程，自动生成风险报告。
• 跨仓库微服务治理：通过 group 命令建立多仓库组，提取服务间契约并匹配跨仓库调用关系。