Десктопное приложение

Что такое Предиктор Икс Desktop, чем оно отличается от веб-версии и когда его стоит использовать.

Предиктор Икс Desktop — это нативное десктопное приложение для macOS, Windows и Linux. Для настроенной среды оно взаимодействует с тем же бэкендом, что и веб-приложение, и отображает те же данные. По умолчанию Desktop использует Предиктор Икс Cloud; для self-hosted инстансов можно настроить локальный файл конфигурации среды выполнения. Desktop также добавляет функции, недоступные в браузере: независимые группы вкладок для каждого рабочего пространства, автоматический запуск демона и обновления в один клик.

Что выбрать: веб или десктоп

	Веб	Desktop
Доступ	Откройте URL в браузере	Установите нативное приложение
Несколько вкладок	Вкладки вашего браузера (без разделения рабочих пространств)	Одна независимая группа вкладок на рабочее пространство
Демон	Вы запускаете `predictorx daemon start` вручную	Запускается автоматически при открытии приложения
Обновления	Обновите страницу для получения последней версии	Приложение проверяет наличие обновлений в фоне и устанавливает их при следующем запуске
Данные авторизации	Идентичны	Идентичны

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

Несколько вкладок: что происходит при переключении рабочих пространств

Desktop поддерживает независимую группу вкладок для каждого рабочего пространства, к которому вы присоединились. При переключении пространств вкладки текущего рабочего пространства скрываются как единое целое, а вкладки предыдущего восстанавливаются в том же виде, в каком вы их оставили — аналогично поведению многооконности в VSCode или переключению пространств в Slack.

Пример: вы открыли 3 вкладки с задачами в рабочем пространстве А и переключились в пространство B. Вкладки А исчезают, а B показывает то, что было открыто в нем в последний раз. При возвращении в А эти 3 вкладки вернутся в точности такими, какими были. Вкладки никогда не перемешиваются между рабочими пространствами.

Выход из системы очищает состояние вкладок для всех рабочих пространств, чтобы данные не утекали при использовании компьютера разными пользователями.

Как работают автообновления в Desktop

При запуске Desktop проверяет наличие новой версии на GitHub Releases. Если она найдена:

Приложение загружает новую версию в фоновом режиме.
Появляется сообщение: "готово — установится при следующем запуске".
Когда вы закроете приложение (или при следующем перезапуске), оно установит обновление перед выходом.
При следующем запуске будет работать уже новая версия.

Весь процесс не прерывает вашу текущую работу.

В Windows каналы обновлений для ARM64 и x64 разделены — если установить не ту архитектуру, обновления не будут обнаруживаться. При загрузке выбирайте тот .exe, который соответствует вашему компьютеру (ARM-сборка имеет суффикс arm64).

Сборка для macOS подписана и нотариально заверена, поэтому вы не увидите предупреждение о "неизвестном разработчике" при первом запуске. Linux-версия поставляется как .AppImage — автообновления полагаются на electron-updater, который может работать нестабильно на некоторых дистрибутивах. Если автообновление не работает, загрузите новую версию вручную и замените старый файл.

Нужно ли все еще использовать standalone CLI и демон?

Нет. Desktop поставляется с тем же бинарным файлом predictorx CLI внутри, и при запуске он инициализирует свой профиль демона (изолированный от любого демона, который вы могли запустить вручную из терминала).

Если вы уже установили CLI и запустили predictorx daemon start вручную, Desktop не перехватит ваш демон — он запустит свой собственный с отдельным профилем. Оба регистрируются как разные среды выполнения (runtimes), и вы увидите две независимые среды в интерфейсе.

Если вы хотите запускать CLI-команды в своем терминале, Desktop не предлагает особого пути — используйте CLI, который вы установили отдельно, или запускайте встроенную копию по пути resources/bin/predictorx внутри директории ресурсов приложения.

Скачивание и установка

Скачайте установщик для вашей платформы на странице загрузки Предиктор Икс:

Платформа	Файл
macOS (Intel или Apple Silicon)	`.dmg`
Windows x64	`.exe` (стандартный)
Windows ARM64	`.exe` (с суффиксом `arm64`)
Linux	`.AppImage`

При первом запуске вам нужно будет войти в систему — используя тот же процесс с email и кодом подтверждения, что и в веб-версии. После входа Desktop автоматически синхронизирует ваш список рабочих пространств.

Desktop по умолчанию использует Предиктор Икс Cloud, но может быть направлен на self-hosted инстанс через локальный файл конфигурации. В приложении пока нет выбора "подключиться к своему серверу". Desktop считывает ~/.predictorx/desktop.json до запуска рендеринга; если файл отсутствует, используются настройки Cloud по умолчанию.

Минимальная конфигурация для self-host:

{
  "schemaVersion": 1,
  "apiUrl": "https://api.your-domain"
}

Параметр apiUrl обязателен и должен использовать http или https. Desktop вычисляет wsUrl как /ws на том же домене (wss для https, ws для http) и вычисляет appUrl из API-домена. Если ваше развертывание использует разные домены, установите их явно:

{
  "schemaVersion": 1,
  "apiUrl": "https://api.your-domain",
  "wsUrl": "wss://api.your-domain/ws",
  "appUrl": "https://your-domain"
}

Если файл desktop.json существует, но является невалидным, Desktop не запустится и покажет блокирующую ошибку конфигурации вместо молчаливого возврата к Cloud. Для сборок разработки VITE_API_URL / VITE_WS_URL / VITE_APP_URL по-прежнему имеют приоритет во время electron-vite dev. Конфигурация self-host для Desktop была реализована в issue #1371.

Следующие шаги

Cloud Quickstart — процесс онбординга в Cloud для Desktop
Self-Host Quickstart — запуск собственного бэкенда и подключение с помощью CLI или конфигурации среды выполнения Desktop
Daemon and runtimes — как работает демон (Desktop запускает его за вас, но логика работы остается прежней)