跳到主要内容

脚本管理

导入脚本到中控​

  1. 打开 文件管理 → 脚本目录。
  2. 把本地脚本文件、脚本文件夹或完整的平铺脚本目录拖入文件管理器。
  3. 上传完成后，脚本会自动出现在主界面的脚本下拉框中，可以直接选择并运行。
  4. 脚本较多时，可以在 脚本目录 内新建文件夹分类整理。

什么是平铺脚本​

中控最适合管理的是"平铺脚本"——也就是包含 lua/scripts/main.lua 或 lua/scripts/main.xxt 的目录。例如：

我的脚本/
├── res/
│   ├── icon.png
│   └── sample.png
└── lua/
    ├── helper.lua
    └── scripts/
        ├── main.lua
        └── main.json

上传这类目录后，中控会把整个文件夹当作一个可运行的脚本单元——传输到设备时按目录结构展开，以 main.lua 或 main.xxt 作为入口。

启动与停止脚本​

  1. 在主界面的脚本下拉框中选好脚本。
  2. 在 设备列表 中勾选目标设备。
  3. 点击动作条上的"启动脚本"，中控会先把脚本传到设备，再在设备上启动。
  4. 需要停止时，在同一动作条上点击"停止脚本"即可。

如果同时勾选了分组，并且分组绑定了脚本，那么分组脚本会优先于动作条当前选择的脚本，详细规则见 设备分组。

上传脚本到设备 / 让设备端选中脚本​

  • 上传脚本到设备：把某个中控脚本或"本地所有脚本"批量传到设备，但不会立即启动。
  • 让设备端选中指定脚本：只切换设备端当前选中的脚本，适合后续在设备本地手动运行。

给脚本添加配置界面​

  1. 在 文件管理 → 脚本目录 中右键一个平铺脚本目录。
  2. 选择 编辑脚本 UI 配置。
  3. 在脚本界面编辑器中维护 lua/scripts/main.json。
  4. 回到主界面后，如果当前脚本带配置界面，脚本下拉框右侧会出现“配置”按钮。

同一个脚本既可以使用默认的 main.json 参数，也可以在分组上保存专属配置。

XXTLanControl.lua 的更新方式​

  • 在 系统配置 → 脚本运行设置 中，可以设置运行脚本前是否自动传输 XXTLanControl.lua。
  • 同一面板还提供"立即更新"功能，可以把 脚本目录 中已有的 XXTLanControl.lua 批量替换为当前服务器版本。