Устранение неполадок и частые вопросы

Начните с сообщения об ошибке операции, затем проверьте состояние проекта, агента и задачи. Следующие разделы помогут найти нужные действия при распространённых проблемах.

Первоначальная настройка не даёт перейти в рабочую область

Для первоначальной настройки хотя бы один агент должен быть установлен, авторизован и проверен. Одной установки или закрытия окна входа недостаточно: в списке должен появиться статус Готов (Ready).

Откройте сведения об этом агенте, решите проблему входа, сети или проверки и попробуйте снова. См. статью Установка и подготовка.

Загрузка не удаётся или остаётся на стадии подготовки

Сначала проверьте сеть и системный прокси HTTP(S). Переменные окружения прокси имеют приоритет; этот механизм не поддерживает прокси SOCKS. Статус подготовки может появиться, когда поступление данных приостанавливается. Следите за обновлением состояния и повторите попытку, если появится ошибка.

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

Вход выполнен, но агент всё ещё недоступен

Noea определяет готовность агента по результатам проверки. Проверьте учётную запись или провайдера, доступную квоту и конфигурацию модели. Для OpenCode обновите список провайдеров, проверьте подключение и повторите проверку.

Если для выбора модели сначала нужно подключение, подключите сеанс и проверьте снова. Настройка, поддерживаемая одним агентом, не обязательно поддерживается другим.

Проект не открывается

Ситуация	Что делать
Выбранная папка не является проектом Noea.	Для кода используйте Open Implementation Folder, а для существующего проекта выберите его настоящую папку.
Папка проекта перемещена.	Укажите её текущее расположение через Open Existing Noea Project.
Папка проекта удалена.	Перед повторным открытием восстановите её из Корзины или резервной копии.
Конфигурация недействительна.	Сохраните исходное содержимое. Изучите конфигурацию или отправьте диагностику; не перезаписывайте её повторной инициализацией.
Данные записала более новая версия приложения.	Обновите приложение, затем откройте проект снова.
Версия данных несовместима.	Сохраните копии данных проекта и приложения, затем следуйте конкретному сообщению. Не перезаписывайте несовместимые данные.

Требования читаются, но чаты не запускаются

Проверьте папку реализации в Settings → Current Project → Project. Привяжите её, если связь отсутствует, или укажите новое расположение исходной папки кода, если прежний путь недоступен.

Также проверьте, что агент имеет статус Ready. Возможность читать файлы требований не означает готовности папки реализации и агента.

Объяснение отсутствует или кажется неверным

Сохраните требования, затем исследуйте соответствующий абзац или запустите Объяснить (Explain) на боковой панели. Если требование предполагает изменение кода, сначала реализуйте его в чате, а затем проводите исследование.

Прежний текст (Previous text) относится к требованиям до правки. Может устареть (May be outdated) означает, что позже изменились подтверждающие файлы. Перепроверьте оба статуса по текущему содержимому; см. статью Поддерживайте объяснения в актуальном состоянии.

Метка Изменения не найдены (No changes found) на боковой панели не означает, что все тесты проходят или пробелов больше нет.

Explain не запустился после реализации

Проверьте Settings → Current Project → Automation → Explain automatically after implementing. Изменения только кода в обычных чатах, действие Implement Directly и неудачные или остановленные запуски реализации его не запускают.

При необходимости запускайте Explain вручную. Если задача закончилась, но сообщает о неудачных или незавершённых проверках, разверните результаты, устраните причину и запустите её снова. Полные правила автоматического запуска описаны отдельно.

Предложение или план организации нельзя принять

Если предложение сообщает, что документ изменился, выберите Ask Agent to Re-propose on Current Version. Для устаревшего плана организации выберите Упорядочить заново (Reorganize).

Обычные предложения позволяют редактировать добавленный или заменяющий текст, но не поддерживают принятие отдельных изменений или файлов. Упорядоченные черновики доступны только для чтения; перед принятием всего плана можно сохранить элементы, предлагаемые к удалению.

Нужно ли повторно отправлять сообщение после ошибки?

Если Noea сообщает, что сообщение не дошло до агента, отправку можно повторить. Если оно могло дойти, сначала изучите ход выполнения и изменения файлов, чтобы избежать повторного выполнения.

Если агент получил сообщение, но остановился посреди задачи, отправьте новую инструкцию проверить текущее состояние и продолжить. Карточка предложения с меткой Реализация не завершена (Implementation not finished) также предлагает Продолжить реализацию (Continue Implementing).

Редактирование сообщения, создание ветки чата или остановка запуска не отменяют изменений файлов.

Сервер MCP или навык не действует

Для MCP используйте Test Connection и по результату проверьте команду, URL, авторизацию и переменные окружения. Даже после успешной проверки убедитесь, что сервер выбран в чате и агент поддерживает его способ подключения.

Изменения конфигурации MCP требуют повторного подключения агента. После добавления или удаления навыка нужен новый чат. Explain и задачи организации не используют эти расширения. См. статью Добавляйте серверы MCP и навыки.

Не удаётся сохранить или открыть ссылку

Конфликт сохранения означает, что другая операция изменила файл на диске, пока вы его редактировали. Сохраните текущий текст отдельно или перезагрузите версию с диска. Перезагрузка отбросит несохранённые правки.

Если ссылка не работает, проверьте, существует ли ещё файл или материал и доступна ли папка реализации. Если старое объяснение больше не соответствует документу, вернитесь к его абзацу, прочитайте последнее объяснение и при необходимости исследуйте снова.

Отправьте команде полезные сведения

Используйте Feedback на боковой панели, чтобы описать свою цель, фактический результат и шаги, приведшие к проблеме. Оставьте адрес электронной почты для ответа или напишите на [email protected].

Если нужна диагностика, экспортируйте её из Settings → About или скопируйте с панели сведений об агенте. Диагностика может содержать локальное состояние и журналы, поэтому изучите её перед отправкой. Отзыв не прикрепляет эти файлы автоматически.