Диагностика¶
Проверенные симптомы и решения для пользовательских сценариев. Если проблема не описана — загляните в FAQ и проверьте логи (см. раздел «Где смотреть логи»).
| Симптом | Раздел |
|---|---|
| Интерфейс не обновляется после входа, ответы «зависают» | Обновление интерфейса |
Агент не может открыть или изменить файл, ответ Permission denied |
Защищённые пути |
| Модель не отвечает или отвечает ошибкой | Провайдер не отвечает |
Интерфейс не обновляется после входа¶
Симптом: после входа через форму логина сообщения, статусы, план и todo не появляются сами — приходится обновлять страницу, чтобы увидеть результат.
Причина: в локальном режиме вход через форму использует cookie, а канал реального времени (WebSocket) после такого входа может не отдавать события. Это известное ограничение текущей версии, а не поломка данных: ответы модели выполняются и сохраняются, просто интерфейс не получает их мгновенно.
Что делать:
- Обновите страницу (F5) — уже готовые ответы и статусы подтянутся.
- Войдите по API-ключу. Вход по ключу передаёт его в заголовке, и канал реального времени подключается корректно — обновления снова приходят сами.
- Проверьте сеть. Если вы за корпоративным прокси или VPN, убедитесь, что он не разрывает долгоживущие WebSocket-соединения. При недоступности WebSocket интерфейс переключается на резервный потоковый канал (SSE); если заблокированы оба, остаётся ручное обновление страницы.
Как быстро проверить
Отправьте короткое сообщение и подождите. Если через несколько секунд ответ есть в логах и в истории, но не виден в ленте — это описанный выше случай, а не потеря данных.
Защищённые пути¶
Симптом: агент не может прочитать или изменить файл, хотя доступ к нему
должен быть разрешён. В ответе — Permission denied.
Причина: по умолчанию включена защита критичных путей. Она действует для всех файловых инструментов и shell-команд и имеет приоритет выше обычных правил доступа. Это осознанная защита, а не ошибка.
Что делать:
- Откройте раздел «Безопасность» в настройках и посмотрите список защищённых путей.
- Если нужный путь попал туда по ошибке — добавьте его в исключения (override), чтобы разрешить доступ к нему.
- Если защита мешает на вашем персональном инстансе, её можно отключить тумблером в том же разделе. В командном режиме это делает администратор.
Осторожно с исключениями
Снимайте защиту только с тех путей, в которых уверены. Защищённые пути закрывают доступ к системным и чувствительным файлам.
Провайдер не отвечает¶
Симптом: модель не отвечает, запрос завершается ошибкой или долго висит.
Что проверить по порядку:
- Провайдер включён и выбран. В разделе «Провайдеры» убедитесь, что нужный провайдер активен, а для сессии выбрана существующая модель.
- Адрес и ключ. Для OpenAI-совместимых и Anthropic-совместимых API
проверьте базовый URL и ключ. Для локальных моделей убедитесь, что Ollama
запущена и модель загружена (
ollama pull <модель>). - Сеть. Проверьте, доступен ли адрес провайдера с машины сервера — особенно внутри корпоративной сети и за прокси.
- Ограничения. Проверьте журнал аудита: возможен лимит частоты запросов или отклонённый вызов. В командном режиме часть ограничений задаёт администратор.
- Другая модель. Попробуйте другую модель или провайдера, чтобы отделить проблему конкретной модели от проблемы доступа.
Если ошибка сохраняется, посмотрите текст в интерфейсе: он подсказывает, это ошибка ключа, сети или ограничения.
Где смотреть логи¶
В режиме локальной разработки сервисы пишут журналы в каталог tmp/:
| Сервис | Файл |
|---|---|
| Backend | tmp/backend.log |
| Интерфейс | tmp/ui.log |
Локальное ядро (synth serve) |
tmp/core.log |
В командном режиме журналы собирает администратор. Пользовательская история запросов к моделям (кто, когда, какая модель, сколько токенов) доступна в разделе «Аудит» веб-интерфейса.