Hermes Memory Architecture

Обзор

Hermes (Whale) использует thread-scoped memory + кастомную memory instruction. Глобальный профиль (USER.md) и thread-локальная память (MEMORY.md) — два независимых хранилища.

Состав системного промпта

Собирается в agent/system_prompt.py из трёх слоёв: stable (кешируется на сессию), context (зависит от CWD), volatile (каждый раз свежий).

Stable tier

SOUL.md — не существует (Whale), используется DEFAULT_AGENT_IDENTITY.
HERMES_AGENT_HELP_GUIDANCE — ссылка на https://hermes-agent.nousresearch.com/docs.
TASK_COMPLETION_GUIDANCE — «Finishing the job»: не фабриковать, не останавливаться на стабах.
Tool-aware guidance:
- MEMORY_GUIDANCE — declarative facts, не imperative, не task progress.
- SESSION_SEARCH_GUIDANCE — искать в прошлом session_search.
- SKILLS_GUIDANCE — сохранять сложные подходы как skills, патчить устаревшие.
Tool-use enforcement — TOOL_USE_ENFORCEMENT_GUIDANCE + per-model operational guidance (deepseek → OPENAI_MODEL_EXECUTION_GUIDANCE).
Skills prompt — список доступных скиллов из ~/.hermes/skills/.
Environment hints — macOS, home, cwd.
Active profile hint — «default», +предупреждение не лезть в чужие профили.
Platform hints — зависит от платформы (zulip/telegram/webhook/webui...).

Context tier

system_message — от платформы (например, содержимое входящего сообщения).
Context files — AGENTS.md, .cursorrules, .hermes.md из TERMINAL_CWD.

Volatile tier (не кешируется)

Memory — thread-scoped MEMORY.md.
USER.md — глобальный профиль.
Custom memory instruction — ~/.hermes/hermes-whale/review/memory_prompt.md.
Таймстемп — дата старта, session ID, model, provider.

Файлы конфигурации и кастомные промпты

~/.hermes/hermes-whale/review/skill_prompt.md — инжектится в background review (skill review).
~/.hermes/hermes-whale/review/memory_prompt.md — memory instruction.
prefill_messages_file — не задан.
personalities — пусто.
hooks — пусто.

Конфигурация

Файл: ~/.hermes/hermes-whale/config.yaml

memory:
  memory_enabled: true
  user_profile_enabled: true
  memory_char_limit: 3000
  user_char_limit: 1375
  provider: ''
  nudge_interval: 10
  flush_min_turns: 6
  thread_scoped: true                          # изолированная память по треду
  prompt_path: ~/.hermes/hermes-whale/review/memory_prompt.md  # кастомная инструкция

Файловая структура

~/.hermes/hermes-whale/memories/
├── MEMORY.md                          # глобальная (fallback для CLI/старых сессий)
├── USER.md                            # глобальная (всегда)
└── threads/
    ├── agent:main:webhook:webhook:webhook:whale/
    │   └── MEMORY.md                  # память конкретного треда
    └── ...

Memory prompt

Файл: ~/.hermes/hermes-whale/review/memory_prompt.md

Что запоминать

Документы — file paths, что изменено, почему.
После загрузки Obsidian docs — извлекать ключевые факты в memory.
Команды и инструменты — нетривиальные CLI вызовы, форматы конфигов.
Статус проекта — completed, pending, blockers, next steps.
Предпочтения пользователя — коррекции, фидбек.
Факты окружения — пакеты, порты, пути до credentials (не сами secrets).
Решения и обоснование выбора подхода.
Конфиг изменения — ключи/значения/пути.

Что НЕ запоминать

Временный debugging noise.
"Сейчас в процессе задачи X" — session_search покрывает.
Очевидные факты (rediscover за 2 сек).
Negative claims о сломанных инструментах — становятся persistent self-imposed constraints.

Особенности редактирования

patch() для точных замен, но не перенумеровывает списки.
После вставки пункта mid-list — проверить нумерацию, делать второй clean patch.

Команды

# Проверить текущую память
cat ~/.hermes/hermes-whale/memories/USER.md
cat ~/.hermes/hermes-whale/memories/MEMORY.md

# Структура файлов памяти
find ~/.hermes/hermes-whale/memories -type f -name "*.md"

# Редактировать prompt (через patch или write_file)

Связанное

thread-scoped-memory — план реализации.
personal/plans/thread-scoped-memory.md — детали тестов, pitfalls, коммиты.

5.5 KiB Raw Blame History