Introdução

XXTLanControl é uma plataforma de controle central em rede local para gerenciar e controlar dispositivos XXTouch em lote. Ela é composta principalmente pelas seguintes partes:

• Serviço de back-end: fornece a API HTTP e cuida da comunicação com dispositivos, do gerenciamento de arquivos, do armazenamento de dados e de outras funções centrais
• Front-end Web: interface de gerenciamento baseada no navegador, com lista de dispositivos, gerenciamento de scripts, controle remoto, gerenciamento de arquivos, KVDB, TableDB, Sample Workbench e outros recursos
• Aplicativo da bandeja (opcional): bandeja do sistema no Windows / macOS para iniciar e parar rapidamente o back-end e abrir o navegador
• Módulo Lua XXTLanControl.lua: biblioteca de scripts executada no dispositivo, com interfaces para conectar ao controle central, enviar logs, usar KVDB e TableDB e operar arquivos

Estrutura do pacote de distribuição

Os nomes dos pacotes de distribuição variam entre os sistemas. Os conteúdos mais comuns são os seguintes:

Windows

Caminho / arquivo	Descrição
XXTLanControl-tray-windows-amd64.exe	Inicializador da bandeja; ao clicar duas vezes, inicia o back-end e permanece na bandeja.
bin/XXTLanControl-backend-windows-amd64.exe	Serviço de back-end do controle central.
bin/xxtlancontrol-mcpserver.exe	Serviço MCP.
dist/	Raiz dos recursos de execução; web/ contém as páginas do console Web e os demais itens são recursos incluídos no pacote.
start-backend.cmd	Script de inicialização em modo de linha de comando, útil para investigar problemas.
XXTLanControl.lua	Módulo Lua usado pelo dispositivo para chamar os recursos do controle central.

macOS

Caminho / arquivo	Descrição
XXTLanControl.app	Pacote principal do aplicativo; clicar duas vezes inicia a bandeja e o back-end.
XXTLanControl.app/Contents/MacOS/xxtlancontrol-mcpserver	Serviço MCP.
XXTLanControl.app/Contents/Resources/dist/	Raiz dos recursos de execução; web/ contém as páginas do console Web e os demais itens são recursos incluídos no pacote.
start-backend.command	Script de inicialização em modo de terminal, útil para investigar problemas.
XXTLanControl.lua	Módulo Lua usado pelo dispositivo para chamar os recursos do controle central.

Linux

Caminho / arquivo	Descrição
XXTLanControl-backend-linux-amd64 / XXTLanControl-backend-linux-arm64	Binários de back-end fornecidos para cada arquitetura.
xxtlancontrol-mcpserver	Script de inicialização do MCP que escolhe automaticamente o binário MCP da arquitetura correspondente.
xxtlancontrol-mcpserver-linux-amd64 / xxtlancontrol-mcpserver-linux-arm64	Binários MCP fornecidos para cada arquitetura.
dist/	Raiz dos recursos de execução; web/ contém as páginas do console Web e os demais itens são recursos incluídos no pacote.
start-backend.sh	Script de inicialização em modo de linha de comando.
XXTLanControl.lua	Módulo Lua usado pelo dispositivo para chamar os recursos do controle central.

Principais recursos

• Gerenciamento de dispositivos: detecte e importe dispositivos XXTouch na rede local e gerencie-os por grupos
• Execução de scripts: envie scripts para os dispositivos e inicie, pare ou pause-os a qualquer momento
• Controle remoto: veja a tela dos dispositivos em tempo real, use toques e teclas e controle vários dispositivos simultaneamente
• Gerenciamento de arquivos: gerencie scripts, recursos, relatórios e outros arquivos no controle central, com suporte a upload, download e edição online
• Gerenciamento de dados: use o KVDB integrado (filas + dicionários) e o TableDB (tabelas estruturadas) para compartilhar estado entre scripts ou armazenar dados de negócio
• Tarefas agendadas: use vários gatilhos, como horário, intervalo, execução única, acionamento pelo usuário e consumo de filas KVDB, com orquestração de etapas e fluxos visuais
• Sample Workbench: ferramentas auxiliares de desenvolvimento de scripts para capturar cores em screenshots, recortar regiões, criar dicionários de bitmap e capturar elementos de texto
• Operações em lote: autorização, instalação da versão mais recente do XXTouch, renomeação, screenshots, bloqueio/desbloqueio de tela e outras operações em lote

Pré-requisitos

• O dispositivo precisa ter o XXTouch instalado e 远程访问 ativado
• O dispositivo e o controle central precisam estar na mesma rede local, e o firewall do controle central deve permitir a porta HTTP (por padrão, 46990)

Primeira inicialização

• Windows: clique duas vezes em XXTLanControl-tray-windows-amd64.exe; normalmente o navegador abre o console automaticamente
• macOS: abra XXTLanControl.app; normalmente o navegador abre o console automaticamente
• Linux: execute start-backend.sh e acesse manualmente http://127.0.0.1:46990/

Consulte os capítulos seguintes para obter mais informações sobre o uso.