Данные и восстановление — АСТРА ИИ [КОД]

История сессий и созданные файлы хранятся отдельно. Сохранённая история не заменяет резервную копию проекта.

Расположение данных

Данные	Путь
Файлы проекта	Папка, выбранная при открытии
Файлы чатов без проекта	Папка `AstraCode` в папке «Документы», у каждого чата — своя папка; см. раздел «Чаты без проекта»
Список проектов и сессий, закладки, настройки	Каталог данных приложения
Конфигурация, история ядра, роли, пользовательские материалы	Каталог ядра: `.astracode` в домашней папке или папка из переменной `ASTRACODE_HOME`
Навыки проекта	Путь указан в списке навыков

Путь к файлу настроек ядра config.toml показан в разделе Настройки → Ядро и диагностика, в строке .astracode. Папка, в которой лежит этот файл, и есть каталог ядра.

Каталог данных приложения — папка astracode-desktop: %APPDATA%\astracode-desktop в Windows, ~/.config/astracode-desktop (или $XDG_CONFIG_HOME/astracode-desktop) в Linux, ~/Library/Application Support/astracode-desktop в macOS. Папки прежних версий приложения переносятся в неё автоматически при первом запуске. В ней находятся база astragpt.db, файлы config.json и profiles-meta.json, а также журналы:

logs/astracode-diagnostics.log — журнал для поддержки: запуск ядра, ходы агента, вход, MCP-серверы, обновления и ошибки, без текста запросов, ключей и токенов. Хранится до пяти файлов по 2 МБ. Папку открывает кнопка Открыть папку журналов в разделе Настройки → О программе;
updater.log — журнал проверки и установки обновлений.

Если в прежних версиях приложения использовалось несколько профилей, данные каждого профиля хранятся в подкаталоге profiles/<идентификатор>. Приложение продолжает работать с профилем, который был выбран последним.

Найти файл из чата

Файлы чатов хранятся в постоянной папке AstraCode в папке «Документы» и не пропадают при очистке временного каталога. Чтобы найти файл:

В карточке файла в ленте нажмите ⋯ и выберите Показать в папке или Копировать путь.
Если карточки нет, выполните в чате команду /status: в строке Папка показан путь к папке чата. Готовые файлы агент сохраняет во вложенную папку outputs.

Файлы чатов прежних версий перенесены в папку old-chats внутри папки AstraCode — см. раздел «Чаты без проекта».

Последствия действий

Действие	Результат
Закрыть приложение	Проекты и история остаются; неотправленная очередь теряется. Фоновые процессы ядра и запущенные им MCP-серверы завершаются. Скопируйте нужные сообщения до закрытия
Выйти из АСТРА ИИ [ХАБ]	Работа с агентом недоступна до входа; локальные данные остаются
Закрыть вкладку	Сессию можно снова открыть из списка. Если в сессии идёт работа, приложение спросит, остановить ли её
Архивировать сессию	Скрывает её из основного списка и останавливает её фоновые процессы; сессию можно вернуть
Удалить сессию или чат	Фоновые процессы сессии останавливаются, история удаляется из приложения без возможности отмены в интерфейсе; файлы проекта, папка чата и файл истории в каталоге ядра остаются
Удалить проект	Удаляются проект и связанные записи приложения; папка на диске остаётся
Удалить закладку	Сессия и файлы остаются
Выключить навык	Файлы остаются; доступность проверьте в новой сессии
Удалить навык проекта	Файлы навыка удаляются после подтверждения
Очистить память	Заметки агента удаляются необратимо; история сессий остаётся
Откатить запрос	Файлы возвращаются к состоянию до запроса, а запрос и вся последующая переписка удаляются из сессии; условия и исключения — см. раздел «Проверка, откат и повтор запроса»

Резервная копия

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

папки проектов и папку чатов AstraCode из папки «Документы» вместе с old-chats;
весь каталог данных приложения;
весь каталог ядра, если нужны его настройки и история.

Одного файла astragpt.db недостаточно: остальные данные хранятся отдельно. Пока приложение работает, часть изменений базы хранится во вспомогательных файлах astragpt.db-wal и astragpt.db-shm рядом с ней, поэтому копия работающей базы может оказаться неполной. Закройте приложение перед копированием.

Копия содержит историю и может содержать данные авторизации. Храните её как личные рабочие данные; в поддержку передавайте только запрошенные файлы.

Восстановление и перенос

Восстановление выполняется вручную. Восстанавливайте копию в ту же или более новую версию приложения: при запуске новая версия переводит данные прежних версий в свой формат. Пути к папкам проектов сохраняются в данных как есть: если на другом компьютере проекты лежат в других папках, откройте их заново (см. «Проект перемещён» ниже).

Сохраните копию текущих каталогов перед заменой.
Закройте приложение и консольную версию ядра.
Восстановите каталоги целиком по фактическим путям.
Запустите приложение, войдите в АСТРА ИИ [ХАБ], если приложение попросит, и проверьте проекты, историю и закладки.

На другом компьютере нужно снова войти в АСТРА ИИ [ХАБ]. Вход в АСТРА ИИ [ХАБ] не переносит локальную историю: переносите её по резервной копии.

Проект перемещён

Приложение хранит путь к папке проекта. Если папку проекта переместили или переименовали, верните её на прежнее место — проект и его сессии снова откроются.

Чтобы работать с папкой на новом месте, откройте её через Открыть папку…: будет создан новый проект без прежней истории.

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