Initial commit: Hermes skill rag-pipeline-docker

references/webui-session-cache-reset.md

@@ -0,0 +1,28 @@
+# 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 начнёт с чистого листа.