这个项目能做什么
GitNexus(由Akon Labs开发)是一个代码智能引擎,将代码仓库转化为可查询的知识图谱。它不是将原始图边交给AI代理并期望其充分探索,而是在索引时预先计算结构——聚类、调用链追踪和置信度评分——使得单次工具调用即可返回关于某个符号、其依赖方及其参与的执行流的完整上下文。
工作原理
在仓库根目录运行`npx gitnexus analyze`可索引代码库、安装代理技能、为受支持的编辑器注册钩子,并生成AGENTS.md / CLAUDE.md上下文文件。`npx gitnexus setup`写入MCP配置,使Claude Code、Cursor、Codex、Antigravity、Windsurf、OpenCode、CodeBuddy和Qoder等编辑器能够查询图谱。解析使用Tree-sitter(CLI使用原生绑定,浏览器使用WASM),索引存储在LadybugDB中——CLI使用原生持久化存储,Web UI使用内存WASM。
两种使用模式
CLI + MCP路径面向日常开发:本地索引,然后让代理查询图谱。Web UI(托管于gitnexus.vercel.app或自托管)提供可视化图谱浏览器和AI聊天,除非使用后端,否则受浏览器内存限制。桥接模式`gitnexus serve`让Web UI检测本地服务器并浏览CLI索引的仓库,无需重新上传或重新索引。
MCP接口
暴露了17个MCP工具(15个按仓库级别加2个组级别),包括`query`(混合BM25 + 语义 + RRF搜索)、`context`(360度符号视图)、`impact`(爆炸半径分析)、`trace`(符号间最短有向路径)、`detect_changes`(git-diff影响映射)、`rename`、用于原始图查询的`cypher`,以及路由/工具/形状/API影响辅助工具和基于PDG的`explain`和`pdg_query`,用于污点和语句级依赖分析。配套的MCP资源提供仓库列表、聚类、进程、模式和组契约,两个提示词(`detect_impact`、`generate_map`)指导提交前分析和架构文档编写。
代理技能与工作流
技能安装到`.claude/skills/`,并在存在时镜像到`.agents/skills/`,涵盖探索、调试、影响分析、重构、CLI使用、PDG查询和污点分析。斜杠命令风格的工作流包括plan、work、review以及完整的plan→work→review流水线。使用`--skills`时,Leiden社区检测识别功能区域,并生成描述关键文件、入口点和跨区域连接的各区域项目技能。
部署与运维
为Render(私有服务器服务加基于令牌认证的公共Web服务)和RepoCloud提供一键部署蓝图。README记录了关于npm 11、可选Tree-sitter语法、代理受限环境和嵌入运行时下载的安装注意事项,以及只读MCP模式和用于限制代理可访问仓库的允许仓库策略。许可为PolyForm非商业许可,供应商提供商业SaaS/自托管产品。
评论
0 评分人数达到10人后显示
登录后参与讨论。