Skip to Content
插件代码图谱

代码图谱

要回答“谁调用了 processOrder?”,智能体通常会 grep、打开一个文件、再 grep、再打开下一个——在用不上的代码上花掉成千上万个 token。代码图谱插件借助 DeusData 的开源引擎 codebase-memory-mcp ,把工作区的代码索引成知识图谱——函数、类、方法、调用、导入、路由。连接的智能体直接查询图谱,一次调用就能得到答案。

如何使用

  1. 在添加卡片菜单中选择 插件,在 插件 标签页打开 代码图谱,然后点击 添加到画布。
  2. 在卡片上点击 下载。NeuroSquad 会从 GitHub 下载 codebase-memory-mcp 的官方版本(约 40 MB,解压后约 300 MB),并与应用内固定的校验和比对——不匹配的文件会被删除。只需下载一次。
  3. 点击 构建图谱。大多数项目只需几秒,超大项目需要几分钟。
  4. 从智能体画一条箭头到卡片。

现在智能体拥有了图谱工具。大多数 CLI 无需重启即可使用;移除箭头,工具随之消失。

智能体能做什么

工具回答什么问题
codegraph_search_graph按名称、模式或语义查找函数、类等符号
codegraph_trace_path谁调用了这个函数、它又调用了什么,可追溯多层
codegraph_get_code_snippet单个符号的源码,无需打开整个文件
codegraph_query_graph只读 Cypher 查询,用于多步问题
codegraph_get_architecture语言、包、入口点、路由、热点
codegraph_search_code按图谱排序的文本搜索
codegraph_get_file_outline一个文件中声明的所有内容
codegraph_detect_changes未提交的改动影响了哪些符号
codegraph_get_graph_schema、codegraph_index_status、codegraph_check_index_coverage图谱里有什么、有多完整
codegraph_reindex刚改完代码,立即重新索引

你也可以直接说:“用代码图谱找出所有调用 validateOrder 的地方”。

卡片

  • 核心数据——图谱中有多少符号,以及文件、调用和关系的数量,是否已是最新。
  • 搜索框——输入名称,看看它定义在哪里。
  • 包含内容——函数、接口、类、类型,以及项目使用的语言。
  • 使用它的智能体,以及每个智能体最近一次查询图谱。

始终保持最新

开启 自动更新(默认开启)后,卡片会发现文件变化,几秒后重新索引——只处理变化的部分,所以很快。已连接的智能体结束一个回合后,它也会刷新图谱。关闭后可以用 立即更新 手动更新。

图谱基于工作区文件夹构建。在隔离 worktree 中工作的智能体查询的仍是主文件夹的图谱。

WSL 和 SSH 工作区

对于 WSL 内或 SSH 主机上的工作区,引擎在那里、在代码旁边运行。卡片会显示位置——WSL · Ubuntu 或 SSH · 你的主机:

  • 下载会获取引擎的 Linux 版本(x86-64 或 ARM64,按主机 CPU 选择)并在本机校验;第一次构建图谱时把它复制到那一侧 NeuroSquad 自己的文件夹(~/.neurosquad),再次校验并在那里解压——每个发行版或主机只需一次。
  • 图谱也保存在该文件夹中。不会往那边的项目或主目录其他位置写入任何内容,代码也不会传到这台电脑:智能体只得到查询的答案。
  • 保持最新:对于位于 Windows 磁盘(/mnt/c/…)上的 WSL 项目,卡片照常监视文件;其他情况下在已连接智能体的回合结束后以及点击立即更新时更新。
  • 删除卡片(或工作区)会删除那一侧的图谱;退出 NeuroSquad 会停止那里的引擎。

引擎只在 Linux 上运行:运行 macOS 的 SSH 主机会显示”此主机没有引擎版本”。

隐私与存储

一切都在你的电脑上运行。codebase-memory-mcp 不向任何地方发送数据——无需账号、没有遥测,代码不会离开本机。引擎和图谱保存在 NeuroSquad 的数据文件夹中:不会往你的项目或主目录写入任何内容;如果你自己装了 codebase-memory-mcp,它会继续独立工作。删除卡片,它的图谱也会一并删除。

codebase-memory-mcp 由 DeusData 开发,基于 MIT 许可证发布。