代码图谱
要回答“谁调用了 processOrder?”,智能体通常会 grep、打开一个文件、再 grep、再打开下一个——在用不上的代码上花掉成千上万个 token。代码图谱插件借助 DeusData 的开源引擎 codebase-memory-mcp ,把工作区的代码索引成知识图谱——函数、类、方法、调用、导入、路由。连接的智能体直接查询图谱,一次调用就能得到答案。
如何使用
- 在添加卡片菜单中选择 插件,在 插件 标签页打开 代码图谱,然后点击 添加到画布。
- 在卡片上点击 下载。NeuroSquad 会从 GitHub 下载 codebase-memory-mcp 的官方版本(约 40 MB,解压后约 300 MB),并与应用内固定的校验和比对——不匹配的文件会被删除。只需下载一次。
- 点击 构建图谱。大多数项目只需几秒,超大项目需要几分钟。
- 从智能体画一条箭头到卡片。
现在智能体拥有了图谱工具。大多数 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 许可证发布。