# 代码图谱

> 把智能体连接到它，智能体就能按结构找代码——谁调用了某个函数、它又调用了什么、某个符号在哪里定义——而不是一遍遍 grep、一个个读文件。

Source: https://docs.neurosquad.ai/zh/plugins/code-graph

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

## 如何使用

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

现在智能体拥有了图谱工具。大多数 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 许可证发布。
