rag-pipeline-docker/references/webui-session-cache-reset.md

WebUI Session Cache Reset (Post-Agent-Update)

Симптомы

После обновления Hermes agent (особенно 0.19.x → 0.20.x+):

• WebUI бесконечно показывает "Loading conversation..."
• Создание нового чата не помогает
• Даже ответ в существующем чате не рендерится
• Формат сессий на диске изменился, старый фронтенд не может его отрендерить

Фикс

# 1. Сбросить кэш сессий внутри контейнера WebUI
docker exec hermes-webui sh -c 'rm -rf /home/hermeswebui/.hermes/webui/sessions/*'

# 2. Перезапустить WebUI
cd /opt/hermes/docker && docker compose restart hermes-webui

# 3. Открыть в браузере приватное/инкогнито окно (чтобы не было клиентского кэша)

Почему это происходит

Hermes WebUI — отдельный контейнер со своим образом. Когда агент обновляется (через !hermes update), сессии на диске могут изменить формат (новые поля, другая структура context_messages). WebUI-образ не обновляется автоматически — он остаётся старым и не умеет парсить новые сессии.

Радикальное решение: сбросить кэш старых сессий, WebUI начнёт с чистого листа.