跳到主要内容

# 脚本管理

## 导入脚本到中控​

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` 作为入口。

`.xpp` 脚本包也可以作为脚本单元管理。它的中控配置界面文件放在包根目录的 `main.json`，不放在 `lua/scripts/` 下。

`.xpa` 加密包可以通过文件关联双击打开，或拖入 `文件管理 → 脚本目录` 后安装；安装后会成为 `脚本目录` 下的 `.xpp` 脚本包。

## 启动与停止脚本​

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

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

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

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

## 给脚本添加配置界面​

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

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

## XXTLanControl.lua 的更新方式​

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