> ## Documentation Index
> Fetch the complete documentation index at: https://terminal.incrypto.ru/llms.txt
> Use this file to discover all available pages before exploring further.
# Автообновления
> Cluster Terminal обновляется автоматически — вот как работает система обновлений.
# Автообновления
Cluster Terminal включает встроенную систему автоматического обновления, которая доставляет новые функции, улучшения производительности, исправления ошибок и патчи безопасности без ручного вмешательства. Обновления загружаются в фоновом режиме, криптографически верифицируются и устанавливаются при перезапуске.
## Как работают обновления
### Процесс обновления
Приложение проверяет наличие новых версий при запуске и периодически во время работы. Оно обращается к серверу обновлений для сравнения текущей версии с последним доступным релизом.
При обнаружении новой версии установщик загружается в фоновом режиме, не прерывая работу. Индикатор прогресса показывает статус загрузки в области уведомлений.
Загруженный установщик криптографически верифицируется с использованием цифровых подписей Ed25519. Это гарантирует подлинность обновления и отсутствие подмены при передаче.
После завершения загрузки и верификации появляется уведомление с номером новой версии и заметками к релизу (списком изменений).
Нажмите **Установить и перезапустить** для применения обновления. Установщик NSIS выполняет обновление — ваши настройки, рабочие пространства, лицензия и все пользовательские данные сохраняются.
## Уведомление об обновлении
Когда обновление готово к установке, компонент уведомления появляется в интерфейсе терминала:
| Элемент | Описание |
| ------------------------------ | ------------------------------------------------------------------------------- |
| **Номер версии** | Доступная новая версия (например, «v1.3.0») |
| **Заметки к релизу** | Краткий список изменений с описанием новых функций, исправлений и улучшений |
| **Установить и перезапустить** | Немедленно применяет обновление и перезапускает терминал |
| **Отклонить** | Закрывает уведомление; обновление установится при следующем обычном перезапуске |
Уведомление не блокирует работу — оно не мешает вам торговать. Вы можете отклонить его, и обновление применится при следующем обычном перезапуске терминала.
Прочитайте заметки к релизу перед установкой. Они могут описывать новые функции, которые вы захотите изучить, или изменения в поведении, влияющие на ваш рабочий процесс.
## Безопасность
Все обновления **криптографически подписаны** с использованием цифровых подписей Ed25519. Процесс подписания обеспечивает сквозную целостность:
1. **При сборке** — бинарный файл установщика подписывается закрытым ключом, хранящимся в безопасной среде сборки
2. **Публикация подписи** — подпись загружается на сервер релизов вместе с установщиком
3. **При обновлении** — терминал загружает установщик и его подпись, затем проверяет подпись с помощью встроенного публичного ключа
4. **Отклонение при несоответствии** — если подпись не совпадает, обновление полностью отклоняется, и терминал сообщает об ошибке верификации
Невозможно установить неподписанные или сторонние обновления. Это защищает вас от вредоносного ПО, даже если загрузка была перехвачена.
Никогда не устанавливайте Cluster Terminal из неофициальных источников. Система автообновления гарантирует подлинность только для обновлений, доставленных через официальный канал. Установщики, загруженные вручную с сторонних сайтов, могут быть поддельными.
## Эндпоинт сервера обновлений
Терминал проверяет наличие обновлений, запрашивая эндпоинт обновлений на сервере:
```
GET /api/v1/updater/{target}/{arch}/{current_version}
```
| Параметр | Пример значения | Описание |
| ----------------- | ---------------- | ---------------------------------- |
| `target` | `windows-x86_64` | Операционная система и архитектура |
| `current_version` | `1.2.0` | Текущая установленная версия |
Сервер отвечает:
* **HTTP 200** с JSON-манифестом, содержащим URL загрузки, версию, заметки к релизу и подпись — когда обновление доступно
* **HTTP 204** (No Content) — когда установленная версия уже является последней
## Настройки обновлений
| Параметр | Описание |
| ------------------- | ------------------------------------------------------------------------------------- |
| **Автопроверка** | Включена по умолчанию — проверяет обновления автоматически при запуске и периодически |
| **Ручная проверка** | Запуск проверки из Настроек или области уведомлений |
### Ручная проверка обновлений
Если вы хотите проверить немедленно, не дожидаясь автоматического цикла:
Найдите значок обновления на панели инструментов или перейдите в **Настройки**.
Терминал немедленно отправит запрос на сервер обновлений.
Если найдена новая версия, начнётся процесс загрузки и верификации. Уведомление появится по завершении загрузки.
## Детали установки
В Windows Cluster Terminal использует установщик **NSIS** (Nullsoft Scriptable Install System). При принятии обновления:
1. Терминал сохраняет все состояния рабочих пространств и корректно закрывается
2. Установщик NSIS запускается и выполняет обновление на месте
3. Файлы приложения заменяются новой версией
4. Пользовательские данные (рабочие пространства, настройки, лицензия, рисунки) сохраняются
5. Терминал автоматически открывается на новой версии
Ваши рабочие пространства, индикаторы, рисунки, настройки и активация лицензии никогда не затрагиваются обновлениями. Установщик заменяет только бинарные файлы и ресурсы приложения. Все пользовательские данные сохраняются при обновлении.
## Поведение при откате
Если установка обновления не удалась по какой-либо причине (отключение питания, ошибка диска, повреждённая загрузка), предыдущая версия остаётся нетронутой. Установщик NSIS выполняет обновление атомарно — он либо завершается полностью, либо откатывается к предыдущему состоянию.
В редком случае неудачного обновления:
1. Терминал откроется на предыдущей рабочей версии
2. Неудачное обновление не будет повторяться немедленно
3. При следующем запуске проверка может предложить ту же версию снова
4. Если проблема сохраняется, загрузите последнюю версию вручную с официального сайта или обратитесь в поддержку
## Частота релизов
Обновления выпускаются по мере необходимости. Типичная частота включает:
| Тип релиза | Частота | Содержание |
| --------------------------- | --------------------------------- | --------------------------------------------------- |
| **Функциональный релиз** | Каждые 2-4 недели | Новые индикаторы, типы графиков, функции интерфейса |
| **Исправление ошибок** | По мере необходимости | Исправления найденных проблем |
| **Обновление безопасности** | По мере необходимости (приоритет) | Критические патчи безопасности |
## Устранение неполадок
Проверьте подключение к интернету и настройки брандмауэра. Приложению нужен доступ к серверу обновлений по настроенному URL. Убедитесь, что сервер доступен в **Настройки > URL сервера**.
Закройте все экземпляры Cluster Terminal и попробуйте снова. Убедитесь, что никакой другой процесс не блокирует файлы в каталоге установки.
Проверьте подключение к серверу в Настройках. Если сервер недоступен, проверки обновлений будут завершаться без уведомления. Попробуйте ручную проверку из Настроек.
Полностью закройте все окна терминала и перезапустите. Проверьте номер версии в разделе «О программе».
Запустите вручную из меню «Пуск» или ярлыка на рабочем столе. Обновление завершилось, но автоматический перезапуск мог быть заблокирован системными разрешениями.
Оставляйте автообновления включёнными, чтобы всегда иметь последние функции и исправления безопасности. Заметки к релизу отображаются в уведомлении, чтобы вы могли ознакомиться с изменениями перед установкой.