乐于分享
好东西不私藏

GitNexus 开源代码库知识图谱引擎,效果惊艳!

GitNexus 开源代码库知识图谱引擎,效果惊艳!

项目简介

GitNexus 是一个完全在浏览器中运行的客户端代码智能工具。它能把任意代码库转化为知识图谱,只需拖入 GitHub 仓库链接或 ZIP 文件,就能立即得到一个可交互的知识图谱,还内置了基于图谱的 RAG 智能代理,非常适合代码探索和理解。

它能自主完成:

  • 用 Tree-sitter AST 解析将整个代码库索引为图
  • 映射所有函数调用、导入、类继承和接口
  • 按内聚评分将相关代码分组为功能簇
  • 从入口点追踪完整的调用链
  • 在修改任何一行代码前执行影响范围分析
  • 检测特定函数修改后哪些进程会出错
  • 一次协调操作重命名多个文件中的符号
  • 自动从知识图谱生成完整代码库维

核心理念

它像“神经系统”一样,为 AI 代理提供代码上下文。GitNexus 会把整个代码库索引成知识图谱——包括所有依赖关系、调用链、代码集群和执行流程——然后通过智能工具暴露给 AI 代理,让它们再也不会遗漏关键代码。

有人说它像 DeepWiki,但比 DeepWiki 更深一层。DeepWiki 帮助你“理解”代码,而 GitNexus 让你真正能“分析”代码。因为知识图谱记录的是所有关系,而不仅仅是描述。

一句话总结Web 界面适合快速聊天式探索代码库;CLI + MCP 模式则能让 Cursor、Claude Code、Codex 等 AI 编程工具真正“看懂”你的项目架构,即使是较小的模型,也能获得大型模型级别的上下文理解,避免盲目修改代码。


两种主要使用方式

使用方式
CLI + MCP
Web UI(浏览器版)
主要功能
本地索引仓库,通过 MCP 连接 AI 代理
可视化图谱浏览器 + 浏览器内 AI 对话
适合场景
日常开发(Cursor、Claude Code 等)
快速探索、演示、一次性分析
项目规模
支持任意大小的完整仓库
受浏览器内存限制(约 5000 个文件),或通过后端模式无限扩展
安装方式
npm install -g gitnexus
无需安装,直接打开 https://gitnexus.vercel.app
存储方式
LadybugDB 本地持久化存储
LadybugDB WASM(内存,当前会话)
解析引擎
Tree-sitter 原生绑定
Tree-sitter WASM
隐私保护
完全本地运行,无需联网
全部在浏览器内完成,无服务器

桥接模式:运行 gitnexus serve 后,Web 界面会自动检测本地服务器,可以直接浏览 CLI 已索引的仓库,无需重复上传或索引。

CLI + MCP 使用(推荐日常开发方式)

CLI 会在本地对仓库进行索引,并启动 MCP 服务器,让 AI 代理获得深度代码感知能力。

快速开始(在仓库根目录运行):

npx gitnexus analyze

一条命令即可完成:索引代码库、安装代理技能、注册 Claude Code 钩子、生成 AGENTS.md 和 CLAUDE.md 上下文文件。

MCP 配置: 运行一次 npx gitnexus setup,它会自动检测你的编辑器并写入正确的全局 MCP 配置。

支持的编辑器

  • Claude Code:完整支持(MCP + Skills + Hooks)
  • Cursor:支持 MCP + Skills
  • Codex:支持 MCP + Skills
  • Windsurf:支持 MCP
  • OpenCode:支持 MCP + Skills

Claude Code 集成最深,支持 PreToolUse 和 PostToolUse 钩子,能在工具调用前后自动注入图谱上下文,并在提交后自动重新索引。

常用 CLI 命令

  • gitnexus setup —— 配置 MCP(一次性)
  • gitnexus analyze [路径] —— 索引或更新仓库
  • gitnexus analyze --force —— 强制完整重新索引
  • gitnexus analyze --skills —— 根据代码社区自动生成特定技能文件

其他信息

项目还提供了详细的文档:

  • ARCHITECTURE.md:架构说明、包结构、索引→图谱→MCP 流程
  • RUNBOOK.md:运行手册、嵌入生成、索引过期处理等
  • GUARDRAILS.md:安全规则和操作指引
  • CONTRIBUTING.md:贡献指南
  • TESTING.md:测试命令

目前支持 TypeScript、Python、Java 等多种主流语言,未来会继续扩展。

项目地址

https://github.com/abhigyanpatwari/GitNexus 在线体验地址:https://gitnexus.vercel.app(无需安装,直接拖拽使用)

扫码加入技术交流群,备注「开发语言-城市-昵称

合作请注明

如果你觉得这篇文章不错,别忘了点赞、在看、转发给更多需要的小伙伴哦!我们下期再见!