Введение

XXTLanControl — консоль локальной сети для пакетного управления устройствами XXTouch. Она состоит из следующих основных частей:

• Сервис бэкенда: предоставляет HTTP API и отвечает за связь с устройствами, управление файлами, хранение данных и другую основную логику.
• Web-фронтенд: интерфейс управления в браузере со списком устройств, управлением скриптами и файлами, удалённым управлением, KVDB, TableDB, рабочей областью образцов и другими функциями.
• Трей-приложение (необязательно): системный трей Windows / macOS для быстрого запуска и остановки бэкенда и открытия браузера.
• Модуль Lua XXTLanControl.lua: библиотека скриптов на устройстве с API подключения к консоли, отправки логов, работы с KVDB, TableDB и файлами.

Структура дистрибутива

Названия дистрибутивов для разных систем различаются; обычно в них входят следующие элементы:

Windows

Путь / файл	Описание
XXTLanControl-tray-windows-amd64.exe	Запускатель трей-приложения: двойной щелчок запускает бэкенд и оставляет приложение в трее.
bin/XXTLanControl-backend-windows-amd64.exe	Сервис бэкенда центральной консоли.
bin/xxtlancontrol-mcpserver.exe	Сервис MCP.
dist/	Корень ресурсов выполнения; web/ содержит страницы Web-консоли, остальные файлы поставляются вместе с пакетом.
start-backend.cmd	Скрипт запуска из командной строки, удобен для диагностики.
XXTLanControl.lua	Модуль Lua для вызова возможностей консоли с устройства.

macOS

Путь / файл	Описание
XXTLanControl.app	Основной пакет приложения; двойной щелчок запускает трей и бэкенд.
XXTLanControl.app/Contents/MacOS/xxtlancontrol-mcpserver	Сервис MCP.
XXTLanControl.app/Contents/Resources/dist/	Корень ресурсов выполнения; web/ содержит страницы Web-консоли, остальные файлы поставляются вместе с пакетом.
start-backend.command	Скрипт запуска в терминале, удобен для диагностики.
XXTLanControl.lua	Модуль Lua для вызова возможностей консоли с устройства.

Linux

Путь / файл	Описание
XXTLanControl-backend-linux-amd64 / XXTLanControl-backend-linux-arm64	Двоичный файл бэкенда для соответствующей архитектуры.
xxtlancontrol-mcpserver	Скрипт запуска MCP, автоматически выбирающий двоичный файл нужной архитектуры.
xxtlancontrol-mcpserver-linux-amd64 / xxtlancontrol-mcpserver-linux-arm64	Двоичный файл MCP для соответствующей архитектуры.
dist/	Корень ресурсов выполнения; web/ содержит страницы Web-консоли, остальные файлы поставляются вместе с пакетом.
start-backend.sh	Скрипт запуска из командной строки.
XXTLanControl.lua	Модуль Lua для вызова возможностей консоли с устройства.

Основные возможности

• Управление устройствами: поиск и импорт устройств XXTouch в локальной сети, единое управление по группам.
• Запуск скриптов: загрузка скриптов на устройства с возможностью запускать, останавливать и приостанавливать их.
• Удалённое управление: просмотр экрана устройства в реальном времени, сенсорный и клавиатурный ввод, одновременное управление несколькими устройствами.
• Управление файлами: управление скриптами, ресурсами и отчётами консоли, включая загрузку, скачивание и редактирование онлайн.
• Управление данными: встроенные KVDB (очереди и словари) и TableDB (структурированные таблицы) для обмена состоянием между скриптами и хранения бизнес-данных.
• Планировщик: расписание, интервалы, одноразовый запуск, запуск пользователем, потребление очереди KVDB и другие способы запуска; доступны сценарии шагов и визуальные рабочие процессы.
• Рабочая область образцов: инструменты разработки скриптов для выбора цвета на снимке, обрезки областей, растровых шрифтов и захвата текстовых элементов.
• Пакетные операции: пакетная авторизация, установка новой версии XXTouch, переименование, снимки экрана, блокировка и разблокировка и другие операции.

Условия использования

• На устройстве должен быть установлен XXTouch и включён 远程访问.
• Устройство и консоль должны находиться в одной локальной сети, а брандмауэр консоли должен разрешать HTTP-порт (по умолчанию 46990).

Первый запуск

• Windows: дважды щёлкните XXTLanControl-tray-windows-amd64.exe; обычно браузер автоматически откроет консоль.
• macOS: откройте XXTLanControl.app; обычно браузер автоматически откроет консоль.
• Linux: запустите start-backend.sh, затем вручную откройте http://127.0.0.1:46990/.

Подробнее об использовании см. в следующих разделах.