Files
rag-pipeline-docker/references/webui-session-cache-reset.md
T
2026-09-06 13:51:06 +00:00

28 lines
1.6 KiB
Markdown

# WebUI Session Cache Reset (Post-Agent-Update)
## Симптомы
После обновления Hermes agent (особенно 0.19.x → 0.20.x+):
- WebUI бесконечно показывает "Loading conversation..."
- Создание нового чата не помогает
- Даже ответ в существующем чате не рендерится
- Формат сессий на диске изменился, старый фронтенд не может его отрендерить
## Фикс
```bash
# 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 начнёт с чистого листа.