跳到主要内容

# 脚本界面编辑器

脚本界面编辑器用来给脚本制作运行前参数表单。保存后，用户在主界面选择脚本时，可以先点 `配置` 填写参数，再运行脚本。

## 从脚本目录打开​

支持脚本界面配置的平铺脚本目录和 `.xpp` 脚本包目录会显示 `编辑脚本 UI 配置`。如果右键菜单中没有该项，先确认脚本是否放在 `脚本目录` 中，且目录结构可被中控识别。

典型流程是：

1. 在 `文件管理 → 脚本目录` 中右键平铺脚本目录或 `.xpp` 脚本包目录。
2. 选择 `编辑脚本 UI 配置`。
3. 从表单项列表添加输入框、开关、下拉框、多选组等内容。
4. 在预览区选中表单项，调整顺序。
5. 在属性区修改标题、默认值、选项列表等内容。
6. 预览表单确认无误后，点击 `保存`。

保存后回到主界面，在脚本下拉框中选择该脚本。如果配置有效，脚本下拉框旁会出现 `配置` 按钮。点击 `配置` 填写参数后，再运行脚本。平铺脚本保存到 `lua/scripts/main.json`，`.xpp` 脚本包保存到包根 `main.json`。

如果 `配置` 按钮没有出现，通常是还没有选中该脚本、配置没有保存成功，或配置内容无效。

## 从文本编辑器打开​

也可以在文本编辑器打开项目时，从项目树进入脚本界面编辑器：

1. 在项目树中找到 `main.json`。
2. 右键它并选择 `编辑脚本 UI 配置`。
3. 保存后继续回到文本编辑器编辑脚本或运行测试。

这种方式适合一边编辑脚本，一边调整运行前需要填写的参数。

如果同一脚本要给不同分组使用不同参数，可以再配合 设备分组 中的分组脚本配置功能。

## 表单项怎么选​

- `文本`：显示说明文字或分隔提示，不需要用户输入。
- `输入框`：填写账号、路径、关键词、数量等文本。
- `开关`：表示启用或关闭某个选项。
- `下拉框`：从较多选项中选择一个。
- `单选组`：从少量互斥选项中选择一个。
- `多选组`：同时勾选多个选项。

下拉框、单选组和多选组都需要配置选项。设置默认选中时，按界面提示填写选项序号；不确定时可以先不填默认值，保存后从 `配置` 按钮打开表单检查效果。