> ## 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 — от подключения к серверу и визуальной темы до значений графиков по умолчанию, поведения загрузки данных и звуковых предпочтений.

Откройте Настройки через значок шестерёнки в заголовке или нажмите `Ctrl + ,`.

## Подключение к серверу

Cluster Terminal подключается к серверу данных для получения всех рыночных данных (свечи, кластеры, открытый интерес) и потоковой передачи в реальном времени через WebSocket.

### Быстрое переключение сервера

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

| Сервер     | Расположение        | URL                             |
| ---------- | ------------------- | ------------------------------- |
| **FIN1**   | Финляндия (Hetzner) | `https://fin1-strm.incrypto.ru` |
| **RU1**    | Россия              | `https://ru1-strm.incrypto.ru`  |
| **Custom** | Пользовательский    | Любой URL                       |

Выбор сервера мгновенно переподключает REST и WebSocket соединения. Все открытые графики перезагружают данные с нового сервера. Выбранный сервер сохраняется между перезапусками приложения.

<Tip>
  Выбирайте сервер, ближайший к вашему местоположению, для минимальной задержки. FIN1 и RU1 поддерживают идентичные данные — переключение серверов не влияет на вашу историю или анализ.
</Tip>

### Ручная настройка URL сервера

Для расширенных конфигураций (собственные серверы, нестандартные порты) используйте панель Настроек:

<Steps>
  <Step title="Откройте Настройки">
    Нажмите значок шестерёнки или нажмите `Ctrl + ,`.
  </Step>

  <Step title="Выберите Custom">
    В разделе **Сервер** выберите «Custom» и введите полный URL (например, `https://my-server.example.com`).
  </Step>

  <Step title="Проверьте подключение">
    Приложение автоматически тестирует подключение при сохранении. Зелёная галочка означает успех; красный значок означает, что сервер недоступен.
  </Step>
</Steps>

<Warning>
  Смена сервера отключает все активные WebSocket-потоки и перезагружает данные графиков с нового сервера.
</Warning>

## Внешний вид

### Язык

Cluster Terminal поддерживает несколько языков интерфейса.

| Язык           | Статус           |
| -------------- | ---------------- |
| **Английский** | Полная поддержка |
| **Русский**    | Полная поддержка |

Смените язык в **Настройки > Внешний вид > Язык**. Изменение вступает в силу немедленно без перезапуска.

### Тема

| Тема        | Описание                                                                    |
| ----------- | --------------------------------------------------------------------------- |
| **Тёмная**  | Тёмный фон, светлый текст. Оптимизирована для длительной работы за экраном. |
| **Светлая** | Светлый фон, тёмный текст.                                                  |

<Tip>
  Тёмная тема рекомендуется для трейдинга, чтобы снизить нагрузку на глаза при длительных сессиях, особенно при использовании нескольких мониторов.
</Tip>

## Настройки графика по умолчанию

Эти настройки управляют начальной конфигурацией при создании новой вкладки графика.

| Параметр                     | Описание                        | Варианты                                   |
| ---------------------------- | ------------------------------- | ------------------------------------------ |
| **Тип графика по умолчанию** | Тип графика для новых вкладок   | Свечной, Кластерный, TPO, Тепловая карта   |
| **Таймфрейм по умолчанию**   | Начальный таймфрейм             | 1m, 5m, 15m, 1h, 4h, 1D, 1W, 1M            |
| **Символ по умолчанию**      | Начальный символ                | Любой доступный символ (например, BTCUSDT) |
| **Цвета свечей**             | Цвета бычьих / медвежьих свечей | Палитра цветов                             |

<Note>
  Эти значения по умолчанию применяются только к новым вкладкам. Существующие вкладки сохраняют свои собственные настройки.
</Note>

## Загрузка данных

Управление загрузкой и кэшированием исторических данных.

| Параметр                   | Описание                                                                                                                               |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Прогрессивная загрузка** | Загрузка данных объёмов/кластеров частями с индикатором прогресса. Сохраняет отзывчивость интерфейса для больших диапазонов дат.       |
| **Глубина истории**        | Насколько далеко в прошлое загружать данные при открытии графика. Более глубокая история означает более длительную начальную загрузку. |

### Прогрессивная загрузка

При включении большие запросы данных (особенно кластерные объёмы) разбиваются на дневные порции и загружаются последовательно. Индикатор прогресса на панели инструментов графика показывает статус загрузки.

<Tip>
  Оставляйте прогрессивную загрузку включённой. Она предотвращает зависание интерфейса при загрузке месяцев кластерных данных, особенно для символов с высоким объёмом, таких как BTCUSDT.
</Tip>

## Кэш

Управление локальным кэшированием данных для ускорения загрузки графиков.

| Параметр           | Описание                                                                                         |
| ------------------ | ------------------------------------------------------------------------------------------------ |
| **Постоянный кэш** | Сохранять загруженные данные локально в IndexedDB для мгновенной загрузки при следующем открытии |
| **Размер кэша**    | Отображает текущее количество записей и примерный размер в МБ                                    |
| **Очистить кэш**   | Удаляет все кэшированные данные (кластеры, объёмы, хитмап, OI, архивы) из памяти и IndexedDB     |

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

<Tip>
  Если графики показывают устаревшие или некорректные данные, очистите кэш и перезагрузите. Это принудительно запросит свежие данные с сервера.
</Tip>

## Telegram-уведомления

Отправка оповещений напрямую в чат или канал Telegram через бота.

| Параметр              | Описание                                                 |
| --------------------- | -------------------------------------------------------- |
| **Включить Telegram** | Переключатель доставки уведомлений в Telegram            |
| **Токен бота**        | Токен от [@BotFather](https://t.me/BotFather)            |
| **Chat ID**           | ID чата или канала Telegram (например, `-1001234567890`) |
| **Тест соединения**   | Отправить тестовое сообщение для проверки настройки      |

### Фильтры уведомлений

Выберите, какие события пересылать в Telegram:

| Фильтр                     | Описание                                                      |
| -------------------------- | ------------------------------------------------------------- |
| **Ценовые оповещения**     | Алерты, сработавшие по ценовым уровням инструментов рисования |
| **Оповещения индикаторов** | Уведомления от правил алертов индикаторов                     |
| **Оповещения календаря**   | Напоминания о событиях экономического календаря               |

<Note>
  Бот должен быть добавлен в целевой чат/канал и иметь разрешение на отправку сообщений. Используйте [@userinfobot](https://t.me/userinfobot) для определения вашего Chat ID.
</Note>

## Экономический календарь

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

| Параметр                  | Описание                                                        |
| ------------------------- | --------------------------------------------------------------- |
| **Включить календарь**    | Переключатель функции экономического календаря                  |
| **Показывать на графике** | Отображать маркеры событий на шкале времени                     |
| **Минимальная важность**  | Фильтр событий по важности: High, Medium или Low                |
| **Страны**                | Фильтр по стране или валюте (например, USD, EUR)                |
| **Оповещение за N минут** | За сколько минут до события срабатывает уведомление (0–60)      |
| **API-ключ JBlanked**     | Опциональный ключ для доступа к данным прошлых и будущих недель |

События текущей недели загружаются с ForexFactory (бесплатно, без ключа). Для просмотра прошлых или будущих недель введите API-ключ JBlanked.

<Tip>
  Установите «Минимальная важность» на High, если хотите видеть только крупные события: FOMC, NFP, CPI.
</Tip>

## Настройки звука

Настройка звуковых уведомлений для оповещений и системных событий.

| Параметр             | Описание                                                                        |
| -------------------- | ------------------------------------------------------------------------------- |
| **Звуки оповещений** | Включение или отключение звука при срабатывании ценовых/индикаторных оповещений |
| **Громкость звука**  | Общая громкость для всех звуков уведомлений                                     |

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

## Лицензия

Просмотр и управление статусом лицензии.

| Поле                  | Описание                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Лицензионный ключ** | Ваш активный лицензионный ключ (формат CT-XXXX-XXXX-XXXX-XXXX) |
| **Статус**            | Активна, Пробная или Истекла                                   |
| **Функции**           | Включённые функции (например, cloud\_sync, priority\_support)  |
| **Устройства**        | Количество активированных устройств из максимально допустимого |
| **Срок действия**     | Дата истечения лицензии                                        |

### Пробный режим

Если вы не ввели лицензионный ключ, Cluster Terminal работает в пробном режиме в течение 7 дней с полным функционалом. После истечения пробного периода для продолжения использования приложения необходим лицензионный ключ.

<Note>
  Длительность пробного периода может варьироваться. Администратор сервера может настроить пробный период через панель администратора.
</Note>

### Активация лицензии

<Steps>
  <Step title="Получите лицензионный ключ">
    Приобретите лицензию или получите её от администратора проекта. Ключи имеют формат `CT-XXXX-XXXX-XXXX-XXXX`.
  </Step>

  <Step title="Введите ключ">
    Перейдите в **Настройки > Лицензия** и вставьте ключ в поле лицензии.
  </Step>

  <Step title="Активируйте">
    Нажмите **Активировать**. Приложение проверит ключ на сервере и зарегистрирует ваше устройство.
  </Step>
</Steps>

<Warning>
  Каждая лицензия имеет максимальное количество устройств. Если вы достигли лимита, деактивируйте существующее устройство через панель администратора сервера или обратитесь в поддержку.
</Warning>

## Сброс настроек

Для сброса всех настроек к значениям по умолчанию очистите каталог данных приложения. В Windows он расположен по пути:

```
%APPDATA%/com.cluster-terminal/
```

<Warning>
  Сброс данных приложения удаляет все локальные рабочие пространства, активацию лицензии, состояние пробного периода и кэшированные данные. Это действие нельзя отменить.
</Warning>