Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Долговременная память Велес: технический справочник

Велес использует многослойную систему памяти, которая позволяет Велесу сохранять важные факты, структурировать историю диалогов и восстанавливать точные стенограммы прошлых бесед без перегрузки рабочего контекста.

​
Архитектура памяти

Память Велес разделена на четыре функциональных слоя:

​
1. Курируемая память (MEMORY.md)

Это «золотой фонд» знаний об авторе, проекте и правилах. Данные здесь структурированы и подаются в системный промпт при каждом запросе.
  • Инструмент: save_memory (вызывается Велесом для обновления фактов).
  • Путь: memory/MEMORY.md.

​
2. Дневные логи (memory/YYYY-MM-DD.md)

Используются для «экстренного сброса» памяти при переполнении контекстного окна. Если диалог становится слишком длинным, Велес выписывает в этот файл ключевые тезисы перед тем, как старые сообщения будут удалены из активной памяти.
  • Срабатывание: автоматическое, при достижении порога токенов.

​
3. Резюме сессий (memory/YYYY-MM-DD-HHMM-slug.md)

Каждый раз, когда вы начинаете новую сессию (команда /new), Велес создает краткий, структурированный отчет о завершенном разговоре.
  • ID сессии: записывается в файл для связи с полной стенограммой.
  • Поиск: эти файлы индексируются для семантического поиска инструментом memory_search.

​
4. Архив стенограмм (sessions/archive/*.jsonl)

Это «черный ящик», где хранятся дословные записи всех прошлых разговоров в формате JSONL.
  • Индекс: файл sessions/_sessions.jsonl связывает темы (slug), ID сессий и пути к файлам.
  • Инструменты: session_list (поиск сессии) и session_history (чтение стенограммы).

​
Как Велес вспоминает прошлое (Recall)

Существует три режима восстановления информации:

​
1. Мгновенный (из MEMORY.md)

Велес сразу «знает» ваши предпочтения, технический стек и правила, так как они всегда находятся в его активном контексте. Применяется для самых важных, постоянных фактов. Агент ищет информацию в базе своих резюме (memory/*.md). Это полезно для вопросов типа: «О чем мы договорились на прошлой неделе касательно интеграции с Redis?». Поиск работает по смыслу (семантически), а не только по ключевым словам.

​
3. Точное восстановление истории

Если Велесу нужен дословный текст сообщения или точный вывод команды из прошлого, он использует связку:
  1. session_list — находит нужный session_id в списке завершенных бесед.
  2. session_history — загружает полную стенограмму по этому ID.

​
Жизненный цикл сессии

  1. Активная фаза: Сообщения записываются в текущую сессию (live session).
  2. Сброс (Flush): При нехватке места важные детали выписываются в дневной лог.
  3. Консолидация: Агент периодически обновляет MEMORY.md, добавляя туда новые устойчивые знания.
  4. Завершение (/new):
    • Рабочее окно очищается.
    • Создается резюме сессии (memory/YYYY-MM-DD-...md).
    • Стенограмма сохраняется в архив (sessions/archive/...jsonl).
    • Запись добавляется в индекс _sessions.jsonl.

​
Как помочь Велес помнить лучше

  • Будьте явными: фразы «запомни, что я предпочитаю…» или «это наше новое правило архитектуры» значительно повышают вероятность попадания факта в долгосрочную память.
  • Актуализируйте: если правило изменилось, скажите об этом: «Мы больше не используем библиотеку X, теперь работаем через Y».
  • Используйте /new: завершение логических блоков работы командой /new помогает Велесу структурировать свои отчеты и делает поиск по архиву более точным.

​
Итог

Система памяти Велес позволяет не выбирать между «забыть всё» и «медленно перечитывать всю историю». Агент сохраняет только суть в промпте, умеет эффективно искать по архиву смыслов и всегда может «поднять» точную запись любого разговора по вашему требованию.