脚本界面编辑器

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

从脚本目录打开

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

典型流程是：

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

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

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

从文本编辑器打开

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

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

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

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

表单项怎么选

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

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