Документация

Если что-то пошло не так

Частые ситуации и что нажать: движок «не подключён», лимит подписки, кнопка выключена из-за подписки, агент не запускает проект, превью на чужом порту, автоочередь не включается, зависшая сессия.

Симптом	Что делать
Агент не запускается, движок «не подключён»	«Настройки → Окружение»: там кнопки «Установить» и «Войти». После установки — «Проверить снова».
Режим или кнопка выключены с подписью «доступно в подписке»	Так выглядят платные функции в бесплатной версии: «Дирижёр», «Фьюжн», «Оркестратор», «Авто», «Фабрика», поиск инструкций, свой сервер, MCP. Ключ вводится в «Настройки → Лицензия» — см. установку.
Сессия встала с бейджем «ждёт сброса лимита»	Подписка упёрлась в окно. Можно подождать (агент продолжит сам), переключить аккаунт в пикере рядом с моделью или сменить движок — см. лимиты.
Агент пишет «не могу запустить проект»	В копии проекта нет файла, которого нет в git. Пропишите его в `copy` или шаг установки в `setup` — см. настройку копии.
Превью открывается не на том порту	Порт у каждой сессии свой; используйте `VIBEFORGE_SESSION_PORT`, а не жёстко прописанный номер. Если dev-сервер упал — кнопка «Попросить агента починить запуск» прямо в кадре.
Кнопка слияния недоступна	Причина написана текстом под самой кнопкой — там же, где стоит вывод о готовности работы. Пока агент работает, слить нельзя.
Pull request не создаётся	Нужны origin у проекта и вход в GitHub («Настройки → GitHub» или `gh auth login`). Для GitLab — токен в «Интеграциях» с правом `api`. Ошибка видна в ленте.
Сообщение не дошло агенту сразу	У Codex, Grok и Gemini нет живого канала посреди хода — указание доставится следующим ходом; строка над полем ввода об этом предупреждает.
Автоочередь не включается	Предполётная проверка называет причину: несохранённые правки в копии, сессия «Прямо в проекте» (нужна своя копия), движок без входа на сервере, оркестратор (ему автоочередь недоступна).
«Фабрика» пишет «Этот бэкенд не знает Фабрику»	Приложение подключено к серверу со старой версией бэкенда. Обновите сервер из «Настройки → Сервер».
Сессия «зависла» после перезапуска приложения	Такие сессии помечаются как приостановленные — продолжите обычным сообщением в тот же диалог.
Голос молчит	Первая фраза скачивает модель распознавания (~150 МБ). Проверьте ffmpeg в «Окружении».
Нет пушей на телефон	Пуши идут только через relay проекта; на своём relay их нет. Проверьте, включён ли удалённый доступ в «Настройки → Companion».
Ключ не активируется на втором компьютере	Ключ привязан к одному компьютеру. Напишите в поддержку — отвяжем от старого.

Куда писать

Если ничего из перечисленного не подошло — напишите в поддержку: support@vibe-forge.ru. Пригодятся версия приложения (она в «Настройки → О программе»), система и что именно происходило перед сбоем. Если локальный бэкенд не запускается, окно само говорит почему и даёт скопировать журнал — приложите его.