# Память (mem0)

> Долговременная память, общая для агентов между сессиями: они запоминают факты и решения и вспоминают их потом. Хранится на вашем компьютере.

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

Когда сессия агента заканчивается, он всё забывает. Плагин **Память** даёт подключённым агентам
долговременную память: они сохраняют то, что стоит помнить, — решение, договорённость, ваше
предпочтение, факт о проекте — и находят это снова в следующих сессиях, в других агентах, после
перезапуска.

В основе — [mem0](https://github.com/mem0ai/mem0), открытый движок памяти (Apache-2.0), встроенный в
NeuroSquad. Память хранится на вашем компьютере, в папке данных NeuroSquad. Ни аккаунта, ни сервера
не нужно.

## Как пользоваться

1. В меню добавления карточки выберите **Плагины**, откройте **Память (mem0)** на вкладке
**Плагины** и нажмите **Добавить на канвас**.
2. Проведите [стрелку](https://docs.neurosquad.ai/ru/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 МБ** в блоке **Умный поиск** на карточке (или выберите
его в Настройках → Поиск). Один раз скачается небольшая многоязычная модель — она работает на вашем
компьютере, офлайн и понимает русский, английский, китайский и десятки других языков, так что вопрос
по-русски находит запись, сделанную по-английски. Каждый файл сверяется с контрольной суммой.

Можно также взять модель эмбеддингов из [OpenRouter](https://docs.neurosquad.ai/ru/providers/openrouter) или с
[сервера моделей](https://docs.neurosquad.ai/ru/providers), добавленного в Настройки → Провайдеры, который говорит на OpenAI API, —
например, Ollama с `nomic-embed-text` или 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 ничего не отправляется — собственная статистика движка отключена.

> Записи — это заметки из прошлого, а не инструкции: они могут устареть. Не просите агента
> запоминать пароли и ключи.
