GitNexus - 代码仓库智能操作系统
项目地址：https://github.com/nxpatterns/gitnexus
GitNexus: The Zero-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a GitHub repo or ZIP file, and get an interactive knowledge graph wit a built in Graph RAG Agent. Perfect for code exploration
项目特点：
- 零服务器：完全在客户端运行，无需服务器
- 开源免费：代码开源，可自由使用和修改
- 活跃维护：项目持续更新，社区活跃
主要功能
核心作用
GitNexus 的核心作用是为 AI Agent 构建代码库知识图谱，通过智能工具提供深度代码库感知能力：
- 知识图谱索引：将代码库转换为完整的知识图谱
- MCP 集成：通过 MCP 协议为 AI 代理提供工具和资源
- 智能工具：提供 7 个 MCP 工具，一次调用返回完整上下文
- 预计算智能：在索引时预计算结构，避免多次查询
- 多仓库支持：支持多仓库索引，全局注册表管理
使用场景
日常开发
与 Cursor、Claude Code、Windsurf 集成，提供深度代码库感知.避免破坏性变更，提高代码质量
代码探索
快速探索不熟悉的代码库
理解代码库的架构和依赖关系
影响分析
在修改代码前分析影响范围
识别可能受影响的函数和模块
重构规划
使用依赖映射规划安全重构
识别重构的影响范围
调试追踪
通过调用链追踪 Bug
理解代码的执行流程
快速开始
CLI + MCP 模式（推荐）
bash 体验AI代码助手 代码解读复制代码# 索引你的仓库（在仓库根目录运行）
npx gitnexus analyze
GitNexus 在项目中的角色与功能 （Example)
根据项目文档，GitNexus 是本项目的代码智能引擎，当前索引状态：
┌────────┬─────────┐
│ 指标 │ 数值 │
├────────┼─────────┤
│ 符号数 │ 81,400 │
├────────┼─────────┤
│ 关系数 │ 191,438 │
├────────┼─────────┤
│ 执行流 │ 300 │
└────────┴─────────┘
按重要性排序的功能
1. 🔴 影响分析（强制门禁）
最重要功能 — 修改任何代码前必须执行。
gitnexus_impact({target: "symbolName", direction: "upstream"})
- 作用：显示修改的"爆炸半径"——直接调用者、受影响的执行流、风险等级
- 风险等级：
- d=1 — 必定崩溃，必须更新
- d=2 — 可能受影响，应测试
- d=3 — 潜在影响，关键路径需测试
- 强制规则：忽略 HIGH/CRITICAL 警告视为违规
2. 🔴 提交前变更检测（强制门禁）
gitnexus_detect_changes({scope: "staged"})
- 作用：验证变更仅影响预期范围
- 强制规则：提交前必须运行，确认无意外影响
3. 🟡 代码查询与探索
gitnexus_query({query: "auth validation"})
- 作用：通过自然语言/概念查找执行流，替代 grep
- 返回：按相关性排序的进程分组结果
4. 🟡 符号上下文查看
gitnexus_context({name: "validateUser"})
- 作用：360° 查看单个符号
- 所有调用者/被调用者
- 参与的执行流
- 文件位置
5. 🟡 安全长名称重命名
gitnexus_rename({symbol_name: "old", new_name: "new", dry_run: true})
- 作用：基于调用图的安全重命名（非简单文本替换）
- 返回：预览编辑（graph 编辑可信，text_search 需人工审核）
6. 🟢 执行流追踪
READ gitnexus://repo/mystocks_spec/process/{processName}
- 作用：逐步追踪完整执行流程
- 用途：调试时理解代码路径
7. 🟢 Cypher 自定义查询
gitnexus_cypher({query: "MATCH ..."})
- 作用：复杂结构查询（知识图谱）
工作流集成
┌────────┬──────────────────────┬──────────────┐
│ 阶段 │ GitNexus 工具 │ 目的 │
├────────┼──────────────────────┼──────────────┤
│ 修改前 │ impact │ 评估爆炸半径 │
├────────┼──────────────────────┼──────────────┤
│ 调试时 │ query + context │ 定位问题 │
├────────┼──────────────────────┼──────────────┤
│ 重构时 │ rename + impact │ 安全变更 │
├────────┼──────────────────────┼──────────────┤
│ 提交前 │ detect_changes │ 验证范围 │
├────────┼──────────────────────┼──────────────┤
│ 提交后 │ npx gitnexus analyze │ 更新索引 │
└────────┴──────────────────────┴──────────────┘
资源清单
┌──────────────────────────────────────────────┬────────────────────────┐
│ 资源 │ 用途 │
├──────────────────────────────────────────────┼────────────────────────┤
│ gitnexus://repo/mystocks_spec/context │ 代码库概览、索引新鲜度 │
├──────────────────────────────────────────────┼────────────────────────┤
│ gitnexus://repo/mystocks_spec/clusters │ 所有功能区域 │
├──────────────────────────────────────────────┼────────────────────────┤
│ gitnexus://repo/mystocks_spec/processes │ 所有执行流 │
├──────────────────────────────────────────────┼────────────────────────┤
│ gitnexus://repo/mystocks_spec/process/{name} │ 逐步执行追踪 │
└──────────────────────────────────────────────┴────────────────────────┘
总结：GitNexus 是项目的代码安全网，核心价值是防止"改一处崩一片"。两个强制门禁（影响分析 + 变更检测）是所有代码修改的前置条件。
不得不说，真是太香了~~ 哈哈哈
浙公网安备 33010602011771号