# 记忆 (mem0)

> 智能体跨会话共享的长期记忆：它们保存事实和决定，之后再回忆起来。保存在你的电脑上。

Source: https://docs.neurosquad.ai/zh/plugins/mem0-memory

会话一结束，智能体就会忘记一切。**记忆**插件为已连接的智能体提供长期记忆：它们保存值得记住的
内容——一个决定、一项约定、你的偏好、关于项目的事实——并在之后的会话中、在其他智能体里、在重启之后
再次找到它。

它基于 [mem0](https://github.com/mem0ai/mem0)，一个开源记忆引擎（Apache-2.0），内置于 NeuroSquad。
记忆保存在你的电脑上、NeuroSquad 的数据文件夹中。无需创建账号，也无需运行服务器。

## 使用方法

1. 在添加卡片菜单中选择 **插件**，在 **插件** 标签页打开 **记忆 (mem0)**，然后点击 **添加到画布**。
2. 从智能体向卡片画一条[箭头](https://docs.neurosquad.ai/zh/canvas/arrows)。

现在智能体拥有了记忆工具。让它记住点什么（"记住：只通过 GitHub Actions 部署"），或者照常工作——
智能体会被提示在可能依赖先前决定的工作之前先搜索记忆，并保存长期有效的事实。移除箭头，工具随之消失；
记忆仍保留在卡片上。

大多数智能体会立即获得这些工具，无需重启。Codex、Kimi Code、ZCode、PenguinHarness、Cursor 和 Crush 只在启动时读取一次工具
列表，因此它们从一开始就能看到记忆工具，由箭头决定调用能否通过。Qwen Code 和 Cline 会在下次启动时获得它们。

## 智能体能做什么

| 工具 | 作用 |
| --- | --- |
| `memory_search` | 查找与问题相关的记忆，最相关的在前 |
| `memory_add` | 保存一个事实（或一段需要从中提取事实的对话） |
| `memory_list` | 列出记忆，最新的在前 |
| `memory_get` | 读取一条记忆 |
| `memory_update` | 更正一条已经过时的记忆 |
| `memory_delete` | 遗忘一条记忆 |

智能体只能修改或删除**自己**保存的记忆。若要允许智能体编辑任何记忆——你的和其他智能体的——请在
卡片设置中打开 **智能体可以修改任何记忆**。

## 卡片

卡片显示共有多少条记忆，最新的在前，以及每条由谁、何时保存。智能体刚写入的记忆会短暂高亮。你可以
搜索、用 **+** 自己添加记忆、编辑或删除任何记忆、把全部记忆导出为 JSON 文件，以及清空记忆。

## 谁的记忆：范围

打开设置（卡片上的滑块图标），选择一个 **范围**：

- **此工作区**（默认）——此工作区中连接到记忆卡片的所有智能体共享同一份记忆。
- **所有工作区**——所有工作区共用一份记忆：适合处处适用的内容，例如你的偏好和约定。
- **每个智能体独立**——每个已连接的智能体都有自己的私有记忆；卡片会显示全部。

记忆属于范围，而不属于卡片：删除卡片后再添加一张同一范围的新卡片，记忆仍然在。设置中的 **清空**
会删除它们。

## 搜索：按词语或按语义

开箱即用时，卡片按**关键词**搜索——共同的词语及词片段，所以 "postgres" 能找到 "PostgreSQL"。
它无需任何设置、可离线使用，但不会关联同义词（"汽车" 和 "轿车"）。

若要**按语义**搜索，请在卡片上的**智能搜索**中点击**下载 150 MB**（或在 设置 → 搜索 中选择它）。
它只需下载一次一个小型多语言模型——在你的电脑上离线运行，理解中文、英文、俄文等数十种语言，
所以用中文提问也能找到用英文写下的记忆。每个文件都会校验其校验和。

你也可以使用来自 [OpenRouter](https://docs.neurosquad.ai/zh/providers/openrouter) 的嵌入模型，或你在 设置 → 提供商 中添加的、
支持 OpenAI API 的[模型服务器](https://docs.neurosquad.ai/zh/providers)——例如带 `nomic-embed-text` 的 Ollama，或 LM Studio。

该选择对所有记忆卡片生效。切换时，所有记忆会重建索引；卡片会显示进度，智能体会等待完成。

## 事实提取

默认情况下，记忆按原文保存。在 **事实提取** 中选择一个模型后，mem0 会把智能体保存的内容整理成简短
事实，并跳过已知的内容。每次保存会向该模型发送一次请求。

## 自动记忆

设置中有两个开关，默认都关闭：

- **自动回忆**——在你的每个提示之前，把最相关的记忆作为笔记附加到智能体的这一轮。适用于
**Claude Code**、**Codex**、**Qwen Code**、**OpenCode**、**Kilo Code**、**MiMo Code**、**Antigravity CLI**、**pi**、
**omp** 和 **ZCode**。其他智能体会自己用 `memory_search` 搜索。
- **自动保存**——已连接的智能体结束一轮时，你的提示和它的最终回答会交给事实提取模型，模型只保留
长期有效的事实（常常一条也没有）。需要事实提取模型。

## 历史、导出与导入

- 记忆上的时钟按钮会显示它的历史：何时添加，以及每次编辑和编辑前的文字。
- 设置中的**导出**会把卡片的记忆保存为 JSON 文件。**导入**读取这样的文件，显示有多少是新的、多少已经
存在（会被跳过），让你选择范围，然后添加新的记忆。卡片上的**撤销**只删除上一次导入添加的内容。

## WSL 和 SSH 工作区

位于 WSL 内或 SSH 主机上的工作区中的智能体以同样方式使用此卡片：箭头为它们提供 `memory_*` 工具，自动回忆通过提示钩子到达那里的 Claude Code。记忆本身保存在这台电脑上 NeuroSquad 的数据文件夹中——另一侧不存储任何内容——"此工作区"范围照常将各工作区的记忆分开。

## 删除工作区或智能体

删除工作区时，为它保存的记忆也会一并删除；删除智能体时，会删除它的私有记忆（“每个智能体独立”
范围）。确认对话框会写明数量。所有工作区共享的记忆会保留。

> 你的密钥留在 NeuroSquad 中：它们只会随每次请求发送给你选择的提供商。不会向 mem0 发送任何内容——
> 引擎自带的使用情况上报已关闭。

> 记忆是过去的笔记，而不是指令：它们可能已经过时。不要让智能体记住密码或密钥。
