这个项目能做什么

CodeGraph 是一个开源的、100% 本地运行的代码知识图谱,旨在大幅提升 AI 编程代理的能力,包括 Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro 以及 GitHub Copilot。 它构建整个代码库的预索引语义图谱——涵盖每个符号、调用边和依赖关系,并在每次文件变更时自动同步,确保索引永不滞后。代理不再需要通过 grep 和 Read 工具调用逐文件探索,CodeGraph 一次调用即可提供所需的确切代码。 核心功能: - **原生 Rust 内核**:解析引擎使用 Rust 编写,支持 20 多种语言(TypeScript、JavaScript、Python、Go、Rust、Java、C/C++、Swift、Kotlin 等)。图谱经验证与参考引擎字节级完全一致。 - **自适应你的机器**:工作池和缓存大小根据实际系统资源配置——容器感知的核心数和真实的 RAM 测量。在工作站和低配 VPS 上均可运行。 - **精准上下文**:一次工具调用即可返回入口点、相关符号和代码片段,消除逐文件探索的需求。 - **自动同步**:监听项目变化,在每次文件变更时更新图谱(增量同步约 0.3 秒)。 - **框架感知路由**:理解 Web 框架中的路由结构。 - **混合平台支持**:处理 iOS/React Native/Expo 桥接。 - **浏览器界面**:通过 http://127.0.0.1:4747 可视化图谱,展示调用者、符号和调用目标。 - **MCP Server**:通过 Model Context Protocol 集成,支持各类代理。 基准测试结果(2026 年 8 月 across 7 个开源仓库,使用 Claude Opus 4.8 测试):与文件读取型代理相比,CodeGraph 将工具调用减少了 88%,token 消耗减少了 62%,成本降低了 44%,且在所有测试仓库中文件读取量降至零。 安装方式:独立二进制文件(无需 Node.js),通过安装脚本或 npm 全局包安装。使用 `codegraph init` 进行项目级配置,并通过 `codegraph install` 连接至代理。