Repolode
Jakedismo

Jakedismo/codegraph-rust

用 Rust 实现的代码知识图谱工具,通过 MCP 为编程智能体提供语义搜索和代码分析能力。

Star
913
Fork
98
未关闭 Issue
17
最近提交
26天前

这是什么?

CodeGraph 会把项目索引成由节点和边组成的代码知识图谱,融合 AST 解析、可选的语言服务器符号解析、模块关联和向量嵌入。图谱存放在每个项目 .codegraph 目录下的内嵌 SurrealDB 中,无需单独部署数据库服务。

它面向 Claude Code、Cursor、Codex 等 AI 编程助手。四个整合后的智能工具(上下文、影响分析、架构、质量)会在图谱上运行推理智能体,返回带文件路径、行号和有限代码片段的答案,而不是原始搜索结果列表。索引分为 fast、balanced、full 三档,可在速度、存储与图谱丰富度之间取舍。

搜索结合向量相似度、词法匹配和可选的重排序。项目还会限制每次运行返回给模型的工具输出量,并支持 Ollama、LM Studio、Jina、OpenAI、Anthropic 等多种嵌入与大模型提供方。

核心功能

  • 01构建包含代码节点、边、模块和数据流关系的知识图谱。
  • 02提供上下文、变更影响、架构和质量四类智能分析工具,通过 MCP 对接编程智能体。
  • 03支持 fast、balanced、full 三档索引,可选启用 LSP 符号解析。
  • 04每个项目使用内嵌 SurrealDB 存储数据,无需额外部署数据库服务。
  • 05结合向量检索与词法检索,并可选启用重排序。
  • 06索引时遵循 .gitignore,并过滤 .env、证书等常见敏感文件。

适用场景

  • 在重构大型代码库前,为 Claude Code 或 Cursor 提供全项目上下文。
  • 评估修改某个函数、类型或模块会影响哪些调用方和依赖。
  • 在不熟悉的 Rust 项目中快速了解架构并定位复杂度热点。
  • 使用本地自托管的嵌入模型,让源代码不离开本机。

快速上手

  1. 1

    按照安装指南(docs/INSTALLATION_GUIDE.md)安装 CodeGraph

  2. 2

    使用 balanced 层级为项目建立索引

    codegraph index /path/to/project --index-tier balanced
  3. 3

    在命令行中提出问题

    codegraph agent context "your question"

使用前须知

  • balanced 和 full 索引层级需要预先安装外部语言服务器,例如 rust-analyzer、node 或 gopls。
  • 索引配置项和环境变量较多,初始设置需要一定精力。

收录于专题

标签

常见问题

codegraph-rust 是什么?
用 Rust 实现的代码知识图谱工具,通过 MCP 为编程智能体提供语义搜索和代码分析能力。 CodeGraph 会把项目索引成由节点和边组成的代码知识图谱,融合 AST 解析、可选的语言服务器符号解析、模块关联和向量嵌入。图谱存放在每个项目 .codegraph 目录下的内嵌 SurrealDB 中,无需单独部署数据库服务。
codegraph-rust 可以免费使用吗?用的什么许可证?
codegraph-rust 没有声明许可证。代码虽然公开,但没有许可证就没有明确的使用授权,正式使用前建议先联系作者。
codegraph-rust 还在维护吗?
活跃维护中。codegraph-rust 最近一次提交是在 2026年10月12日。
codegraph-rust 适合用来做什么?
在重构大型代码库前,为 Claude Code 或 Cursor 提供全项目上下文。 评估修改某个函数、类型或模块会影响哪些调用方和依赖。 在不熟悉的 Rust 项目中快速了解架构并定位复杂度热点。 使用本地自托管的嵌入模型,让源代码不离开本机。
codegraph-rust 怎么安装和运行?
按照安装指南(docs/INSTALLATION_GUIDE.md)安装 CodeGraph 使用 balanced 层级为项目建立索引: codegraph index /path/to/project --index-tier balanced 在命令行中提出问题: codegraph agent context "your question"
在哪里获取 codegraph-rust?
源代码和安装说明在 GitHub 上:https://github.com/Jakedismo/codegraph-rust

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目