Hotdry.
ai-systems

浏览器端 GitNexus 知识图谱:零服务器代码探索与 Graph RAG

浏览器内从 GitHub repo 或 ZIP 构建交互知识图谱,集成 Graph RAG agent,实现零服务器代码探索与智能分析,提供 CLI/MCP 工具增强 AI 编辑器。

在现代软件开发中,代码库规模日益庞大,AI 辅助工具如 Cursor 或 Claude Code 虽强大,但往往因缺乏完整架构认知而导致依赖遗漏或变更影响评估失准。GitNexus 作为一款 client-side 引擎,提供了一种颠覆性解决方案:完全在浏览器内从 GitHub repo 或 ZIP 文件构建交互式知识图谱,并无缝集成 Graph RAG agent,实现零服务器的代码探索与情报分析。这种 zero-server 执行模型确保代码隐私不离本地,同时通过预计算的关系智能(如聚类、进程追踪)大幅提升 AI 代理的可靠性。

GitNexus 的核心在于其多阶段索引管道,首先通过 Tree-sitter WASM 解析支持 TypeScript、JavaScript、Python、Java、C/C++/C#、Go、Rust 等 9 种语言的 AST,提取函数、类、方法及接口;其次,利用 KuzuDB WASM 嵌入式图数据库存储节点与边关系,包括导入解析、函数调用链、文件夹结构;进一步进行符号解析、聚类(基于图论社区检测)和进程追踪(从入口点顺藤摸瓜执行流)。证据显示,这种预计算机制远胜传统 Graph RAG,后者依赖 LLM 实时多轮图查询易遗漏上下文,而 GitNexus 的工具如 impactcontext 在单次调用即返回完整 360 度视图,例如 impact({target: "UserService", direction: "upstream", minConfidence: 0.8}) 输出深度分组的影响半径,标注高置信调用(如 90% handleLogin 调用)。“GitNexus 预计算结构,确保工具响应自带完整上下文,避免 LLM 10 查询链。”(GitHub README)

落地部署参数与清单聚焦 Web UI(gitnexus.vercel.app 或本地 npm run dev),适合快速探索:1. 拖拽 ZIP 或输入 GitHub URL,浏览器内存上限~5k 文件,超限切换 bridge mode(CLI gitnexus serve 后 Web UI 自动连接本地后端);2. 交互参数:图可视化用 Sigma.js + Graphology WebGL,支持缩放 / 拖拽 / 高亮节点,RAG agent 配置 embedding 模型(transformers.js WebGPU),查询阈值如 BM25 + 语义 + RRF 混合搜索的 minConfidence: 0.8maxDepth: 3;3. 监控要点:索引进度 Web Worker 并发(Comlink 通信),KuzuDB 连接池惰性打开(CLI 模式 max 5 并发,5min 空闲驱逐);4. 回滚策略:gitnexus clean --all --force 清索引,浏览器 localStorage 清 API key。CLI 补充生产:npx gitnexus analyze --skip-embeddings 加速(跳过 embedding),MCP 工具清单:query(进程分组搜索)、context(符号全景)、impact(爆炸半径)、detect_changes(git-diff 影响)、rename(多文件重命名 dry_run: true)、cypher(原生 Cypher 如 MATCH (c:Community)<-[:MEMBER_OF]-(fn) RETURN ...)。

工程化阈值优化:信心阈值 0.8 平衡精度 / 召回(低于 0.7 易假阳,高于 0.9 漏检);进程步长上限 10(防无限递归);聚类内聚分 >0.5 视为功能社区。风险限:浏览器 WASM 解析慢于 native(CLI 用 Tree-sitter 原生绑定),大型 repo 建议 CLI 多 repo 注册(~/.gitnexus/registry.json)。示例落地:分析 auth 模块,query({query: "authentication middleware"}) 返回 LoginFlow 进程(priority: 0.042, 7 步,validateUser@src/auth/validate.ts),直接指导重构。

此零服务器模式 democratize 小模型:工具预结构化让 gpt-4o-mini 等匹敌巨型模型。参数 checklist:1. 编辑器集成 gitnexus setup(Claude Code 全钩子,Cursor mcp.json);2. 资源 URI 如 gitnexus://repo/my-app/process/LoginFlow;3. Wiki 生成 gitnexus wiki --model gpt-4o-mini(需 OPENAI_API_KEY)。

资料来源
GitNexus GitHub Repo
Web UI Demo

(正文字数:1028)

查看归档