编注：在栏目更新过程中，一些刚开始接触 Keyboard Maestro 的读者给我们发来反馈，对软件的基本操作和概念还有些不熟悉。因此我们邀请栏目作者 @TomBen 加更了这篇给新手的入门引导文章，希望帮助各位能更好上手 Keyboard Maestro。

如果你是一名 Mac 用户，可能或多或少都听说过 Keyboard Maestro。一方面，有人惊呼 Keyboard Maestro 为神器，对它赞不绝口，称赞它能极大地提高个人效率，甚至将其誉为 macOS 上的终极生产力工具（The Ultimate Productivity Tool for Mac），更有网友表示，这款软件「改变了他们的生活」。然而另一方面，也有不少人抱怨 Keyboard Maestro 太过复杂，面对繁杂的页面不知如何下手，自己动手制作 macro 门槛似乎有点高，或者 macro 老是运行不成功等等。

无论你此前使用过 Keyboard Maestro，相信通过阅读这篇文章，都会帮助你初步了解这款功能强大的自动化软件，助力工作和学习效率的提升。

Keyboard Maestro 最初由 Michael Kamprath 开发，于 2002 年发布 1.0 版本。后来由于 Michael Kamprath 个人精力有限，无法继续开发，这款软件在 2004 年被 Stairways Software 收购并发布 2.0 版本，一直持续更新至今。

截至 2023 年 9 月，Keyboard Maestro 最新版本为 10.2。从 2.0 和 10.2 版本的截图可以看出，Keyboard Maestro 的操作逻辑始终是一样的，即以 macro 为核心，而 macro 则由 trigger 和 action 组成，同时 macro 又包含在特定的 macro group 中：

• Macro Group: 用于组织 macro，类似于文件夹，不同的 group 可以设置不同的规则，位于上方截图的最左列。
• Macro: 用于自动化 Mac 上的工作流程、程序或进程，位于上方截图的中间列。
• Trigger: macro 的触发方式，即满足某种条件的情况下，一个 macro 会被执行，一个 macro 可以有多个 trigger。例如上方截图最右列中的 trigger 是「The clipboard filter menu item is selected」。
• Action: macro 要执行的特定过程的步骤，一个 macro 可以包含一个或多个 action。例如上方截图中的 action 是「Filter Trigger Clipboard with Capitalize」。此外，还可以点击每个 action 右上角的齿轮 ⚙️ 来进一步调整 action 设置，例如禁用 action、设置 action 的颜色、拷贝为图片等。

安装 Keyboard Maestro

你可以在 Keyboard Maestro 官网下载软件安装包。点击主页上的「Free Trial」之后，会得到一个 .zip 压缩包，解压缩之后就会得到 Keyboard Maestro 软件本体，只需将其拖入 /Applications（应用程序）文件夹中，就安装成功了。需要注意的是，Keyboard Maestro 10 最低支持 macOS 10.13 High Sierra。

如果你习惯使用 Homebrew 安装软件，直接在终端中输入这行命令即可完成安装：

brew install --cask keyboard-maestro

Keyboard Maestro 提供 30 天的免费试用，试用结束后需要购买许可证（License）才能继续使用，售价为 36 美元，一个许可证最多可激活 5 台 Mac。如下图所示，Keyboard Maestro 的激活提示信息会显示使用该软件已节约的时间，并将其与美国的最低工资挂钩，充分体现了用「金钱换时间」的理念。

在软件订阅制盛行的今天，Keyboard Maestro 仍然坚持大版本买断制。每隔几年，它会发布一个升级版本，老用户需要以 25 美元的价格进行升级。当然选择不升级也是可以的，可以一直使用已购买的版本。值得一提的是，在 Keyboard Maestro 中输入已购买的序列号之后，软件会播放一个「Thank You」的语音，还是非常有趣的，记得激活时不要错过这个小彩蛋哦。

需要注意的是，Keyboard Maestro 10 的图标还没有适配 macOS Big Sur 以来的圆角图标。如果你想要更改它的图标，可以前往 macOS App icons 这个网站下载网友制作的 Keyboard Maestro 圆角图标并进行替换。

赋予 Keyboard Maestro 权限

作为一款功能全面的自动化应用，Keyboard Maestro 需要获取相应的 macOS 系统权限才能正常工作。一般情况下，Keyboard Maestro 会自动弹出提示，让你在系统设置中勾选相应的系统权限，但由于 macOS 逐渐收紧的安全措施或者奇怪的 bug，导致无法弹出提示。在这种情况下，你需要在系统设置（System Settings）中进行操作。具体来说，Keyboard Maestro 主要需要以下这两个系统权限：

• 辅助功能（Accessibility）：Keyboard Maestro 中很多功能都需要允许辅助功能，比如菜单项选项、操作应用窗口、监听键入字符串等。你可以在「系统设置 -> 隐私与安全性 -> 辅助功能」中打开「Keyboard Maestro」和「Keyboard Maestro Engine」右边的按钮。

• 屏幕录制权限（Screen Recording Permission）：在捕捉屏幕图像、在屏幕上查找图像等操作时需要用到这一系统权限。如果你在未授予 Keyboard Maestro 屏幕录制权限的情况下使用这些操作，可能会导致失败。在某些情况下，系统会提示你允许屏幕录制权限，你也可以手动在「系统设置 -> 隐私与安全性 -> 屏幕录制」中打开「Keyboard Maestro」右边的按钮，如下图所示。

此外，「文件和文件夹」、「联系人」等系统权限一般无需手动开启，Keyboard Maestro 会在需要的时候自动弹出来让你进行确认。

除了以上这些系统权限外，Keyboard Maestro 往往还需要控制其他应用程序，因此也需要授予相关权限。不过好在这些操作会在首次用到时自动弹出，只需确认即可，如下图所示。

如果你不确定 Keyboard Maestro 能够控制哪些应用，或者需要对其进行修改，可以前往「系统设置 -> 隐私与安全性 -> 自动化」中找到 Keyboard Maestro 下方的应用程序，如下图所示。

创建 macro

在安装好 Keyboard Maestro 之后，首次启动时会显示一个新手导览页面，如下图所示。

点击其中的「Start Tutorial」按钮，将会出现一个交互式教程，演示如何创建一个简单的 macro，并在按下某个快捷键时打开文件夹。下面让我们跟着这个教程走一遍，熟悉一下 Keyboard Maestro 的界面和创建 macro 的基本操作步骤。

在最左侧一列中选择一个 group，这里的教程提示我们选择「Global Macro Group」，这是 Keyboard Maestro 中一个默认的 group。

点击中间列下方的加号 ➕ 按钮。

如下图所示，点击加号之后，会在当前的「Global Macro Group」中创建一个名为「Untitled Macro」的 macro。

Keyboard Maestro 提示点击「New Trigger」左边的加号，添加一个 trigger。在这个例子中，我们选择「Hot Key Trigger」，然后根据提示设置快捷键为 F6。

接下来点击「New Action」左侧的加号添加一个 action。

点击加号之后，左侧会弹出所有的 actions 列表，我们点击「Open」actions。

然后再双击「Open a File, Folder or Application」action，就完成了添加 action 的步骤。

完成之后，点击左上角的叉号关闭添加 action 的界面。

最后，在「Open a File, Folder or Application」action 中一个文件（或者文件夹、应用程序），比如下图中的 ~/Documents。

经过上述步骤，我们就制作好了一个打开 ~/Documents 的 macro。由于这个 macro 位于「Global Macro Group」，因此，在任意位置按下快捷键 F6，就会打开 ~/Documents 目录。

软件基本设置

打开 Keyboard Maestro，点击菜单栏中的「Settings…」，或者按下快捷键 ⌘ + ,，就会打开软件的设置界面。

可以看到，设置界面的上方有 6 个图标，对应着 6 类设置：

• General：包括是否开机时启动、同步 macros、软件外观、菜单栏图标等。
• Palette：设置 4 种 Palette 的样式，包括 Default Palette、Global Macro Palette、Applications Palette、Conflict Palette，我们会在后面的文章中进行详细介绍。
• Web Server：设置 Web 服务器，很少会用到，默认为关闭状态。
• Clipboards：剪贴板设置，可以在这里添加、删除和重命名所有 Named Clipboards，并查看和更改它们的值。
• Variables：变量，可以在这里查看、添加和删除所有 macros 中的变量，以及查看和更改变量值。
• Exclude：管理排除应用程序的列表，包括 Application Switcher、Applications Palette 排除以及剪贴板历史。

如果你需要查看所有 macro 的历史执行记录，可以点击菜单栏中的「Help -> Open Logs Folder」，然后就会打开位于 /Users/username/Library/Logs/Keyboard Maestro 的日志文件，双击打开 Engine.log 即可看到所有 macro 的历史执行记录。对于制作某些复杂的 macro 来说，查看日志文件有助于测试和诊断 macro 的执行结果。

在菜单栏中的「Help」选项中，还有很多其他选项，比如打开 Keyboard Maestro 官网、用户手册、论坛等网页。如果你在首次启动 Keyboard Maestro 时忽略了新手导览，并且取消勾选「Show this window when Keyboard Maestro opens」，那么可以点击「Help」下方的「Welcome to Keyboard Maestro」中重新打开新手导览，如下图所示。

值得一提的是，Keyboard Maestro 的所有设置文件都保存在以下这两个目录中：

• ~/Library/Application Support/Keyboard Maestro：主要的设置数据文件夹，例如剪贴板数据、变量数据、所有 macros 等。
• ~/Library/Preferences 文件夹下的com.stairways.keyboardmaestro.editor.plist、com.stairways.keyboardmaestro.engine.plist 和 com.stairways.keyboardmaestro.plist，包括其他的设置数据，以及许可证信息（邮箱和序列号）。

导出、导入和同步 macros

在 Keyboard Maestro 中，选中任意一个 macro 或 macro group，然后点击右键，选择「Export Macro」，便可导出选中的 macro 或 macro group，得到一个后缀名为 .kmmacros 的文件。

尽管 .kmmacros 文件看上去是一种 Keyboard Maestro 的专属文件类型，但实际上它是一种 Plist 文件，你可以直接用 VS Code 等文本编辑器打开查看其内容或进行编辑（当然一般情况下无需手动编辑）。与 Alfred Workflow、PopClip Extension 等保存为压缩文件的形式相比，这种方式更具可读性和透明性，并且可以更好地避免恶意软件。

如果你需要安装其他人分享的 macro，只需双击 .kmmacros 文件，然后就会自动在 Keyboard Maestro 中打开。此外，你也可以在 Keyboard Maestro 中点击「File -> Import -> Import Macros Safely…」来导入 macro。

需要注意的是，.kmmacros 文件可能包含一个或多个 group，也就是 macro 和 macro group。如果你的已有 macro group 中不存在要导入的 group，则会新建一个 macro group。默认情况下，导入的 macro 会被禁用（除非在导入时按住 Option 键），以防止意外触发。

如果你需要通过 iCloud、Dropbox 等服务在多台 Mac 上同步 macros，只需在 Keyboard Maestro 中点击「Setting -> General」，然后勾选「Sync Macros」，然后会出现下图中的提示。

如果你此前没有同步过，就选择「Create New」，若之前已有同步文件，就选择「Open Existing」。选择之后，会创建或打开一个以 .kmsync 为后缀的同步文件。请注意，「Open Existing」会替换 Keyboard Maestro 中已有的 macros，在执行此操作前务必备份一下。