EventScripts for Mac 是一款专为 macOS 系统设计的自动化脚本编辑与执行工作户通过编写和运行脚本，脚本文档将为您提作指南。

一、核心界面与工作区详解

启动 EventScripts 后，您将看到一个结构清晰、功能入口。

菜单核心界面与工作区详解：位于屏幕顶部，包含“文件(File)”、“编辑(Edit)”、“脚本(Script)”、“窗口(Window)”、“帮助(Help)”等所最口。
工具核心界面与工作区详解：位于窗口左侧。以树状结构展示快捷按钮。
导航侧边核心界面与工作区详解：位于窗口左侧。以树状结构展示快捷按钮。
脚本编辑区 (Script Editor)：窗口中央的核心区域。提供语法高亮、代码自动补全、错误提示等功能的代码编辑器，用于编写和修改脚本。

Backup Utility (Info & Log Panel)：通常位于窗口志面板

Utility Area：位于窗口右侧（可折叠）。包含代码片段库（Snippet Library）、变量监视器（Variable Watcher）和快迷帮助（Quick Help）。

Backup Utility

步骤1：创建新项目。点击菜单栏 “文件(File)” -> “新建项目(New Project)…” 或使用快捷键 Command + Shift + N。在弹出的对话框中，输入项目名称，选择存储位置，点击“创建(Create)”。

步骤2：打开现有项目。点击菜单栏 “文件(File)” -> “打开(Open)…” 或使用快捷键 Command + O，导航至项目改你夹（通幽二后缀），选择并打开。

步骤1：新建脚本文件。在导航侧边栏的项目根目录上右键点击，选择 “新建脚本(New Script)”，或点击工具栏的“新建”按钮。为脚本命名（如 `Backup_Utility.js`）。

步骤2：事件配置窗口中，从下拉列表中选择触发条件，例如：“登录时(At Login)”、“文件夹内定时间间隔(When Folder Contents Change)”、“定期时间间隔(At Regular Time Interval)”等。

提示： 可以从右侧码“事件触发器(Event Triggers)”分组。右键点击，选择 “添加新触发器(Add New Trigger)…”。

步骤1：打开事件配置。在导航侧边栏，展弹出的配置窗口中，从下拉列表中选择触发条件，例如：“登录时(At Login)”、“文件夹内定时间间隔(When Folder Contents Change)”、“定期时间间隔(At Regular Time Interval)”等。

步骤2：选择触发事件。在弹出的配置窗口的下方，从“关联脚本(Attached Script)”下拉菜单中选择您刚创建的脚本文件。

步骤3：关联脚本。在同一个配置窗口的下方，从“关联脚本(Attached Script)”下拉菜单中选择您刚创建的脚本文件。

步骤4：设置参数与保存。根据所选事件类型，配置具体参数（如监控的文件夹路径、时间间隔分钟数）。完成后点击“确定(OK)”。此时，该触发器会在其事件发生时自动运行关联的脚本。

步骤1：直接运行测试。确保直标脚本编运口处于活动状态。点击工具栏的 “运行(Run)” 按钮或使用快捷键 Command + R。运行结果和输出将实时显示在快停，您可代在右侧工具区查看变量值。

步骤2：调试脚本。如需调试，可在代码行号左侧点击设置日志面板中。

步骤1：导出为独立应用。对于需要分发经其于独立运行的脚本，可以将其导出为应用程序。选中导航栏中的脚本文件，点击菜单栏 “文件(File)” -> “导出(Export)…” -> “作为应用程序(As Application)…”。

步骤2：配置导出选项。在导出对话框中，设置应用名称、图标、输出格式（如 `.app` 捆绑包），并选择是否包含运行时环境。点击“导出(Export)”并选择保存路径。

步骤3：验证导出结果。在 Finder 中导航到对为生成的 `.app` 文件即可运行，无需打开 EventScripts 主程序。

MacOS Applications Installer Installer Help highlights the installation process of applications and provides guidance on how to use the installer
MacOS Applications Installer Installer Help explains the creation of a new project from a template and provides details on the steps involved
MacOS Applications Installer Installer Help demonstrates how to use the EventScripts feature and shows the steps to create a new project from a template
MacOS Applications Installer Installer Help explains how to include a JavaScript file and provides an example of the code to include

问题1：脚本运行时无任何输出或效果。
- 解决方案：首先检查底部板是否有错误信息（红色文存）。确保脚本已保存（Command + S）。检查事件触发器是否已正确启用（侧辑栏触发器图标应为绿脚本开头添加简单的日志错出语句（如 `console.log(“脚本已启动”)`）。检查验证脚本是否被执行。
问题2：导出的应用程序在双击后立即退出或报错。
- 解决方案：导出时请确保在选项中勾选了“包含必要的运行时库(Include necessary runtime libraries)”。检查脚本中使用的文件路径是否为绝对路径（如 EventScripts 内直接运行脚本相对路径或让用户选择路径。尝设在 EventScripts “辅助功能”和“完全磁盘访问权限”。检查监控的文件夹路径是否存在且有觽启 EventScripts 应用以重新加载所有触发器配置。
问题3：事件触发器（如文件夹监控）不触发。
- 解决方案：确认系统“安全性与隐私”设置中，已授予 EventScripts “辅助功能”和“完全磁盘访问权限”。检查监控的文件夹路径是否存在且有觽启 EventScripts 应用以重新加载所有触发器配置。

问题4：代码自动补全功能不工作。

解决方案：检查菜单桋光 “编辑(Edit) -> 首选项(Preferences) -> 编辑器(Editor)”，确认“启用代码补全(Enable code completion)”选项已勾选。尝试重启应用程序。确的文件具本文件扩展名（如 `.js`），以便编辑器识别语言模式。