Если что-то не работает

На этой странице — самые частые сбои и что с ними делать. Почти всегда приложение само говорит обычными словами, что случилось. Если вашего случая здесь нет или совет не помог, отправьте отчёт, как описано в разделе «Поддержка».

#Связь с сервером

#«Сервер не отвечает» внизу слева

Приложение не может достучаться до сервера DevMachine. Чаты, файлы и git работают как обычно, а агент ответит, когда связь вернётся. Приложение проверяет её каждые 15 секунд.

Карточка сама подсказывает причину:

Чтобы не ждать следующей проверки, нажмите «Проверить сейчас».

#VPN: как внести DevMachine в исключения

DevMachine работает из России без VPN. Если VPN нужен для других программ, пустите DevMachine мимо него:

1. Откройте инструкцию: нажмите «Как настроить» на карточке связи внизу слева или «Внести DevMachine в исключения VPN» над пустым чатом. Если VPN есть, например на роутере, а приложение его не видит, нажмите «У меня включён VPN».
2. Откройте настройки программы VPN и найдите раздельное туннелирование. Раздел может называться «Исключения», «Split tunneling» или «Маршрутизация».
3. Скопируйте адреса из окна приложения кнопкой «Скопировать» и добавьте их туда. Если исключить всю программу, для агента это может не сработать, поэтому нужны именно адреса.
4. Сохраните настройки VPN и нажмите «Проверить». Если всё получилось, появится надпись «Готово. DevMachine ходит к серверу напрямую».

#Ответы модели

#Строка «… — повтор через N с» над полем ввода

Запрос к модели не прошёл, и агент сам повторит его через несколько секунд. Строка выглядит, например, так: «Лимит запросов — повтор через N с» или «Нет связи с сервером — повтор через N с». В ней же видно, какая это попытка по счёту. В списке чатов такой чат помечен «Ждёт повтора».

Ничего делать не нужно. Чтобы не ждать, нажмите «Повторить сейчас», а чтобы прервать — «Остановить ход».

#Модель долго не отвечает

Если от модели около двух минут ничего не приходит, агент обрывает этот шаг и повторяет его сам. Время, пока агент ждёт вашего решения на карточке разрешения, в этот срок не входит.

Если повторы не помогают:

1. Нажмите «Остановить» и отправьте задачу ещё раз. Пока агент работает, «Остановить» стоит в поле ввода на месте кнопки отправки. Значок «Остановить ход» на строке повтора делает то же самое.
2. Выберите другую модель в меню под полем ввода.
3. Проверьте связь: нет ли внизу слева карточки «Сервер не отвечает».

#Ход закончился ошибкой

У ошибки в чате есть кнопки «Повторить ход», «Подробности» и «Сообщить».

#Агент остановился: лимит или подписка

Карточка «Лимит периода исчерпан…», «Пробный период закончился…» или «Подписка истекла…» — это не ошибка. Задача сохранена: после оплаты нажмите «Продолжить задачу», и агент вернётся к ней с того места, где остановился. Подробнее — в разделе «Тарифы и лимиты».

#Вход

#Браузер не вернул в приложение

1. Проверьте, что вход в браузере завершён.
2. На экране входа нажмите «Открыть ссылку снова» и ещё раз завершите вход.
3. Не помогло — нажмите «Отмена», а затем снова «Войти через браузер».

Если приложение пишет «Вход уже запущен — завершите его в браузере», значит, предыдущая попытка ещё ждёт. Завершите её во вкладке браузера или нажмите «Отмена».

#Вход по коду: Linux и проект на сервере

На Linux и в проекте на сервере по SSH браузер не возвращает в приложение: вход подтверждается кодом. Откройте ссылку с экрана входа в браузере на любом компьютере и проверьте, что код на странице совпадает с кодом в приложении.

#«Вы больше не в организации» или «Организация приостановлена»

Первое сообщение значит, что вас исключили из организации, второе — что организацию приостановили. Если исключили, нажмите «Войти снова» — войдёте в личный аккаунт. Если приостановили, напишите владельцу организации, а когда приостановку снимут, нажмите «Проверить снова». Подробнее — в разделе «Аккаунт и веб-кабинет».

#Запуск агента

#«Запускаем движок» не проходит

Экран «Запускаем движок» виден, пока приложение запускает агента на вашем компьютере. Обычно запуск занимает до 5 секунд. Если экран висит дольше, нажмите «Другой проект» справа под полосой загрузки и выберите тот же проект снова. Не помогло — перезапустите приложение.

#«Движок не запустился» или «Движок остановился»

Агент на компьютере не смог запуститься или остановился. Чаты и изменения при этом сохранены. На экране видны причина и последние строки журнала.

1. Нажмите «Перезапустить».
2. Не помогло — нажмите «Сообщить»: текст ошибки и журнал попадут в отчёт сами.
3. Чтобы посмотреть журнал целиком, нажмите «Весь журнал».

Если при запуске вместо этого экрана приложение просит оплатить, у аккаунта кончился тариф или лимит. Оплатите кнопкой на экране, вернитесь в приложение и нажмите «Проверить снова».

#«Часть окна не отрисовалась»

Сломалось только то, что было на экране: сессии, файлы и настройки целы. Нажмите «Попробовать снова» или «Обновить окно».

#«Агент остановлен аварийным рубильником»

Агента выключили аварийной остановкой, «рубильником»: она останавливает агента целиком, во всех чатах, пока вы сами его не включите. Срабатывает она от кнопки или сочетания ⇧ ⌘ Esc (Ctrl Alt Shift Esc на Windows и Linux). Пока агент выключен, чаты и терминалы работают, но запросы к модели не отправляются. Чтобы включить его, нажмите «Включить агента» над полем ввода или на плашке «Агент остановлен» в шапке. Подробнее — в разделе «Аварийная остановка».

#Обновления

#«Обновление не скачалось»

Причина написана под ошибкой: «Связь прервалась во время скачивания…», «Файл пришёл повреждённым…», «На диске не хватает места…» или «Сервер обновлений не отдал файл…». Устраните причину и нажмите «Повторить».

#macOS: «Перетащите приложение в «Программы» и перезапустите его»

Приложение запущено прямо из образа диска или лежит в папке, куда ему нельзя писать, поэтому заменить себя оно не может. Перетащите DevMachine ADE в «Программы» и запускайте оттуда: следующие обновления встанут сами.

#Linux: приложение не обновляется само

Так и задумано. Если приложение ставили командой для всех пользователей, скопируйте команду обновления внизу слева или в «Настройки → О приложении». Выполните её в терминале через sudo и перезапустите приложение. Если запускаете приложение из распакованного архива, скачайте новый архив со страницы загрузки. Подробнее — в разделе «Установка и обновления».

#Новая версия есть, но «сборки для этой платформы нет»

В новой версии нет сборки для вашей системы. Кнопка откроет страницу загрузок: посмотрите, есть ли там сборка для вашего компьютера.

#Проекты

Подробнее — в разделе «Проекты».

#Где найти журнал

• «Настройки → О приложении». Строка «Агент» показывает его состояние: «запускается», «готов», «нет проекта», «вход не выполнен», «нужна оплата» или «ошибка». Ниже — «Технический журнал приложения» и кнопка «Открыть журнал». Когда пишете в поддержку, приложите этот журнал.
• Экран «Движок не запустился» — кнопка «Весь журнал».
• Экран входа — «▸ Журнал» с техническими строками о попытке входа.

Технический журнал и «Журнал действий» агента — разные журналы. В журнале действий записано, что агент сделал и что вы ему разрешили.

#Что дальше

• Поддержка — как отправить отчёт об ошибке и куда писать.
• Установка и обновления — как обновить приложение вручную.
• Контекст и расход — что делать, если история чата стала слишком большой.