EventScripts for Mac 完全操作指南

EventScripts for Mac 是一款专为 macOS 系统设计的自动化脚本编辑与执行工具。它允许用户通过编写和运行脚本，自动化处理重复性任务、管理系统事件、或与其他应用程序进行交互，从而显著提升工作效率。本文档将为您提供一份从入门到精通的详细操作指南。

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

启动 EventScripts 后，您将看到一个结构清晰、功能分区明确的主界面。主要分为以下几个区域：

• 菜单栏 (Menu Bar)：位于屏幕顶部，包含“文件(File)”、“编辑(Edit)”、“脚本(Script)”、“窗口(Window)”、“帮助(Help)”等所有高级功能入口。
• 工具栏 (Toolbar)：位于窗口顶部，提供新建、打开、保存、运行、停止、调试等最常用操作的快捷按钮。
• 导航侧边栏 (Navigator Sidebar)：位于窗口左侧。以树状结构展示当前项目中的所有脚本文件、资源库（Library）以及已配置的事件触发器（Event Triggers）。
• 脚本编辑区 (Script Editor)：窗口中央的核心区域。提供语法高亮、代码自动补全、错误提示等功能的代码编辑器，用于编写和修改脚本。
• 信息与日志面板 (Info & Log Panel)：通常位于窗口底部。
  • 信息 (Info)：显示当前选中脚本的属性，如关联事件、描述等。
  • 输出/日志 (Output/Log)：显示脚本运行时的打印输出、错误信息及调试日志，是排查问题的重要窗口。
• 实用工具区 (Utility Area)：位于窗口右侧（可折叠）。包含代码片段库（Snippet Library）、变量监视器（Variable Watcher）和快速帮助（Quick Help）。

二、完整工作流程：从创建到导出

1. 创建或打开项目

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

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

2. 创建并编写脚本

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

步骤2：编写脚本代码。在脚本编辑区进行编码。EventScripts 支持多种脚本语言（如 JavaScript、AppleScript）。编辑器会提供上下文提示。

3. 配置脚本触发器（事件）

步骤1：打开事件配置。在导航侧边栏，展开“事件触发器(Event Triggers)”分组。右键点击，选择 “添加新触发器(Add New Trigger)…”。

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

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

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

4. 测试与运行脚本

步骤1：直接运行测试。确保目标脚本编辑窗口处于活动状态。点击工具栏的 “运行(Run)” 按钮或使用快捷键 Command + R。运行结果和输出将实时显示在底部的日志面板中。

步骤2：调试脚本。如需调试，可在代码行号左侧点击设置断点。然后点击工具栏的 “调试(Debug)” 按钮或使用快捷键 Command + D 启动调试模式。程序将在断点处暂停，您可以在右侧工具区查看变量值。

5. 导出与部署脚本

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

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

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

三、常用功能进阶技巧

• 利用“监视变量”进行复杂调试：在调试模式下，将右侧工具区切换至“变量监视器”。您可以手动添加需要监视的变量名，实时观察其值的变化，这对于循环和条件判断的逻辑排查非常有效。
• 创建自定义代码片段库：将您常用的函数或代码块从编辑器拖拽至右侧“代码片段库”区域，为其命名和分类。之后在任何新脚本中，只需双击该片段即可插入，极大提升编码复用率。
• 使用项目模板快速启动：EventScripts 内置了多种项目模板（如“文件夹监控工具”、“定时提醒器”）。通过 “文件(File) -> 从模板新建项目(New Project from Template)” 创建，能获得一个包含基础框架和注释的项目，节省初始化时间。
• 脚本模块化与引用：对于大型项目，可以将通用功能写入独立的脚本文件。在其他脚本中，使用 include("另一个脚本.js") 或类似的函数（具体语法取决于所用语言）来引用，实现代码的模块化管理。

四、常见问题与解决方案

• 问题1：脚本运行时无任何输出或效果。
  • 解决方案：首先检查底部日志面板是否有错误信息（红色文字）。确保脚本已保存（Command + S）。检查事件触发器是否已正确启用（侧边栏触发器图标应为绿色激活状态）。在脚本开头添加简单的日志输出语句（如 `console.log(“脚本已启动”)`）来验证脚本是否被执行。
• 问题2：导出的应用程序在双击后立即退出或报错。
  • 解决方案：导出时请确保在选项中勾选了“包含必要的运行时库(Include necessary runtime libraries)”。检查脚本中使用的文件路径是否为绝对路径，在导出为应用后，应使用相对路径或让用户选择路径。尝试在 EventScripts 内直接运行脚本看是否有环境依赖错误。
• 问题3：事件触发器（如文件夹监控）不触发。
  • 解决方案：确认系统“安全性与隐私”设置中，已授予 EventScripts “辅助功能”和“完全磁盘访问权限”。检查监控的文件夹路径是否存在且有读写权限。重启 EventScripts 应用以重新加载所有触发器配置。
• 问题4：代码自动补全功能不工作。
  • 解决方案：检查菜单栏 “编辑(Edit) -> 首选项(Preferences) -> 编辑器(Editor)”，确认“启用代码补全(Enable code completion)”选项已勾选。尝试重启应用程序。确保脚本文件具有正确的文件扩展名（如 `.js`），以便编辑器识别语言模式。

五、快捷键汇总表