> ## Documentation Index
> Fetch the complete documentation index at: https://agencykey.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Автообновление

> Поддерживайте десктоп-приложение AgencyKey в актуальном состоянии

Автообновление поддерживает AgencyKey Desktop на последней стабильной версии. Оно доступно только в десктоп-приложении; веб-версию AgencyKey обновляет автоматически.

## Как работает автообновление

### 1. Фоновая проверка и загрузка

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

### 2. Обновление готово

Когда загрузка завершится, появится диалог **«Обновление готово»**:

* **Заголовок:** Обновление готово
* **Сообщение:** подтверждение, что новая версия загружена
* **Кнопки:** **Установить сейчас** / **Установить позже**

| Выбор                 | Что произойдёт                                                                                                                                                       |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Установить сейчас** | Приложение закроется и перезапустится на новой версии                                                                                                                |
| **Установить позже**  | Обновление остаётся наготове. Оно установится автоматически при следующем выходе из приложения — или сразу, если выбрать **Установить обновление** в меню приложения |

После выбора **Установить позже** пункт меню **Проверить обновления** заменяется на **Установить обновление** — можно применить обновление, когда удобно.

<Note>
  После перезапуска ваши аккаунты и текущая сессия сохраняются.
</Note>

## Окно «Требуется обновление»

Обычно обновление скачивается в фоне и ждёт удобного момента для перезапуска. Если установленная версия слишком старая для продолжения работы, AgencyKey показывает окно **«Требуется обновление»**.

Это окно отличается от обычного обновления выше. Оно открывается само, занимает весь экран и проводит вас через одно обновление от начала до конца.

### Что вы видите

| Элемент         | Что означает                                               |
| --------------- | ---------------------------------------------------------- |
| **Заголовок**   | Требуется обновление                                       |
| **Сообщение**   | Для продолжения работы нужна более новая версия приложения |
| **Одна кнопка** | Единственная кнопка, которая делает всё обновление целиком |

Нажать нужно всего одну кнопку. Её надпись меняется по ходу обновления — вы всегда видите, на каком вы этапе:

| Надпись на кнопке    | Что происходит                                     |
| -------------------- | -------------------------------------------------- |
| **Обновить**         | Готово к старту — нажмите один раз                 |
| Проверка…            | Идёт поиск новой версии                            |
| Загрузка…            | Загрузка начинается                                |
| Загрузка \[процент]% | Идёт загрузка, с живым процентом                   |
| Установка…           | Приложение устанавливается и сейчас перезапустится |
| **Повторить**        | Нужно попробовать ещё раз — см. ниже               |

### Как обновиться

**1. Нажмите «Обновить»**

Одно нажатие запускает весь процесс — приложение находит новую версию, скачивает её, устанавливает и перезапускается само. Без лишних вопросов по пути.

**2. Следите за прогрессом**

Тонкая полоса заполняется по мере загрузки новой версии, а процент виден прямо на кнопке — сразу понятно, сколько осталось.

**3. Приложение перезапустится само**

Как только загрузка завершится, приложение установит обновление и автоматически перезапустится в новую версию. Аккаунты, которые были открыты до обновления, снова откроются сами — и вы продолжите с того же места.

<Note>
  Даже если сразу несколько действий упрутся в ограничение по версии, вы всё равно увидите ровно одно окно **«Требуется обновление»**, а не кучу всплывающих окон.
</Note>

### Если обновление ещё не готово

Иногда к моменту появления окна новая версия ещё не опубликована. Тогда вы увидите короткое сообщение — «Обновление пока недоступно. Попробуйте ещё раз через минуту.» — и кнопка сменится на **Повторить**. Подождите немного и нажмите **Повторить**, чтобы попробовать снова.

Если обновление не удалось завершить (например, пропало соединение), вы увидите короткую подсказку красным и ту же кнопку **Повторить**, чтобы попробовать ещё раз.

<Warning>
  Закрытие окна **«Требуется обновление»** завершает приложение. Установленная версия больше не может работать с сервисом, поэтому возвращаться не к чему — быстрее всего просто нажать **Обновить**.
</Warning>

<Tip>
  На macOS запускайте AgencyKey из папки **Программы**. Если приложение запущено из папки **Загрузки** или прямо из установочного образа, обновление не сможет установиться — перенесите AgencyKey в **Программы** и попробуйте снова.
</Tip>

## Ручная проверка обновлений

Проверить обновления можно в любой момент:

1. Откройте **меню приложения** в верхней части
2. Нажмите **Проверить обновления**
3. AgencyKey проверит последнюю стабильную версию и при необходимости скачает её в фоне

Если обновление уже загружено и ждёт установки, этот пункт меню заменяется на **Установить обновление**.

## Что обновляется

Каждое обновление может включать:

* Новые функции и улучшения
* Исправления ошибок и улучшения стабильности
* Патчи безопасности
* Улучшения интерфейса

## Важная информация

* Стабильные обновления скачиваются незаметно в фоне
* Данные и сессии аккаунтов сохраняются при обновлении
* Во время загрузки можно продолжать работу
* **Установить позже** применит обновление при следующем выходе из приложения

## Решение проблем

### Обновление не работает?

1. Проверьте подключение к интернету
2. Запустите **Проверить обновления** из меню приложения
3. Перезапустите AgencyKey Desktop и проверьте снова
4. Если проблема не исчезла, скачайте последнюю версию с официальной страницы ниже

### Ручное скачивание

Скачайте актуальный установщик для macOS или Windows на [русской странице загрузки AgencyKey](https://agencykey.com/ru/download).
