簡介
XXTLanControl 是一個區域網路中控平台，用來批次管理和控制 XXTouch 裝置。它主要包含以下幾個部分：
- 後端服務：提供 HTTP API，負責裝置通訊、檔案管理、資料儲存等核心邏輯
- Web 前端：基於瀏覽器的管理介面，涵蓋裝置清單、腳本管理、遠端控制、檔案管理、KVDB、TableDB、樣本工作台等功能
- 系統匣程式（可選）：Windows / macOS 下的系統匣，方便快速啟動或停止後端和開啟瀏覽器
- Lua 模組
XXTLanControl.lua：執行在裝置端的腳本庫，提供連接中控、日誌回報、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 啟動腳本，會自動選擇對應架構的 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/
更多用法請參閱後續章節。