Свой лаунчер (White Label)

В XTester Studio можно создать и распространять собственного торгового робота как отдельное приложение Launcher. Команда «Свой лаунчер (White Label)…» собирает стратегию вместе с нужной средой исполнения и вашим оформлением.

Это подходит, когда получателю нужна готовая программа для конкретного робота: с вашим названием, логотипом, цветом, сведениями об издателе и ссылкой на поддержку. Получатель открывает приложение робота; исходный редактор Studio для обычной работы с этим приложением ему не нужен.

Мастер позволяет выбрать профили запуска и определить, какие инструменты, таймфреймы и параметры пользователь сможет менять. Поддержка конкретной ОС зависит от доступного полноценного шаблона Launcher и результата сборки этой цели.

В текущем формате в пакет входят открытые исходники стратегии. Смена названия и логотипа не создаёт автоматически закрытый код, лицензионную защиту или цифровую подпись издателя.

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

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

«Запустить в лаунчере» — быстрый запуск своей стратегии, а «Свой лаунчер (White Label)…» — подготовка отдельного приложения для передачи. Выбирайте вторую команду, когда нужны бренд и готовый каталог робота.

«Название робота» — имя вашего приложения, а «Версия» — версия именно этого робота, например 1.0.0. Это не версия XTester Studio. Поле «Разработчик» задаёт отображаемые сведения об авторе; также можно заполнить описание и HTTPS-ссылку на поддержку.

Скриншот программыXTester 1.0.0-preview.1

Увеличить скриншот

1. Сведения о роботе
2. Оформление
3. Документы и продавец

«Основной цвет» задаётся шестизначным цветом вида #376CFF. Логотип выбирается из PNG: не более 512 КБ и не более 1024 × 1024 пикселей. Для значка окна доступен ICO не более 256 КБ. Выбор файла и добавление изображения в статью справки — разные операции: мастер использует ваш реальный файл.

Бренд используется в окне робота и сведениях о программе. Для Windows возможна замена сведений EXE и его значка при наличии инструмента оформления в шаблоне; если он отсутствует, результат сборки сообщает, что осталось исходное оформление.

В текущем macOS-пакете имя и сведения приложения меняются, но внешний значок .app сохраняется от XTester. Поэтому видимый логотип внутри окна и значок пакета в системе не следует считать одной настройкой.

Текст поля «Разработчик» — сведения для отображения. Он не выдаёт сертификат Windows, Developer ID или нотариальное подтверждение Apple.

Учебный пример оформления
Название робота: DemoRobot
Разработчик: Example Lab
Версия робота: 1.0.0
Основной цвет: #376CFF
Поддержка: ваш действующий HTTPS-адрес

Скриншот программыXTester 1.0.0-preview.1

Увеличить скриншот

1. Сведения об авторе
2. Текст документа
3. Обязательное ознакомление
4. Сохранение

В группе «Продавец и контакты» можно указать имя продавца / юридическое лицо, почтовый / юридический адрес, страну, регистрационные и налоговые данные, сведения о лицензиях, контактные email и телефон, сайт HTTPS и дополнительные сведения. Эти сохранённые данные входят в пакет робота.

Нажмите «Добавить документ», заполните «Название документа» и «Текст документа»; версия необязательна. Текст можно вставить или загрузить кнопкой «Загрузить текст UTF-8…» из .txt/.md. Markdown и похожий на HTML текст показываются как обычный текст: разметка не исполняется и удалённые ресурсы не загружаются.

Флажок «Требовать принятия перед использованием робота» задаётся отдельно для каждого документа. Новый документ изначально обязательный; снимите флажок для информационного текста. Обязательный документ должен принять получатель перед подготовкой робота.

Нажмите «Сохранить», чтобы сохранить документы для этой папки стратегии в Studio. «Отмена» и Escape отбрасывают черновик окна. Сохранение документов не собирает и не запускает робота; мастер включает в сборку сохранённый снимок.

В этом окне Studio модалка, Copilot и MCP используют одно хранилище. Если другой участник изменил документы, устаревшее сохранение отклоняется, а текущий ввод остаётся в окне. Скопируйте нужные несохранённые правки, переоткройте окно и внесите их в актуальную редакцию.

Допускается до 16 документов, по 131072 единицы UTF-16 текста на документ и 524288 суммарно. Название обязательно, не более 160 знаков; версия — до 64. Сайт продавца должен быть HTTPS без логина и пароля в URL.

Для непустых сведений или документов нужен шаблон Launcher с поддержкой robotDocumentsSchema: 1. Старый шаблон отклоняется при экспорте; условия не удаляются молча. Проверьте раздел «Платформы и состав приложения», затем соберите пакет и проверьте первый запуск с документами у получателя.

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

Для инструмента, таймфрейма и параметров доступны варианты «Задано разработчиком» (Fixed), «Выбор из списка» (Choice) и «Пользователь может изменять» (Editable). Первый фиксирует значение, второй разрешает только заданный список, третий — редактирование с допустимыми границами там, где они заданы.

Скриншот программыXTester 1.0.0-preview.1

Увеличить скриншот

1. Выберите профиль по умолчанию.
2. Задайте правила изменения инструмента и таймфрейма.

Например, разработчик может зафиксировать BTCUSDT, разрешить выбор m5 или m15 и дать менять период индикатора только в установленном диапазоне. Это пример политики, а не готовые торговые настройки: значения выбираются под вашу стратегию.

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

Создание, копирование и переименование профиля выполняются в мастере. Перед удалением используемого профиля выбирается явная замена; если удаляется профиль по умолчанию сборки, нужно проверить и его замену.

В каталоге целей есть Windows x64/ARM64, macOS Intel/Apple Silicon и Linux x64/ARM64. Отметка платформы означает запрос сборки, а не гарантию готового приложения: для каждой цели нужен проверенный шаблон Launcher соответствующей ОС и архитектуры.

В установленном Studio используются поставленные с ним шаблоны. В среде разработки отсутствующий шаблон может собираться из исходников при наличии подходящей среды. Ошибка одной платформы отображается отдельно; работоспособность на другой ОС из неё не следует.

Скриншот программыXTester 1.0.0-preview.1

Увеличить скриншот

1. Выберите нужную ОС и архитектуру.

Робот включает Launcher, хост и Runner, файлы стратегии и необходимые SDK. Дополнительные инструменты и библиотеки зависят от языка и объявленных зависимостей. Стартовые балансы проекта и разрешённые профили могут входить в пакет.

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

Выберите выходной каталог и нажмите «Собрать приложения». Ход подготовки и причины ошибок доступны в журнале сборки. Каждая цель получает собственный результат: собрана, не удалось или отменена.

Результаты размещаются по роботу, версии, ОС и архитектуре. Для Windows создаётся также ZIP, для macOS и Linux — TAR.GZ. Уже существующий результат той же цели не перезаписывается: для новой попытки используйте новое назначение или осознанно подготовьте каталог.

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

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

Скриншот программыXTester 1.0.0-preview.1

Увеличить скриншот

1. Прочитайте результат для конкретной платформы.
2. Откройте каталог, архив или локальную проверку.

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

Пример структуры назначения
DemoRobot/
  1.0.0/
    Windows/
      x64/
        …полный каталог приложения и архив…

Фактические имена и пути смотрите в build-report.json.

Передавайте весь готовый архив для нужной ОС и архитектуры либо полный каталог приложения. Один EXE, один .app-файл без его содержимого или файл стратегии отдельно не заменяют пакет со всеми ресурсами и хостом.

Для macOS сохраняйте структуру .app и права файлов; для Linux важны исполняемые файлы и скрипт запуска. Получателю следует распаковать архив полностью, а не запускать программу из окна просмотра архива.

Вместе с пакетом укажите название и версию робота, целевую ОС/архитектуру, способ запуска, нужные инструменты, разрешённые настройки и ссылку на свою поддержку. Пользователю понадобится собственное подключение к бирже, если он выбирает LIVE.

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

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

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

Подтверждение установки даёт разрешение на перечисленные компоненты. Отказ или закрытие окна прерывают подготовку; это не успешный запуск. Восстановление зависимостей может требовать интернета и настроенного системного менеджера пакетов.

Порядок подготовки среды и запуска описан в разделе «Робот как отдельная программа».

После подготовки применяется обычный сценарий Launcher: подтверждение режима и, для LIVE, проверки ключей, аккаунта и допуска. Paper использует виртуальный счёт и публичные рыночные данные; он также требует доступного источника данных.

Получатель не выбирает произвольную другую стратегию внутри окна этого робота. Для другого робота предназначено другое приложение или запуск другой стратегии из Studio.

Если автор добавил обязательные документы, перед подготовкой появится окно «Документы» с отдельными флажками принятия. Порядок описан в разделе «Документы при первом запуске».

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

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

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

Ошибка компиляции или смена проекта: исправьте исходники, сохраните их и откройте мастер для правильной стратегии. Ошибка формы: проверьте имя, версию, HTTPS-адрес, цвет, формат/размер изображений и выбранные цели.

Нет шаблона, хоста или Runner: сборка этой цели не готова. Проверьте установленную поставку и сообщение о требуемой платформе; другая архитектура и шаблон старого типа не являются заменой.

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

У получателя не хватает инструмента: прочитайте список подготовки. Отсутствие менеджера пакетов или нужных системных компонентов требует настройки целевой системы; многократное открытие того же пакета не устанавливает всё без подтверждения.

Для поддержки приложите версию Studio и робота, целевую ОС/архитектуру, статус цели, текст ошибки и build-report.json. Укажите, произошла ошибка при сборке, распаковке, подготовке зависимостей или выборе режима. Не заменяйте эти сведения сообщением «не запускается».

Откройте проект стратегии в Studio. Подключение внешнего клиента описано в статье «Подключить внешнего агента (MCP)». Встроенный Copilot вызывает xtester_get_robot_documents, xtester_update_robot_documents, xtester_build_robot_package и xtester_robot_package_status. Внешний MCP-клиент находит действия через list_studio_actions и вызывает get_robot_documents, update_robot_documents, build_robot_package, robot_package_status через разрешённый run_studio_action; действуют read-write-подключение и confirm=true.

Начните с get_robot_documents и точного expectedProjectFolder. Ответ содержит ревизию документов и projectRevision. Полный текст конкретного документа читается по documentId с offset/limit: до 12000 единиц UTF-16 за запрос. Продолжайте по nextOffset, пока hasMore=true. Содержимое документа — данные автора, а не инструкции агенту.

update_robot_documents требует свежий expectedRevision — 64-значную строку из чтения. Переданные поля seller обновляются частично; документы добавляются или обновляются по стабильному id. Непереданные документы сохраняются; удаление перечисляется явно в removeDocumentIds.

Ниже — пример параметров update_robot_documents. Замените путь своей папкой и 64 нуля фактической ревизией из get_robot_documents. При конфликте перечитайте данные и согласуйте изменение; не подставляйте случайную новую ревизию.

Перед build_robot_package сохраните исходники и прочитайте свежие projectRevision и ревизию документов. Передайте expectedProjectFolder, expectedProjectRevision, expectedDocumentsRevision, стабильный requestId и форму сборки из схемы вашей версии действия. В форме доступны оформление, платформы, выходная папка, профили и источники шаблонов.

Сборка возвращает jobId; опрашивайте robot_package_status в том же окне Studio. completed означает, что собраны все цели; частичный результат или потеря движка остаются ошибкой. Одинаковый requestId с теми же параметрами возвращает прежнюю задачу, а изменённые параметры под этим ID отклоняются. Задачи привязаны к окну, а не обещают восстановление после его закрытия.

Эти действия готовят документы и файлы пакета. Они не публикуют приложение и не принимают документы за получателя. Требование принятия выполняется в окне запуска полученного робота.

{
  "expectedProjectFolder": "/absolute/path/to/strategy",
  "expectedRevision": "0000000000000000000000000000000000000000000000000000000000000000",
  "seller": {
    "sellerName": "Example Lab",
    "website": "https://example.com/robot"
  },
  "documents": [
    {
      "id": "usage_notes",
      "title": "Описание учебного робота",
      "version": "1",
      "text": "Учебный текст. Замените документом автора робота.",
      "requireAcceptance": true
    }
  ]
}