23 · Настольное приложение
Диагностика и поддержка
Прочитайте сообщение приложения и запишите время ошибки. Если рекомендации ниже не помогли, обратитесь в поддержку — см. подраздел «Обращение в поддержку» ниже.
Часть сообщений ядра выводится на английском языке. Для обращения в поддержку сохраняйте сообщение целиком, включая технические детали.
| Симптом | Действие |
|---|---|
| Показан экран входа АСТРА ИИ [ХАБ] | Нажмите кнопку входа, завершите вход в браузере и вернитесь в приложение; см. раздел «Вход и аккаунт АСТРА ИИ [ХАБ]» |
| Вход не завершается | Проверьте, открывается ли страница входа АСТРА ИИ [ХАБ] в браузере, и повторите вход. Если после входа в браузере открылась страница с кодом ошибки, например Не удалось завершить вход (token_exchange_failed), см. подраздел «Страница после входа». При повторной ошибке сохраните её текст и код и обратитесь в поддержку |
| При каждом входе страница АСТРА ИИ [ХАБ] снова просит пароль («Please re-authenticate to continue») | Так задумано: приложение всегда просит заново проверить учётную запись. Введите пароль или нажмите ГК Астра; см. подраздел «Повторный ввод пароля» |
| Срок действия входа истёк (сообщение «Сессия АСТРА ИИ [ХАБ] истекла») | Нажмите Войти снова, затем проверьте модель |
| Нет моделей или исчезла прежняя | Если в меню моделей у поля ввода есть кнопка Обновить модели, нажмите её. Проверьте раздел Настройки → Модели и провайдеры. Если повторный вход не помог, обратитесь к администратору АСТРА ИИ [ХАБ] в вашей организации |
| Над полем ввода плашка Нет связи с АСТРА ИИ [ХАБ] | Приложение само проверяет связь. Проверьте сеть, прокси или VPN и нажмите Проверить сейчас; причина — под кнопкой Подробнее. См. раздел «Вход и аккаунт АСТРА ИИ [ХАБ]» |
| В ленте строка Ход не выполнен | Прочитайте причину. Если ход прервался из-за связи с АСТРА ИИ [ХАБ], дождитесь восстановления связи и нажмите Повторить запрос: текст запроса вернётся в поле ввода |
| В ленте предупреждение «Ядро не открыло базу состояния: поиск и цели сессий могут не работать» | Данные ядра раньше записывало ядро другой сборки, например после перехода между редакциями приложения. Ответы приходят, но поиск и цели сессий могут не работать. Вернитесь к прежней редакции и обратитесь в поддержку, приложив отчёт для поддержки. См. раздел «Известные ограничения» |
| Папка проекта не открывается | Проверьте, что папка существует и у вас есть права на неё. Если папку переместили, см. раздел «Данные и восстановление», подраздел «Проект перемещён» |
| История не загружается | Нажмите Повторить загрузку истории, проверьте папку проекта и каталог ядра. При повторной ошибке сделайте резервную копию данных и обратитесь в поддержку |
| Список сессий проекта не загрузился (сообщение над списком и кнопка Повторить) | Нажмите Повторить. Уже сохранённые сессии показаны и открываются. Если ядро останавливается при чтении списка, сохраните отчёт для поддержки |
| Экран Не удалось открыть сессию | Прочитайте причину под названием сессии, например «Ядро не ответило при открытии сессии.» или «Папка проекта недоступна.». Устраните её и нажмите Повторить или Закрыть вкладку: история сессии сохраняется |
| Над полем ввода сообщение Сессия открыта для просмотра. | Ядро не подключило сессию, пока в ней идёт ход. Ответ появится в ленте, а после хода сессия подключится сама. Если этого не произошло, нажмите Подключиться |
| Агент не может записать файл | Проверьте режим в меню у поля ввода или командой /permissions. Новый режим действует сразу; если ядро его не приняло, появится сообщение «Ядро не приняло новые права. Права остались прежними, выберите их еще раз.» — выберите режим ещё раз. См. раздел «Права и подтверждения» |
| Команда агента не может обратиться к сети | В песочнице сеть отключена (в Windows песочницы нет, и в режиме Правки команды выходят в сеть). Проверьте политику подтверждений; см. раздел «Права и подтверждения» |
| Сообщение не попало текущему агенту | Пока агент работает, Enter ставит сообщение в очередь; см. раздел «Управление агентом» |
| Очередь не отправляется | Проверьте отметку у очереди: на паузе — отправьте новый запрос или выбранное сообщение; ждет решения по плану — решите, как продолжить план |
| Кнопка Подкинуть недоступна | Во время проверки изменений (/review), сжатия контекста и индексации проекта ядро не принимает уточнения; причина показана в подсказке. Сообщение остаётся в очереди |
| Агент ждёт ответа | Ответьте на вопрос агента или запрос подтверждения в карточке в ленте сессии или в разделе Входящие |
| После остановки остались правки | Остановка не отменяет изменений, уже записанных в файлы. Чтобы вернуть файлы, используйте откат; см. раздел «Проверка, откат и повтор запроса» |
| Откат недоступен или частичен | Прочитайте причину в подсказке кнопки отката. Вид Изменения правой колонки не заменяет журнал правок: если журнала нет, верните файлы средствами Git |
| MCP-сервер не загрузился | Прочитайте причину в строке сервера, например программа не найдена. Нажмите Обновить, проверьте команду, зависимости и аргументы через Изменить. При состоянии нужен вход нажмите Войти и завершите вход в браузере |
| Навык не появился | Проверьте SKILL.md, уникальность имени и включение навыка; начните новую сессию |
| Файл не открывается в редакторе | Проверьте, что выбранный внешний редактор кода установлен; см. раздел «Git и редактор» |
| Файл не открывается во встроенном просмотре | Прочитайте сообщение в просмотре, например Файл в сетевой папке или Это программа: приложение не открывает файлы по сетевым путям и не запускает программы. См. раздел «Git и редактор» |
| Git-ветка не переключается | Прочитайте причину под списком веток: незакоммиченные изменения, файлы вне Git или ветка открыта в другой рабочей копии. См. раздел «Git и редактор» |
| Ошибка записи истории или настроек | Проверьте свободное место и права на каталог данных приложения; перед восстановлением сделайте копию |
| Обновление недоступно | Для пакета .deb и в macOS встроенного обновления нет; см. раздел «Обновление приложения» |
| Приложение не запускается | Появится окно АСТРА ИИ [КОД] не удалось запустить с текстом ошибки. Сохраните этот текст для обращения. Если окно указывает на файл базы, следуйте инструкции в окне и не удаляйте файл, пока не сделаете его копию |
| Ядро не запускается | Полностью закройте приложение и запустите снова. Если ошибка повторяется, обратитесь в поддержку и приложите отчёт из Настройки → О программе (кнопка Сохранить отчет для поддержки…). Кнопка Настройки ядра на плашке ошибки ведёт в раздел Настройки → Ядро и диагностика; путь к ядру меняйте только по указанию поддержки |
| Над полем ввода плашка об остановке ядра с кодом выхода и временем остановки | Ядро аварийно завершилось; приложение запускает его заново само. Если ответ оборвался, отправьте сообщение ещё раз. Кнопка Показать журнал раскрывает последние строки вывода ядра — приложите их к обращению в поддержку. Крестик (подсказка Закрыть) скрывает плашку |
Windows и macOS
| Симптом | Действие |
|---|---|
| Windows: при запуске установщика — окно Система Windows защитила ваш компьютер | Установщик не подписан сертификатом издателя. Если он получен в канале распространения вашей организации, нажмите Подробнее, затем Выполнить в любом случае. См. раздел «Установка и запуск» |
| Windows на виртуальной машине или по RDP: окно приложения отображается с ошибками | Задайте переменную окружения ASTRACODE_DISABLE_GPU=1 и перезапустите приложение: переменная полностью отключает видеокарту для приложения |
| macOS: при запуске — сообщение, что приложение повреждено и его нужно переместить в Корзину | Приложение не подписано сертификатом Apple, и macOS блокирует его запуск. Не перемещайте его в Корзину: выполните в Терминале xattr -cr "/Applications/Астра ИИ [Код].app" и откройте приложение снова. См. раздел «Установка и запуск» |
Linux и Astra Linux
| Симптом | Действие |
|---|---|
В Astra Linux 1.7 AppImage может не запускаеться двойным щелчком; при запуске из терминала — execv error: Operation not permitted |
Astra Linux 1.7 может запрещать запуск программ через FUSE. Запустите AppImage из терминала с ключом: ./<имя-файла>.AppImage --appimage-extract-and-run — или установите пакет .deb |
В Astra Linux 1.7 при входе — АСТРА ИИ [ХАБ] временно недоступен, Сервер АСТРА ИИ [ХАБ] не отвечает или «Сервер АСТРА ИИ [ХАБ] … не отвечает или не принял сертификат», хотя сервер доступен по сети; или после входа в браузере — страница Не удалось завершить вход с кодом token_exchange_failed |
В системе нет корневого сертификата GlobalSign Root R46, которым подписан сервер АСТРА ИИ [ХАБ], или не установлен пакет ca-certificates. Обратитесь к администратору: нужно добавить этот сертификат в системное хранилище. В Astra Linux 1.8 сертификат уже есть |
| АСТРА ИИ [ХАБ] временно недоступен или Сервер АСТРА ИИ [ХАБ] не отвечает, хотя сервер открывается в браузере, а приложение запущено из терминала | Ядро обращается к АСТРА ИИ [ХАБ] через прокси из переменных HTTPS_PROXY и HTTP_PROXY. Если прокси не пропускает адреса АСТРА ИИ [ХАБ], добавьте их в NO_PROXY, например NO_PROXY=.astra-team.ru, или запустите приложение без этих переменных |
| После Войти через АСТРА ИИ [ХАБ] браузер сообщает, что страница входа недоступна | Браузер использует системный прокси, через который сервер входа недоступен. Добавьте адрес сервера входа в исключения прокси в настройках системы или браузера, затем в приложении нажмите Отменить вход и начните вход заново |
| Через несколько минут после нажатия Войти через АСТРА ИИ [ХАБ] приложение вернулось к экрану входа без сообщения | Вход в браузере не завершён за 5 минут. Начните вход заново |
| В Astra Linux 1.7 системное окно выбора папки открывается, но после Открыть папка не выбирается; во встроенном окне выбирается не та папка | В Astra Linux папка выбирается во встроенном окне Выберите папку проекта (для навыка — Выберите папку навыка). Введите путь в поле Путь к папке и нажмите Перейти (или Enter) либо перейдите к папке по списку. Затем нажмите Выбрать эту папку: выбирается папка, открытая в окне, а не путь, введённый в поле. Проверьте путь в окне доверия. Если вместо встроенного окна открывается системное, запустите приложение с переменной ASTRACODE_BUILTIN_FOLDER_PICKER=1 |
Локальная редакция: при выборе ядра — «Не удалось проверить версию ядра» с текстом GLIBC_2.xx not found |
Файл ядра собран для системы с более новой glibc. Узнайте версию командой getconf GNU_LIBC_VERSION и укажите ядро, собранное для неё; для Astra Linux 1.7 нужно ядро для glibc 2.28. См. раздел «Локальная редакция» |
| Локальная редакция в Astra Linux 1.7: поставщик добавлен, но ответ модели не приходит | Ядру нечем проверить сертификат сервера поставщика. Установите пакет ca-certificates: sudo apt install ca-certificates. Если сервер подписан корнем, которого нет в пакете (например GlobalSign Root R46), администратору нужно добавить этот корень в систему |
| Локальная редакция: при добавлении поставщика — «Сервер ответил, но не вернул ни одной модели для чата» | Ключу API не открыт доступ к моделям или на сервере поставщика не загружено ни одной модели. Проверьте ключ и список моделей на сервере или обратитесь к администратору поставщика |
Обращение в поддержку
Используйте канал поддержки вашей организации или поставщика.
- Откройте раздел Настройки → О программе и в блоке Версии и среда, в строке Отчет для поддержки, нажмите Сохранить отчет для поддержки…. Сохраните архив
astracode-report-<дата>-<время>.zip(по умолчанию предлагается папка «Документы») и приложите его к обращению. В архиве — сводкаsummary.txt, журналы приложения и ядра за последние 7 дней (desktop-log.jsonl,core-log.txt,core-stderr.txt, а если есть —updater.log), паспорт сборкиbuild-info.jsonи настройки без ключей и паролейsettings.json. Отчёт остаётся на компьютере: приложение никуда его не отправляет. Те же кнопки есть в разделе Настройки → Ядро и диагностика, в блоке Для поддержки. - Нажмите Скопировать сводку и вставьте результат целиком в технический блок шаблона ниже. В сводке есть версии приложения и ядра, ОС, видеокарта, вход и связь с АСТРА ИИ [ХАБ], состояние ядра и последние ошибки. Если ошибка возникла при входе и настройки недоступны, откройте пункт меню Справка → О программе АСТРА ИИ [КОД] (в macOS — в меню Астра ИИ [Код]): окно показывает версию и те же кнопки отчёта. На экране ошибки входа есть и ссылка Скопировать сведения для поддержки.
- Заполните описание проблемы:
```text Шаги воспроизведения: Ожидаемый результат: Фактический результат и текст ошибки: Дата, время ошибки и часовой пояс:
Технические сведения: <вставьте целиком результат «Скопировать сводку»> ```
Кнопка Открыть папку журналов открывает папку logs в каталоге данных приложения (где он находится — см. раздел «Данные и восстановление»). Журнал приложения astracode-diagnostics.log ведётся без текста запросов, ключей и токенов: адрес почты скрыт, домашняя папка заменена на ~. В журнал записываются запуск и остановки ядра, ходы агента (модель, права, повторы, ответ поставщика), открытие сессий, вход в АСТРА ИИ [ХАБ], MCP-серверы, обновления и ошибки приложения. Если поддержка попросит, включите Подробный журнал в разделе Настройки → Ядро и диагностика: он добавляет внутренние события агентов.
Для ошибки в запросе агенту укажите модель и где работали: в проекте или в чате без проекта. Если уже пробовали повторить действие, открыть новую сессию или перезапустить приложение, добавьте результат. Снимок экрана приложите, если он помогает показать проблему.
Если приложение не запускается и сохранить отчёт нельзя, приложите текст из окна ошибки запуска и файлы из папки logs каталога данных приложения.
Уберите секреты и закрытый код из текста и снимков. Каталоги данных целиком передавайте только по запросу поддержки.
См. также разделы «Известные ограничения» и «Данные и восстановление».