Память (Memory)

Kodik может запоминать факты, договорённости и контекст, которые должны сохраняться между отдельными задачами. Для этого используется инструмент memory.

Как работает инструмент `memory`

Во время выполнения задачи агент может вызвать инструмент memory с тремя параметрами:

Параметр	Описание
`scope`	Область хранения: `workspace` или `global`
`path`	Имя файла памяти (без пути к директории, только имя)
`content`	Содержимое для сохранения (Markdown)

Чтобы удалить запись, агент передаёт параметр delete: "true" вместо content.

Путь — это просто имя файла без директорий. Расширение .md добавляется автоматически, если его нет. Абсолютные пути и символы .. не разрешены.

Области хранения

Память рабочего пространства

Файлы хранятся в .kodik/memories/ в корне текущего проекта. Эта память относится только к данному проекту и может быть добавлена в систему контроля версий.

Пример файла: .kodik/memories/testing-conventions.md

Глобальная память

Файлы хранятся в директории ~/.kodik/memories/ (на Windows — C:\Users\<Пользователь>\.kodik\memories\). Глобальная память доступна во всех проектах и рабочих пространствах.

Kodik загружает и записывает память только в строчной .kodik/memories. Uppercase-каталоги Memories не перемещаются, не объединяются и не удаляются; их байты остаются без изменений, а содержимое неактивно. Нужные файлы перенесите вручную в строчный каталог. Память workspace разрешается из точного выбранного workspace, неактивна до предоставления доверия этому workspace и никогда не загружается из .agents.

Ссылочные директории .kodik и memories, а также ссылочные файлы памяти отображаются как неактивные: Kodik не загружает их в промпт агента и не изменяет. Чтобы Kodik мог использовать и управлять ими, скопируйте содержимое в обычную lowercase-директорию .kodik/memories/.

Загрузка в контекст агента

При каждом запуске задачи Kodik загружает файлы памяти workspace и global в системный промпт. Они попадают в раздел промпта Memory в исходном виде. Для каждой долговременной области существует лимит — не более 200 строк и 12 000 символов, и первая запись тоже в него входит. Всё, что не поместилось, остаётся в файлах; пометка об обрезке указывает агенту, какой файл прочитать, если подробности нужны. Актуальные данные проекта важнее устаревшей памяти.

Каждая отдельная запись памяти не может превышать 16 КБ.

Поскольку файлы памяти — это обычные .md-файлы, их можно просматривать и редактировать вручную. Kodik также автоматически удаляет значения, похожие на секреты (токены, ключи API), перед записью.

Практические советы

Просите агента сохранить конвенции команды, предпочтения по стилю кода или детали архитектуры в память рабочего пространства — они будут автоматически присутствовать в следующих сессиях.
Используйте глобальную память для личных предпочтений, которые применимы ко всем проектам (например, предпочтительный язык для ответов).
Файлы памяти можно создавать или редактировать вручную — Kodik загрузит их так же, как созданные агентом.
Чтобы проверить, что именно сохранено, откройте .kodik/memories/ в проводнике или ~/.kodik/memories/ для глобальной памяти.