Butler for Mac 全方位使用指南

Butler 是一款运行于 macOS 系统上的全局自动化工具，其核心思想是通过用户自定义的“触发器”和“动作”，将繁琐、重复的日常操作转化为瞬间完成的自动化流程。它并非一个拥有传统图形界面的应用程序，而是深度集成于系统菜单栏，通过面板、弹出框和规则列表进行交互，实现对文件、应用程序、文本、音乐等几乎一切系统元素的智能控制。

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

Butler 的界面主要由三部分组成：菜单栏图标、主配置面板和各功能弹出面板。

1. 菜单栏图标

• 位置与状态：安装后，Butler 的齿轮状图标会常驻在屏幕右上角的菜单栏。图标颜色通常为灰色，当有规则被触发或正在执行时，可能会有视觉反馈。
• 主要功能：点击图标会弹出主菜单，这是访问所有功能的起点。菜单中通常包含：“Rules”（规则列表）、“Pop-up Menus”（弹出菜单）、“Hotkey Windows”（热键窗口）、“Snippets”（文本片段）等核心模块的快捷入口，以及“Preferences”（偏好设置）和“Quit”（退出）选项。

2. 主配置面板 (Preferences)

通过菜单栏图标选择 Preferences 或使用快捷键 Command + , 打开。这是 Butler 的“大脑”和“控制中心”，所有自动化规则的创建、编辑和管理都在此进行。

• 左侧导航栏：以列表形式清晰划分功能模块。
  • Rules：核心工作区，所有自动化规则在此定义和管理。
  • Pop-up Menus：配置通过热键或点击触发的自定义上下文菜单。
  • Hotkey Windows：设置通过热键唤出的快速搜索/操作窗口（如应用切换、文件搜索）。
  • Snippets：管理文本扩展片段。
  • Triggers：查看和管理所有已定义的触发器（如热键、菜单等）。
  • Global：全局设置，如启动选项、更新、日志等。
• 中央规则列表/编辑区：在“Rules”选项卡下，此处显示所有已创建规则的列表。点击任意规则，下方会展开详细的编辑区域。
• 规则编辑区：包含三个核心部分：
  • Trigger(s)：定义规则何时被激活。可添加多个触发器，如热键、菜单项、文件拖放等。
  • Condition(s)（可选）：设置规则执行的前提条件，如特定应用程序在前台、特定文件类型等。
  • Action(s)：定义规则触发后要执行的一系列操作，如打开文件、运行脚本、控制音乐、输入文本等。

二、完整操作流程：从创建规则到生效

以下以创建一个“快速打开项目工作文件夹”的规则为例，展示完整流程。

步骤 1：打开规则配置面板

1. 点击菜单栏的 Butler 图标。
2. 选择「Preferences…」，或直接按下 Command + ,。
3. 确保左侧导航栏选中「Rules」选项卡。

步骤 2：创建新规则

1. 在中央规则列表区域的底部，找到并点击 “+”（加号）按钮。
2. 列表中将新增一条名为“Untitled Rule”的规则。点击它，下方编辑区激活。
3. 在编辑区顶部的「Description」字段，为规则输入一个易于识别的名称，例如“打开工作项目文件夹”。

步骤 3：设置触发器 (Trigger)

1. 在「Trigger(s)」区域，点击 “Add Trigger” 按钮。
2. 从弹出的触发器类型列表中选择 “Hot Key”（热键）。
3. 一个热键设置框会出现。将光标置于输入框内，按下你想要设定的组合键，例如 Control + Option + Command + P。Butler 会自动记录并显示。
4. 你可以在右侧下拉菜单中调整热键的“When”（触发时机），如“任何时间”或“当某应用活跃时”。

步骤 4：添加动作 (Action)

1. 在「Action(s)」区域，点击 “Add Action” 按钮。
2. 从庞大的动作列表中找到并选择 “Open File/Folder”（在“Files & Folders”分类下）。
3. 动作被添加后，会出现详细设置。点击 “Choose…” 按钮，在弹出的 Finder 窗口中选择你想要快速打开的目标文件夹（例如：`~/Documents/Projects`）。
4. 其他选项如“使用哪个应用程序打开”通常保持默认（Finder）即可。

步骤 5：保存并测试

1. 无需手动保存，Butler 的规则是实时生效的。直接关闭 Preferences 窗口即可。
2. 测试：在任何界面，按下你刚才设置的热键 Control + Option + Command + P。一个 Finder 窗口应该立即弹出并定位到你指定的项目文件夹。

三、常用功能进阶技巧

1. 组合触发器与多条件判断

一个规则可以拥有多个触发器（例如，一个热键 + 一个菜单项）。同时，在「Condition(s)」区域可以添加多个条件进行“与”逻辑判断。例如，创建一个规则，仅当“Safari 是当前应用”且“当前网页地址包含‘github.com’”时，按下热键才执行特定动作。

2. 使用弹出菜单 (Pop-up Menus) 组织常用操作

在「Pop-up Menus」模块，可以创建层级式的自定义菜单，并通过热键或鼠标点击（如按住某个修饰键点击菜单栏图标）唤出。这是将大量相关规则（如所有开发工具启动命令）归类收纳的绝佳方式，避免热键冲突和记忆负担。

3. 文本片段 (Snippets) 的智能应用

在「Snippets」模块定义的文本扩展，不仅可以通过输入缩写后按触发键（如Tab）来插入，还可以在规则的「Action」中调用。更强大的是，可以为片段设置“动态内容”，如当前日期、剪贴板内容、计算结果等，实现智能输入。

4. 利用“Hotkey Windows”实现快速应用切换或文件搜索

配置一个“Application Switcher”类型的热键窗口，绑定一个热键（如 Option + Space）。按下后，会出现一个搜索框，输入应用名的一部分即可快速过滤并启动/切换应用，比原生的 Command + Tab 更高效。

四、常见问题与解决方案

Q1：设置的热键没有任何反应。

• 检查冲突：该热键可能已被 macOS 系统快捷键（系统偏好设置 > 键盘 > 快捷键）或其他应用程序占用。尝试更换一个更复杂、不常用的组合键。
• 检查 Butler 状态：确认菜单栏图标存在，且规则已启用（规则列表前的复选框应勾选）。
• 重启 Butler：有时重启应用可以解决临时性问题。通过菜单栏图标选择「Quit」后重新启动。

Q2：规则在某些应用程序中不生效。

• 添加应用程序条件：这通常是设计使然。检查该应用程序是否请求了特殊的辅助功能或输入监控权限。前往「系统偏好设置 > 安全性与隐私 > 隐私」，在“辅助功能”和“输入监控”列表中，确保 Butler 已被勾选。
• 检查条件限制：回顾规则中是否设置了“Condition”限制了该应用。

Q3：如何备份或迁移我的 Butler 设置？

Butler 的所有配置存储在 `~/Library/Application Support/Butler/` 目录下的配置文件中。要备份，只需复制整个「Butler」文件夹。要迁移到新 Mac，将备份的文件夹覆盖到新电脑的相同路径，然后重启 Butler 即可。

Q4：创建的弹出菜单如何触发？

在「Pop-up Menus」中编辑好菜单后，需要为其分配一个“触发器”。在「Triggers」选项卡下，找到“Pop-up Menu”分类，为你创建的菜单添加一个热键触发器。之后，按下该热键即可在任何位置唤出该自定义菜单。

五、Butler for Mac 快捷键汇总表

以下为 Butler 自身界面操作及部分全局管理快捷键（用户自定义规则的热键不在此列）。

重要说明：上表仅为 Butler 自身应用的快捷键。用户通过 Butler 为系统和其他应用定义的所有自动化热键，需在各自的规则中查看和管理。