# Keyboard Maestro简介 Make Your Mac Dance！ *** ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142355982.png) Keyboard Maestro 也许是适用于 Mac 的最强大的自动化工具。 最重要的是，任何人都可以简单上手。 Keyboard Maestro 不依赖于脚本语言，只需要设置好 「触发器 Trigger」 和 「动作 Action」 ，即可制作出满足需求的宏。 ### 逻辑简单🥳 任务自动化的逻辑非常简单，只需要三步： 1. [拆解任务](/chai-jie-ren-wu-de-fang-fa) 2. 选择[触发器（Trigger）](/chu-fa-qi-trigger) 3. 设置[动作（Action）](/dong-zuo-action) ![任务自动化的逻辑](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403171141419.png) ### 快速上手！ 我们以一个简单示例来实践一下Keyboard Maestro的自动化逻辑。 > **场景示例：日常工作中时常会遇到需要保存的文本，而这些文本都需要保存到指定文本文件中。** 平时遇到上述场景，我们通常要重复进行以下动作： > 1. 先想好：文本要保存到何处，目标文本文档的存储位置在哪？ > 2. 在访达（Finder）中找到文本文档的存储位置，打开文档。 > 3. 执行复制、粘贴操作，进行保存。 ➀ 首先，我们对任务进行拆解，根据[拆解任务](/chai-jie-ren-wu-de-fang-fa)的逻辑，我们可以得出，该任务属于「重复无交互式任务」，即： * 在任务中无需引入其他类型的变量，待复制文本只需要通过复制粘贴命令即可实现（重复性任务） * 目标存储文本文档确定，存储位置确定（重复性任务） * 不需要根据用户的指令来确定任务走向，即无需进行交互（无交互式任务） ➁ 然后选择触发器。为了演示方便，这里选择用快捷键「F2」进行触发。 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403171732789.png) ➂ 设置动作 假如，目标文本文档储存在桌面上，名称为 `Saved.txt`，那么动作就可以拆解为： * 拷贝文本 * 打开桌面的 `Saved.txt`文本文档 * 找到最后一行（通过模拟「⌘↓」按键来实现） * 粘贴 * 换行（通过模拟「Return」按键来实现） * 保存（通过模拟「⌘S」按键来实现） * 退出（通过模拟「⌘W」按键来实现） * 激活上一个应用程序 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403171758345.png)
在上述示例的基础上，为了区分保存时间，还可以插入时间戳，由于时间戳是变量，因此，上述任务就变成了「变动无交互式任务」，具体区别见下图。 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403171815774.png) 这个宏中不仅引入了[变量](/bian-liang)`%LongDate% %ShortTime%`，还使用了[命名剪贴板](/jian-tie-ban)`Named Clipboard`。具体使用方法，请参见链接。 # 重要提示：本手册正在完善中... 尚未完工，敬请谅解！\~ # 写在前面：为什么要做中文手册？ 我最早了解到 `Keyboard Maestro` 是在王树义老师的节目中，我还记得当时老师给的示例是「如何将复制的文本，格式化为自己想要的样式」。那时尝试了一下，觉得功能很强大！ 在此之前，我用过 `Alfred` 、 `atext` 、Mac自带的 `Automator` 。Keyboard Maestro的功能，上述App也都能实现，但一方面是功能比较分散，另一方面是 Keyboard Maestro 可以通过拖拽的方式来添加动作，这一点对新手更加友好，虽然`Automator`也可以通过拖拽的方式进行操作的添加，可能是我学的不深入，经常弄不明白其控制逻辑，用着不顺手。相比来说，`Keyboard Maestro` 的操作逻辑更为简单，对于新手更加友好。 ### 至今没有中文手册可用 由于 `Keyboard Maestro` 的中文社区并没有发展起来，至今都没有中文手册。 有的人可能会说，官网有英文手册和英文Wiki，但是毕竟对于广大用户而言，阅读英文手册还是比较困难。 ### 英文手册不完善 #### 英文手册内容不充实 英文手册内容不充实，查找资料需要反复跳转。 官方的英文手册简单介绍了各个功能模块，并给出了一些注意事项，对各功能模块没有进行深入地解释。例如，手册并没有对触发器和动作的具体条目进行讲解，要了解这部分的用法需要到官网Wiki中进行查找。 #### 英文手册的示例太简要，解释不够 英文手册也会给出一些示例，但示例很简要，没有详细的解释。 #### 官网 Wiki 撰写拗口 官网Wiki中有关各条目的介绍也很简略，文字表述很拗口，官方也没有给出更多的解释，有的句子即便是结合其给出的示例，也很难理解其要表达的真实含义。 例如在[输入字符串触发器](https://wiki.keyboardmaestro.com/trigger/Typed_String)条目有一段介绍： > You can limit the typed string trigger to only work after a word break (which means any non-alphanumeric character, or any case that cancels the sequence as described above). Note that this means the match will happen only after you type a word break and then the Typed String - Keyboard Maestro does not know what you will type in the future so it cannot restrict matches to only happen if you plan to type a word break next. 翻译过来： > 您可以将键入的字符串触发器限制为仅在断字后起作用（这意味着任何非字母数字字符，或取消上述序列的任何情况）。请注意，这意味着仅在您键入分词符、然后键入字符串后才会发生匹配， - Keyboard Maestro 无法预知你未来会键入什么，所以它不能仅在你计划接下来键入一个词边界时才匹配字符串。这意味着，触发条件的检测只能在你实际完成键入动作之后进行，而不是基于你未来的键入计划。 看完之后，我们会发现，即使翻译成中文，上述内容也很难理解，具体解释请参见本手册 [/pages/VpJb7ReUzugWAR7zr8wj#id-3.-hou-xu-jie-de-nei-rong-zhong-lei](https://km.qxpai.cn/pages/VpJb7ReUzugWAR7zr8wj#id-3.-hou-xu-jie-de-nei-rong-zhong-lei "mention")。 所以，我想做这个中文手册，目的是方便大家更好地查询资料、更好地理解每一项操作的含义，对难理解的操作进行解释，并通过示例直观地展示，方便大家更好地理解、更好地使用这款软件。 ### 市面上的教程不能能满足需求 市面上存在的一些教程也好，使用心得也好，更多的聚焦于具体场景下的设置，但是据对于具体设置的含义，并没有进行清楚地解释，也没有对各触发器和动作中需要注意的事项进行明确地说明和解释，每个接触Keyboard Maestro的用户都需要重新摸索，提高了使用门槛。 ### 这本手册有什么特点？ * 方便查找：将英文手册与官网Wiki相结合，只需要在这一处就可以解决您的大部分疑问。 * 对条目进行充分释义，帮助大家更好地理解每一项的真实含义。 * 配合更多的示例，用图片和`Gif`的形式，更直观地展示具体用法及不同条目之间的区别。 * 配套有详细视频教程，目前视频教程正在开发中，敬请期待！ # 进度 工作量巨大，多多包涵 🤣...... ### 简介 * [x] 简介 ### 界面介绍 * [ ] 界面介绍 ### 触发器 * [x] 快捷键 * [x] 全局宏浮窗触发器 * [ ] 状态菜单触发器 * [x] 输入字符串触发器 * [ ] 外观改变触发器 * [ ] 应用触发 * [ ] 音频输出设备更改触发 * [ ] 剪贴板更改触发器 * [ ] 剪贴板过滤器触发器 * [ ] 定时触发器 * [ ] 显示布局更改触发器 * [ ] 拖动文件触发器 * [ ] 发动机启动触发器 * [ ] 聚焦窗口触发 * [ ] 文件夹触发器 * [ ] 手势触发 * [ ] 组状态菜单触发器 * [ ] 空闲触发 * [ ] 登录触发器 * [ ] MIDI 触发器 * [ ] 安装音量触发器 * [ ] 周期性触发 * [ ] 电源状态改变触发 * [ ] 公共网络触发器 * [ ] 远程触发 * [ ] 睡眠触发 * [ ] 空间改变触发 * [ ] 子程序触发 * [ ] 一天中的时间触发 * [ ] USB设备密钥触发 * [ ] USB 设备触发 * [ ] 解锁触发器 * [ ] 唤醒触发 * [ ] 无线网络触发 # 帮助 *** * 本用户手册介绍了使用 Keyboard Maestro 编辑器的基础知识。 * 本教程将向您展示如何创建简单的宏。您可以通过选择“帮助”➤“教程”菜单来启动教程。快速入门介绍了 Keyboard Maestro 的组件以及它们如何协同工作，了解这些基础知识对于充分利用 Keyboard Maestro 非常重要。 * Wiki 包含有关 Keyboard Maestro 各个方面的大量信息。 * 论坛 \[] 是寻求宏帮助的好地方。 * Keyboard Maestro 中的每个操作都在操作右上角的 ⚙ 菜单中包含一个“帮助”选项。从“编辑”菜单中的任何“插入”菜单中进 行选择时按住 option 键将为您提供有关操作、功能或标记的帮助。 * 从新的触发器菜单中进行选择时按住选项键将为您提供有关触发器的帮助。 * 从新条件菜单中进行选择时按住选项键将为您提供有关条件的帮助。从新的收藏菜单中进行选择时按住选项键将 为您提供有关收藏的帮助。 最后但并非最不重要的一点是，您可以通过选择“帮助”➤“交互式帮助”菜单向 Keyboard Maestro 本身寻求帮助。 特别是，交互式帮助窗口可以帮助您： * 如果发生了您意想不到的事情 - Keyboard Maestro 可以向您展示它正在做什么。 * 如果宏没有执行任何操作 - Keyboard Maestro 可以帮助您了解原因。 # 常见问题 *** ## 如何创建新的宏？ 如果您还没有这样做，请通过选择帮助➤教程菜单来使用教程来引导您完成创建简单宏的过程。 要创建宏，请启动 Keyboard Maestro 并选择全局宏组，然后单击宏列表下的 + 按钮。为宏命名，添加一个或多个触发器以及 一个或多个操作。宏立即处于活动状态 - 您无需停止编辑、退出编辑器或执行其他任何操作。 生成宏操作的一个简单方法是打开录制并继续向 Keyboard Maestro 展示您想要执行的操作。然后关闭录制并查看操作 - 您可能 会想要删除或调整一些录制的操作以制作强大的宏，但这将使您快速开始创建宏。 ## 如何找到我最近使用或修改过的宏？ 您可以按名称、触发器、创建、修改或使用日期对宏进行排序。因此，如果您启动 Keyboard Maestro，请选择“所有宏”智能 组，然后选择“视图 ➤ 按修改日期对宏进行排序”菜单（或选择“视图 ➤ 按使用日期对宏进行排序”菜单），以对最近修改（或 使用）的宏进行排序。顶端。 您还可以单击宏编辑器窗格上方的 ◷ 按钮从最近修改的宏中进行选择，或使用 ⌘ 按钮从最近使用的宏中进行选择。 ## 如何取消正在运行的宏？ 您可以通过按住所有修饰符（Control、Option、Shift 和可选的 Command）并单击 Keyboard Maestro 状态菜单图标来取 消所有正在运行的宏。 您可以通过从“状态菜单”➤“取消”菜单中进行选择并选择宏来取消特定宏。这也是查看当前正在运行哪些宏（如果有）的有 用方法。 您还可以通过选择“状态菜单”➤“开始调试”菜单来查看和取消宏。 最后，您可以使用“取消所有宏”、“取消其他宏”、“取消此宏”或“仅取消此宏”操作。 无奈之下，您可以从状态菜单退出 Keyboard Maestro 引擎或安全启动 Mac 以重新启动它而不启动任何应用程序，然后您可以 在按住所有修改器的同时启动编辑器以退出所有正在运行的引擎。 ## 如何获取屏幕或窗口中的鼠标坐标？ 如果可能，您应该避免使用鼠标单击操作。它们往往非常脆弱，很容易被系统或应用程序的细微变化所破坏。而且它们还要求 屏幕处于预期状态，因此您通常需要在它们之前添加暂停操作，以确保它们单击的项目位于预期的位置。 也就是说，您可以通过选择“窗口”➤“鼠标显示”菜单来使用“鼠标显示”窗口，该菜单将让您查看相对于窗口或主屏幕的鼠标坐 标。单击锁定按钮几秒钟后锁定显示，然后将鼠标放在所需位置上。然后，您可以更改相对角，并单击剪贴板按钮复制坐标。 或者，您可以简单地记录点击。在 Keyboard Maestro 中打开录音，转到您想要的位置，等待几秒钟让屏幕稳定下来，这样单 击将相对于前窗口，然后单击。关闭录制，删除任何无关的录制动作，您就拥有了坐标。录制后，您可以立即调整窗口或屏 幕的相对角，录制的坐标将进行调整以匹配。 请记住，偏移量始终向右为正，向下为正，因此，如果您从窗口或屏幕的下边缘向上单击鼠标，或者从窗口或屏幕的右边 缘向左单击，则需要使用负值坐标。 ## 如何插入样式/彩色文本或图像？ 您可以使用“插入文本”操作通过粘贴插入样式文本。 您可以通过将图像复制到剪贴板然后使用“粘贴”操作（只需键入 Command-V 按键）将其粘贴来插入图像。 您可以从命名剪贴板或通过读取图像文件来获取图像。 以下是如何创建宏以在按下热键时插入图像。 * 使用“将剪贴板设置为图像”操作创建宏（请参阅如何创建新宏？部分）。 * 将图像粘贴到操作中，或让操作从文件或命名剪贴板读取图像。 * 然后使用“粘贴”操作粘贴图像。 为宏命名，并为其分配您想要的任何触发器。 现在，每当您触发刚刚创建的宏时，您的图像就会被粘贴进去。 ## 如何插入当前日期？ 您可以使用“插入文本”操作插入文本，它会处理令牌。有一些基本日期格式令牌（例如 %LongDate% 令牌），或者您可以 将 %ICUDateTime% 令牌与任何 ICU 日期格式一起使用 \[ ## 如何获得多个宏调色板（工具栏）？ Keyboard Maestro 中有三种调色板： * 有一个“全局宏调色板”，其中包括任何具有宏调色板触发器的活动宏。只要有任何带有宏调色板触发器的活动宏，它就会 出现。它会缩小到图标大小，直到您将鼠标悬停在其上，然后它会展开以显示带有宏调色板触发器的当前活动宏。您可以 使用特定的宏调色板操作来显示和隐藏它。 * 每个宏组都可以显示为调色板。宏组可以是所有应用程序的全局宏组，也可以 是特定于应用程序的任何子集的宏组。可以使用热键（或状态菜单选择或从全局宏面板）打开和关闭它，也可以通过单个 操作显示它。操作可以隐藏或显示宏组选项板。 * 当热键（或键入的字符串或设备键）发生冲突（即触发多个宏）时，会出 现“冲突选项板”，您可以从冲突的宏中进行选择。这是允许单个热键提供多种类似操作的简单方法。然后，您可以使用数 字键或鼠标来选择所需的热键，或者可以使用其他键来过滤调色板，直到只剩下一个宏。 因此，要拥有多个宏调色板，请为每个所需的调色板创建一个宏组，并将其配置为根据需要显示调色板。把你的宏放在那里。根据需要创建任意数量的此类内容。这样的宏组中的宏仅在显示调色板时才处于活动状态，因此如果您只是偶尔显示它，尤其是仅针对一个操作，那么它们可以具有非常简单的热键（例如普通字母）。 您可以通过在宏名称前加上两个字符和一个右括号（例如“01）” - 两个字符和一个右括号）来控制宏在宏选项板（或状态菜单）中的顺序。宏将根据代码进行排序，但代码将在显示在调色板（或状态菜单）中之前被剥离。 ## 如何使用多次击键触发器？ 您可以将相同的热键分配给多个宏，当您按下该热键时，Keyboard Maestro 将显示冲突宏的调色板，以便您选择所需的宏。您可以使用数字键从调色板中选择宏，或者通过键入第一个不同字符来过滤宏，直到只剩下一个。当您有各种相似或相关的任务时，这尤其有用。您还可以为宏组分配一个热键，该热键可以激活它以执行一个操作（带或不带调色板），并且包含的​​宏可以具有您想要的任何“第二个”热键。 但 Keyboard Maestro 不直接支持将两键热键分配给触发器。像 Option-F R 这样的多个击键触发器的问题是，如果您键入 Option-F A 该怎么办？从逻辑上讲，Option-F A 应该畅通无阻地进入系统，但 Option-F R 应该被完全吞没。但这是不可能的。 唯一的方法是吞下 Option-F 密钥，然后吞下第二个密钥，然后重新提交选项 F 和第二个密钥，除非它与 Option-F R 匹配。 然而，这充满了危险，并且在其他应用程序将事物放置在键盘事件队列（甚至是足够快的打字员）的情况下无法稳健地 工作。 例如，假设您快速键入 Option-F A B。Keyboard Maestro 会先吞下 Option F，然后吞下 A，然后将其重新提交到事件队列，从 而产生字符流 B、Option-F、A。无法避免这种竞争情况，因此 Keyboard Maestro 不支持任何此类机制。 如上所述，Keyboard Maestro 有多种方式可以使用 Option-F 作为热键，允许使用第二个键来选择宏。然而，在所有情况下， 很明显 Option-F 已被使用，并且不存在 Option-F 稍后可能会回来做其他事情的概念。 ## 如何配置应用程序切换器？ 应用程序切换器（以及所有切换器）由宏操作激活。 Keyboard Maestro 创建一个默认的“切换器组”宏组，其中包含多个宏， 每个宏都有一个热键触发器和一个可激活相应切换器的匹配操作。 因此，要配置应用程序切换器，请启动 Keyboard Maestro，选择切换器组，然后双击激活应用程序切换器宏。然后，您可以通 过配置应用程序切换器操作来配置各种应用程序切换器参数，例如样式和图标大小。您还可以配置用于激活切换器的热键，或禁用切换器。 ## 如何将我的安装备份/迁移/转移到另一台Mac？ 您的宏存储在本地 Mac 上的 Application Support 文件夹中。因此，请确保您对整个 Mac 有良好的备份，以确保您的宏安全（良 好的备份始终是一个好主意！）。 如果您要继续使用两台 Mac，则应使用宏同步而不是传输信息。事实上，您可以使用宏同步传输到新的 Mac（即使两台 Mac 不 会同时打开，只要您保留同步文件）。 要将所有信息传输到新 Mac，您可以将 \~/Library/Application Support/Keyboard Maestro 文件夹和可选的 \~/Library/Preferences/com.stairways.keyboardmaestro.\* 文件复制到新 Mac。您可以通过按住 Shift（或选项）键并从“转到”菜单 中选择“库”来访问 Finder 中的 \~/Library。 传输文件夹时，请确保 Keyboard Maestro 和 Keyboard Maestro Engine 未在源或目标 Mac 上运行。并确保生成的文件和文件 夹具有正确的所有权和权限。 如果您复制 com.stairways.keyboardmaestro.\* 文件，新 Mac 将具有相同的 MacUUID 令牌，并且出于同步目的被视为同一台 Mac，因此如果您打算继续使用旧 Mac，则不应执行此操作。 或者，要仅传输宏，您可以打开宏同步并将宏同步文件保存在任何位置。将其传输到新的 Mac，照常安装 Keyboard Maestro，然后打开宏同步并选择传输的文件来替换宏。然后关闭宏同步。这将仅传输宏，而不传输任何设置、变量或剪贴板等。 # 界面介绍 *** ## 编辑器窗口 要编辑宏，请启动 Keyboard Maestro 应用程序。它将显示一个或多个编辑器窗口。如果关闭最后一个编辑器窗口，Keyboard Maestro 应用程序将退出，但 Keyboard Maestro 引擎将继续运行以执行宏。通常，您仅在想要更改宏时才启动 Keyboard Maestro 编辑器应用程序，并且仅让 Keyboard Maestro 引擎正常运行。 您可以通过选择“文件”➤“新建编辑器窗口”菜单来创建新的编辑器窗口。 ### 窗口元素 ![主界面](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403141547606.png) #### ➊ 宏组列（左侧） * #### 您帐户中的所有智能组（顶部）和宏组的列表 * 智能组是保存的宏搜索。 * [宏组的属性](/jie-mian-jie-shao/hong-zu-de-shu-xing-pei-zhi)在详情栏配置 #### ➋ 宏列（中间） * 列出所选组中的所有宏 * 宏是描述您希望 Keyboard Maestro 执⾏的操作的主要⽅式。 * 您可以使⽤搜索字段（右上⾓）过 滤列表以查找特定宏。 #### ➌ 详情列（右侧） * 显⽰或编辑所选宏、宏组或智能组的详细信息。 * 您可以在此处输⼊所选宏的实际详细信息。 * 布局根据选择的类型⽽变化。对于宏，它包括名称、启⽤状态、触发器和操作。对于宏组，它包括名称和启⽤ 状态，以及有关何时以及如何激活或显⽰的详细信息。对于智能组，它包括名称和要显⽰的宏。 #### ➍ 分隔线 * 您可以使⽤分隔线调整列的⼤⼩，然后双击它们以⾃动调整列的⼤⼩。 #### ➎ 顶部工具栏 * 顶部的⼯具栏显⽰适⽤于所有宏的⼯具。详情请参阅[顶部工具栏](broken://pages/wqSpclQc8tSORnWkW520)。 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142010718.png) * 具体含义参见下表： | | | | -------- | --------- | | Share | 分享 | | Used | 选择最近用过的宏 | | < | 选择上一个编辑的宏 | | > | 选择下一个编辑的宏 | | Modified | 选择最近修改过的宏 | | Run | 运行选中的宏 | #### ➏ 底部工具栏 * 底部的⼯具栏包括每列下⽅适⽤于每列的⼯具（即组、宏或特定宏）。 #### ➐ 搜索栏 #### ➑ 警告提示信息 新安装的用户可能在此处有黄色感叹号，通常为录屏权限请求和访问权限请求。 ![要求权限](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403141553652.png) ![要求权限](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403141554729.png) 可能出现的Bug情形是：在设置中已经给了权限，但仍然有黄色感叹号无法消除。这时只需要将Keyboard Maestro退出后重新打开，黄色感叹号就会消失。 ## 菜单栏 菜单栏主要包括以下几部分：File/Edit/View/Actions/Window/Help。所有菜单的完整列表，请参见[Menu详解](/menu-xiang-jie)。这里简单介绍一下菜单栏中的主要功能。 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142058624.png) 1. File（文件）
File
| | 含义 | 解释 | | ----------------------- | ------- | -------------------------------------------------------------------------------------------------- | | New Smart Group | 新建智能宏组 | 可以设定筛选规则，将满足条件的宏保存在该宏组中，具体规则可参考[**搜索限定词**](https://wiki.keyboardmaestro.com/manual/Search_Strings) | | New Macro Group | 新建宏组 | | | New Macro | 新建宏 | | | New Macro Wizard | 以向导新建宏 | 可以快速先创建出一个新宏，用户可以在之后再对宏进行详细配置 | | New Editor Window | 新建编辑器窗口 | | | Run Macro | 运行宏 | 运行当前选定的宏 | | Revert Macros | 恢复宏 | 按时间恢复往期版本 | | Start Syncing Macros... | 开始同步宏 | | | Reveal Macro Sync File | 显示同步文件 | | | Stop Syncing Macros | 停止同步宏 | | | Quit Engine | 退出工具 | | 2. Edit（编辑） Edit | | 含义 | 解释 | | --------------------- | ----------- | -------------------------------------------------------------------------------------------------------- | | Undo XXX | 撤销XX | | | Redo | 重做 | | | Make Alias | 创建别名 | 为选定的宏创建别名，该命令会创建一个仅执行选定宏的新宏 | | Insert Action | 插入动作 | | | Insert Function | 插入函数 | | | Insert Token | 插入代币 | 代表占位符，用于在运行时在文本中替换的信息，类似于变量，参见[Tokens](https://wiki.keyboardmaestro.com/Tokens)，格式为%Tokens% | | Insert Variable | 插入变量 | 参见[Variables](https://wiki.keyboardmaestro.com/manual/Variables?s%5B%5D=variable)。格式为%Variable%VarName%。 | | Insert ICU Date Field | 插入 ICU 日期字段 | ICU(International Components for Unicode)提供了强大的日期和时间库，可以正确有效地处理处理日期和时间的复杂性 | | Automatic Completions | 自动补全 | 可让实现自动文本补全。关闭时，仍然可以通过按 F5 来补全变量、代币和函数。 | 3. View（视图）
含义解释
Sort Macros by
Select Groups Column
Select Macros Column
Go to Macro
Go to Last Aborted Action
Reveal Parent Group
Hide Disabled Macro Groups
Evaluate Condition Results
Enable Macro
Stop Editing Macros
Rename...
Record Without Delay
4. Actions（动作） | | 含义 | 解释 | | ------------------------ | -- | -- | | Show Actions | | | | Try Action | | | | Disable Action | | | | Rename... | | | | •Set Color | | | | Set Note... | | | | Process Text Normally | | | | Process Text Tokens Only | | | | Process Nothing | | | | Send To | | | | Paste Above | | | | Paste Below | | | | Paste Replacing | | | | Move Action Up | | | | Move Action Down | | | | Add to Favorites | | | | Engroup | | | | Degroup | | | | Set Action Timeout... | | | | Timeout Aborts Macro | | | | Notify on Timeout | | | | Failure Aborts Macro | | | | Notify on Failure | | | | Expand Action | | | | Collapse Action | | | | Parent Action | | | | Enter Action | | | 5. Window（窗口） | | 含义 | 解释 | | ----------------------- | -- | -- | | Minimize | | | | 全部最小化 | | | | Zoom | | | | Keyboard Maestro Editor | | | | Macro Library | | | | Icon Chooser | | | | Macro Inspector | | | | Mouse Display | | | | Value Inspector | | | | Bring All to Front | | | 6. Help（帮助） | | 含义 | 解释 | | ------------------------------------- | --------------------- | -- | | Interactive Help | 交互式帮助 | | | Keyboard Maestro User Manual | KM用户手册 | | | Keyboard Maestro Quick Start | KM快速开始 | | | Welcome to Keyboard Maestro | 欢迎引导页 | | | Keyboard Maestro Website | KM网址 | | | Keyboard Maestro Wiki | KM维基 | | | Keyboard Maestro Forum | KM论坛 | | | Stairways Software Website | Stairways Software 官网 | | | Tutorial | 一个简易的引导教程 | | | Practice Gestures | | | | Show Active Macro Groups | 显示活跃的宏组 | | | ICU Date Format Reference | ICU日期格式参考 | | | ICU Regular Expression Reference | ICU正则表达式参考 | | | Regular Expression Unicode Properties | 正则表达式 Unicode 属性 | | | MacSparky Field Guide | 一个教程网址 | | | Elgato Stream Deck Details | | | | Third Party Licenses | | | | Open Logs Folder | | | | Open Preferences Folder | | | | Report Bugs or Feature Requests | | | | Service and Support | | | # 宏组的属性配置 这里，我们以新创建的「Test」宏组为例，在创建好宏组之后，可以看到中间的宏列是空的，表示宏组内没有宏，右侧的详情列中我们可以进行以下配置： ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403171054574.png) 1. 修改宏组名称 2. Enable Macro Group——配置是否启用宏组 3. Available in all applications——配置在哪些应用程序中可用 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403171129268.png) 4. Available in all windows——配置在哪些窗口中可用 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403171127313.png) 5. Always activated——配置启用时机 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403171128932.png) 6. Do not display in menu bar——配置是否在菜单栏显示 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403171128480.png) # 触发器 Trigger # 快捷键 Hot Key Trigger 快捷键触发器可能是所有触发器中最常见和最基本的触发器。当您按下配置的键盘按键时，系统会吞下击键，并且 Keyboard Maestro 会执行宏。 ![快捷键触发界面](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403291048482.png) ### 哪些键可以用作快捷键 可以是字母、数字、符号或功能键，通常与一个或多个修饰键（Shift、Control、Option 和/或 Command）组合使用。几乎任何键都可以作为触发器，请记住，数字键盘与主键盘上的数字键算作不同的键。 您可以在快捷键框中键入所需的键或组合键，或从右侧的弹出菜单（如下图所示）中选择预定义的键（按住任何所需的修饰符）。 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403291045292.png) 快捷键可以包括零个或多个普通修饰键（Command、Option、Shift、Control）以及另一个键（例如字母、数字、功能键或其他键）。 ### 何时触发
| 触发情形 | 释义 | | ---------------------- | ------------- | | is pressed | 按下按键 | | is long pressed | 长按按键，松开触发 | | is down | 按住按键 | | is released | 释放按键 | | ------ | ------ | | is tapped | 轻敲按键（快速按下并释放） | | is tapped once | 轻敲1次 | | is tapped only once | 只轻敲2次 | | is tapped twice | 轻敲2次 | | is tapped only twice | 只轻敲2次 | | is tapped 3 times | 轻敲3次 | | is tapped only 3 times | 只轻敲3次 | | is tapped 4 times | 轻敲4次 | | is tapped only 4 times | 只轻敲4次 | ### **is pressed** 、**is long pressed**、**is down**、**is tapped** **的区别**: **is pressed**: `Keyboard Maestro` 监测特定键的按下事件。
由上图可以看出，在长按`F4`的情况下，按下`F4`的一瞬间，动作就被触发。 **is long pressed**: 长按按键，在松开时触发。
由上图可以看出，在长按`F4`的情况下，松开时，触发动作；而轻敲一下，不会触发动作。 **is down**：按住按键，可以重复触发。
**is tapped**意思是 「快速按下并释放」。
由上图可以看出，在长按`F4`的情况下，按的时间超出了一定时间，不会触发动作；只有在短时间内轻敲按键（快速按下并释放），才会在完成动作时（也就是松开按键时）触发动作。 *** ### **is tapped twice 与 is tapped only twice 的区别：** 配置为**is tapped twice**的宏会在两次轻敲之后立即触发。
但当触发器配置为**is tapped only twice**时，由于`Keyboard Maestro` 无法预见未来，因此要确定这是明确的第二次点击，宏在释放按键时并不会触发，必须等待一小段时间才能看到没有按下第三次。因此，当使用**is tapped only twice**选项时，在执行宏之前会有短暂的延迟。
### 注意 ⚠️ 请记住，无论您是否在按下、按下、释放或点击快捷键时触发宏，该键都会被系统吞没，无法用于其正常用途。如果您想在不被系统吞掉按键的情况下触发宏，可以使用 `USB_Device_Key` 触发器。 ⚠️ 请注意，`Keyboard Maestro` 本身键入的按键是否会触发快捷键（从而被吞掉并执行宏）或不会触发快捷键（从而进入应用程序）尚未定义 - 可能会发生哪种行为以及哪种行为发生的情况会因许多不可预测的因素而有所不同，但键盘大师会尽力确保不会因响应自己的输入而触发宏。如果您希望根据击键触发宏，可以使用“通过快捷键触发宏”操作。 尽管您可以使用 USB\_Device\_Key 触发器来检测修饰键按下以及其他按钮按下（例如鼠标按钮或非标准键盘（如 XK-24）上的按键），但单独的修饰符（例如仅 Control）不能用作快捷键。 ### 如何知道按下了哪个键？ 您可以使用 `%TriggerValue%` Text Token来确定键入的快捷键，因此您可以拥有一个具有多个快捷键的宏，这些快捷键的行为根据按下的键而有所不同。 ### 如何设计并记住如此多的快捷键？ 快捷键的缺点是您需要记住复杂的快捷键组合。这可以通过选择一致的快捷键来缓解（例如 Control-Letter 表示插入文本，Control-Option-Letter 表示启动应用程序）。您还可以使用 KeyCue 、CheatSheet 等工具来显示命令键和宏快捷键。 为了进一步帮助解决此问题，如果使用同一快捷键执行多个宏，冲突的宏将显示在冲突调色板中，允许您选择所需的宏。您可以使用数字键从调色板中选择宏，或者通过键入第一个不同字符来过滤宏，直到只剩下一个。您可以使用此功能来允许单个快捷键执行多个可能的操作之一。具体请参考 浮窗Palettes。 ### 关于Fn 键 Fn 键不是修饰键，不能用作修饰键。它保留了切换功能键角色的正常用途，因此它可能是快捷键的一部分，但前提是功能键通常具有其硬件（例如亮度增加）角色，然后 Fn 键使它们成为合适的功能键用于快捷键触发器。硬件键（​​如亮度提高）不能用作快捷键，但功能键可以。 ### 快捷键与其他应用程序的快捷键冲突时，会发生什么 快捷键将覆盖应用程序菜单命令键或应用程序中通常使用的任何其他键，但如果任何其他应用程序注册相同的快捷键，则您的宏和其他应用程序的操作都会发生。 # 全局宏浮窗触发器 Global Macro Palette Trigger **全局宏浮窗触发器允许您将宏添加到一个浮动浮窗中，因此您可以通过点击浮窗中的宏名称来触发它。** 示例： * 假设您创建了一个宏用于打开您的日程表应用，您可以将这个宏添加到全局宏浮窗中。这样，无论您在电脑上做什么，只需要点击这个浮动浮窗上的宏名称，就能快速打开日程表应用。 * 如果您有一个宏是用来快速发送电子邮件给特定的联系人，将这个宏添加到全局宏浮窗后，只需一次点击，就可以启动您的邮件客户端并创建一封新邮件，收件人已经填好。 * ``` ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202404142255075.gif) ``` 使用场景： * 当您在进行一个项目工作，并且需要频繁地打开不同的应用或文件时，通过全局宏浮窗，您可以快速切换所需的应用或文档，提高工作效率。 * 如果您是一个视频编辑者，可能需要在不同的编辑软件之间切换，通过将这些切换操作设置成宏，并添加到全局宏浮窗中，可以使您的编辑工作流程更加顺畅和高效。 **Keyboard Maestro只有在有活动宏时才会显示浮窗，所以如果您的宏被限制在特定的应用程序中使用，那么全局宏浮窗只会在这些应用程序中出现。这对于那些不常用的宏特别有用，您可能会忘记它们的热键。** > **解释：**
> > 要显示这个浮窗，我们必须先创建一个含有全局宏浮窗触发器的宏，并确保该宏处于激活状态。然后，我们可以创建一个宏来控制全局浮窗的显示或隐藏。例如，当按下设定的快捷键时，浮窗会显示；如果它已经是显示状态，再次按下快捷键会隐藏它。通过这种方式，我们可以方便地访问和调用常用宏，无需为它们设置快捷键。 > > 示例： * 假如您为Photoshop创建了一系列宏来快速执行复杂的编辑命令，但只在Photoshop运行时需要这些宏。将这些宏添加到全局宏浮窗，并设置仅在Photoshop活动时显示，这样可以确保宏浮窗只在您需要时出现，避免了桌面上的不必要干扰。 * 设想您有一个宏用于启动一系列的开发环境工具，但这个宏只在您打开特定的代码编辑器时才有用。将它设置为只在该代码编辑器运行时通过全局宏浮窗可用，可以帮助您避免在不需要时看到这个宏，同时在需要时轻松访问。 使用场景： * 在进行多应用协作时，比如设计师在使用Adobe套件软件进行工作，不同的宏设置为只在对应的软件中显示，可以有效地减少寻找特定操作的时间，提升工作效率。 * 对于开发人员，可能需要在不同的开发环境之间切换，为每个环境设置特定的宏，并让它们只在对应的环境中通过全局宏浮窗显示，这样可以快速执行环境切换、编译代码等操作，简化开发流程。 **您可以通过添加两个字符和一个闭括号（例如“01)我的宏”）来控制宏的排序顺序。这个前缀在宏浮窗中显示时会被移除，但会被用来控制显示宏的顺序。** 示例： * 如果您有多个宏用于处理电子邮件任务，并希望它们按特定顺序出现在宏浮窗中，您可以给它们分别命名为“01)检查新邮件”、“02)标记为已读”和“03)回复邮件”。这样，无论它们的创建顺序如何，它们总是以这个顺序显示在浮窗中。 * 设想您正在准备一个演示文稿，有一系列宏帮助您快速插入不同类型的幻灯片。您可以将它们命名为“01)添加标题幻灯片”、“02)添加内容幻灯片”、“03)添加总结幻灯片”，以确保这些宏总是以您设计的顺序出现在宏浮窗中。 **您可以通过按住 `Option` 键并在宏浮窗中单击它来编辑宏。** # 状态菜单触发器 Status Menu Trigger # 输入字符串触发器 Typed String Trigger 输入字符串触发器主要包括以下几个部分：
### 1. 可输入的内容 输入字符串触发器允许您使用更详细（因此更具描述性）的按键序列来触发宏。触发器可以包含非 ASCII 字符，但您应该验证删除在这些情况下是否正常工作。触发器可以包含修饰符 (⌃⌥⇧⌘) 字符 (v11.0+)，您可以通过点击相应的修饰符来输入这些字符。 ### 2. 选择大小写是否敏感 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403280928767.png) * 大小写必须匹配 > **解释：** 这句话写的很难读，对于`=em=`来说，只能输入`=em=`才能触发，`=Em=`、`=eM=`、`=EM=`都无法触发。 * 大小写都可以 * 大小写影响动作 * 您可以使用键入的字符串的大小写并影响插入文本操作。这意味着如果您以全大写形式键入字符串，则生成的“插入文本”也将是大写的。如果您仅以大写形式键入第一个字母，则仅第一个结果插入文本将为大写。 * > **解释：** 这句话写的很难读，举个例子就容易理解了：
> 其中第一个输入的是`#em`， > > 第二个输入的是`#Em`， > > 第三个输入的是`#EM`。 * 使用正则表达式来匹配触发器 * 您可以使用正则表达式来匹配触发器。触发器与输入序列的末尾进行匹配，因此正则表达式的末尾有一个隐式 z。请注意，尝试将末尾的分词符与 [\b 或某种正或负的先行断言匹配](https://www.runoob.com/regexp/regexp-metachar-b.html)是没有用的，因为输入序列始终以当前字符结束。例如，即使您计划输入的下一个字符是“o”，“ellb”也会匹配“hell”。 * 如果多个输入字符串触发器从末尾开始匹配（例如“hello”和“llo”），则将使用最长的一个。如果存在多个具有相同长度的匹配项（如果使用大小写或变音符号选项，则可能会发生这种情况），将显示冲突浮窗，提供匹配宏的选择。在这种情况下，如果所有键入的字符串触发器都启用了“执行前模拟 N 次删除”选项，则将立即模拟删除，然后显示冲突浮窗；否则将不会模拟删除。 * 具体可参考[RegEX](https://wiki.keyboardmaestro.com/Regular_Expressions?s\[]=regular\&s\[]=expression)。 ### 3. 后续接的内容种类 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403281041435.png) * 位于任何字符之后可触发 * 位于分词符之后可触发 * 您可以将键入的字符串触发器限制为仅在断字后起作用（这意味着任何非字母数字字符，或取消上述序列的任何情况）。请注意，这意味着仅在您键入分词符、然后键入的字符串后才会发生匹配， - Keyboard Maestro 无法预知你未来会键入什么，所以它不能仅在你计划接下来键入一个词边界时才匹配字符串。这意味着，触发条件的检测只能在你实际完成键入动作之后进行，而不是基于你未来的键入计划。 * > **解释：** 这一段也写得很难懂，举个例子吧，具要见下图： > > 第一行：前方无字符，可以触发 > > 第二行：前方为其他字符，不能触发 > > 第三行：前方为空格，可以触发 > > 所以，对于不会单独出现在字首的字符触发组合，可以用于触发器，像`th`这样的高频出现在词首的，应当避免当触发器，`em`也不适用，因为存在`email`、`empty`等以`em`开头的单词。
简而言之，这个设置确保了只有在符合特定前置条件（即，词边界之后立即跟随触发字符串）的情况下，触发器才会被激活，从而提高了触发的准确性和适用性。 ### 4. 是否适用变音字母
> Diacritical matter 是指 é、è、ê、ë 这类特殊符号，平时咱们用不到，可以不用考虑。 ### 5. 模拟删除 由于按键首先进入当前应用程序，因此通常会在执行宏之前删除按键，尽管禁用此功能后您可以在很大程度上忽略按键的应用程序中使用它。 > **解释：** 在勾选的情况下，在输入`=em=`时，会模拟删除4个字符，以将`=em=`删除 ### 6.`输入字符串触发器`的使用注意事项 #### 该触发器的适用场景——如何避免宏误触发 * ⚠️ 通常不应使在非文本输入上下文中使用模拟删除的`输入字符串触发器`，因为模拟的删除击键可能具有破坏性。 * > **解释：** 最好在文本输入的位置使用该触发器，这样可以保证`Delete`删除键只对刚刚输入的文本进行删除，如果在文件操作时使用，则可能会造成文件删除的破坏性后果。 * 如果您要立即更改焦点（例如，提示用户输入，或者通过切换窗口或应用程序），那么您可能需要在宏开始时短暂暂停，以便在焦点发生变化之前保证模拟删除执行完毕。 * > **解释：** 如果该`触发器`对应的`动作`需要变换窗口、焦点，则最好在第一个`动作`处设置一定的`Pause时间`，这样可以给`模拟删除`执行完毕留出足够的时间，如果不如此设置，可能导致： > > 1. 无法将之前的输入文本删除， > 2. 切换焦点之后再进行删除操作，可能会不正确地删除切换焦点后对应位置处的内容。 > > 暂停的时间可以根据自己电脑的性能来合理设置。
* 为了避免宏意外触发，最好在字符串中包含一致的前缀和/或后缀。例如，要插入您的电子邮件地址，不要仅使用“em”（如果您输入“them”，则会触发），而应使用“=em=”之类的内容，这样您就不会意外输入。 #### 如何在输入过程中断触发器的触发 * 即使您使用删除键进行更正，键盘大师也会接受触发器（例如，在上面的情况下，如果您输入“=en«delete»m=”，触发器仍然会触发。如果您需要输入触发器没有宏触发的文本，输入并删除中间的 Shift-Space，例如“=e«Shift-Space»«delete»m=”。 * > **解释：** 当输入一半时，有输入错误的字符，即使通过`Delete`进行了修改，仍会正常地触发宏，即会输出`them`。 如果不想触发该宏，则可以在输入一部分的情况下，按`Shift-Space`增加一个空格，再按`Delete`删除该空格，这样就不会触发该宏，即会输出`=em=`。 * 如上所述，输入 Shift-Space 将取消序列，任何控制键或命令键（例如 Command-.）、任何宏执行、切换应用程序、单击鼠标或超过几秒钟不输入都会取消序列。点击修饰符不会取消序列，但会被视为触发字符串的一部分 (v11.0+)。 * > **解释：** 可以通过上述示例的操作，来中断宏序列。 ### 如何查看键入的确切文本 您可以使用`%TriggerValue%` 文本Token来确定键入的确切文本。 ### 不能查看`键入的确切文本`的情形 请注意，系统不允许 Keyboard Maestro Engine 查看在其自己的窗口中键入的键（例如`用户输入提示`或`自定义 HTML 提示`），因此键入的字符串触发器将无法在 Keyboard Maestro Engine 窗口中工作。另请注意，类型化字符串触发器在 Keyboard Maestro 编辑器本身中无法正常工作，因为对宏的任何更改都会导致宏被保存并重置类型化字符串触发器缓冲区。因此，您需要使用不同的触发器在 Keyboard Maestro 引擎或编辑器中工作。 系统也将（正确地）不允许 Keyboard Maestro 查看在密码字段中键入的键，因此如果您在大多数密码字段中键入字符串触发器，则不会触发它们。您可以使用“通过键入插入文本”在密码字段中输入内容（尽管这是一个严重的安全问题，并且在某些情况下它无法正常工作），但在密码字段内无法使用“键入字符串”触发器。 # 外观改变触发器 Appearance Changed Trigger # 应用触发 Application Trigger # 音频输出设备更改触发 Audio Output Device Changed Trigger # 剪贴板更改触发器 Clipboard Changed Trigger # 剪贴板过滤器触发器 Clipboard Filter Trigger # 定时触发器 Cron Trigger # 显示布局更改触发器 Display Layout Changed Trigger # 拖动文件触发器 Dragged File Trigger # 发动机启动触发器 Engine Launch Trigger # 聚焦窗口触发 Focused Window Trigger # 文件夹触发器 Folder Trigger # 手势触发 Gesture Trigger # 组状态菜单触发器 Group Status Menu Trigger # 空闲触发 Idle Trigger # 登录触发器 Login Trigger # MIDI 触发器 MIDI Trigger # 安装音量触发器 Mounted Volume Trigger # 周期性触发 Periodic Trigger # 电源状态改变触发 Power Status Changed Trigger # 公共网络触发器 Public Web Trigger # 远程触发 Remote Trigger # 睡眠触发 Sleep Trigger # 空间改变触发 Space Changed Trigger # 子程序触发 Subroutine Trigger # 一天中的时间触发 Time of Day Trigger # USB 设备密钥触发 USB Device Key Trigger # USB 设备触发 USB Device Trigger # 解锁触发器 Unlock Trigger # 唤醒触发 Wake Trigger # 无线网络触发 Wireless Network Trigger # 动作 Action # 应用程序控制 Application Control | Application Control | 应用程序控制 | | ----------------------------------------- | ------------- | | | | | Activate Last Application | 激活最后一个应用程序 | | Activate Next Application | 激活下一个应用程序 | | Activate a Specific Application | 激活特定应用程序 | | Bring Application Windows to Front | 将应用程序窗口置于前面 | | Quit All Applications | 退出所有应用程序 | | Quit Other Applications | 退出其他应用程序 | | Quit a Specific Application | 退出特定应用程序 | | Hide All Applications | 隐藏所有应用程序 | | Hide Other Applications | 隐藏其他应用程序 | | Hide Front Application | 隐藏前面的应用程序 | | Hide a Specific Application | 隐藏特定应用程序 | | Show All Applications | 显示所有应用程序 | | Show a Specific Application | 显示具体应用 | | Apply Modifiers to a Specific Application | 将修改器应用于特定应用程序 | # 剪贴板 Clipboard | Clipboard | 剪贴板 | | ---------------------------------- | -------------- | | | | | Cut | 剪切 | | | | | Copy | 复制 | | Paste | 粘贴 | | | | | Set Clipboard to Text | 将剪贴板设置为文本 | | Set Clipboard to Past Clipboard | 将剪贴板设置为过去的剪贴板 | | Set Clipboard to Image | 将剪贴板设置为图像 | | Set Clipboard to File Reference | 将剪贴板设置为文件引用 | | Set Clipboard to Variable | 将剪贴板设置为变量 | | Remove Clipboard Flavors | 删除剪贴板风味 | | Delete Current System Clipboard | 删除当前系统剪贴板 | | Delete Past Clipboard | 删除过去的剪贴板 | | Cut to Named Clipboard | 剪切到指定剪贴板 | | Copy to Named Clipboard | 复制到指定剪贴板 | | Paste from Named Clipboard | 从命名剪贴板粘贴 | | Copy Clipboard to Clipboard | 将剪贴板复制到剪贴板 | | Paste by Name | 按名称粘贴 | | Apply Style to Clipboard | 将样式应用到剪贴板 | | Apply a BBEdit Text Factory | 应用 BBEdit 文本工厂 | | Filter | 过滤器 | | | | | Search and Replace | 搜索和替换 | | Search using Regular Expression | 使用正则表达式搜索 | | Substring of Variable or Clipboard | 变量或剪贴板的子字符串 | | Display Clipboard | 显示剪贴板 | # 流程控制 Control Flow | Control Flow | 流程控制 | | --------------------------------- | ------------------ | | | | | Pause | 暂停 | | | | | Pause Until | 暂停直到 | | | | | Pause Until Change | 暂停直到改变 | | Group | 团体 | | Until | 直到 | | | | | While | 尽管 | | | | | Repeat | 重复 | | If Then Else | 如果那么否则 | | | | | Switch/Case | 开关/外壳 | | For Each | 对于每个 | | | | | For Each Path in Finder Selection | 对于 Finder 选择中的每个路径 | | | | | For Each Path in Folder | 对于文件夹中的每个路径 | | | | | Try/Catch | 试着抓 | | Throw | 扔 | | | | | Execute a Macro | 执行宏 | | | | | Execute a Subroutine | 执行子程序 | | Return Result | 返回结果 | | | | | Trigger Macros by Hot Key | 通过热键触发宏 | | Assert | 断言 | | | | | Cancel All Macros | 取消所有宏 | | Cancel All Other Macros | 取消所有其他宏 | | | | | Cancel This Macro | 取消该宏 | | Cancel Just This Macro | 仅取消此宏 | # 调试器 Debugger | Debugger | 调试器 | | ------------------------------------ | ---------- | | | | | Debugger Start | 调试器启动 | | Debugger Finish | 调试器完成 | | Debugger Toggle | 调试器切换 | | Debugger New Macros Paused | 调试器新宏已暂停 | | Debugger New Macros Run | 调试器新宏运行 | | Debugger Breakpoint This Macro | 调试器断点此宏 | | Debugger Breakpoint All Other Macros | 调试器断点所有其他宏 | | Debugger Breakpoint All Macros | 调试器断点所有宏 | | Debugger Step Over Other Macros | 调试器跳过其他宏 | | Debugger Step Into Other Macros | 调试器单步执行其他宏 | | Debugger Step Out Other Macros | 调试器步出其他宏 | | Debugger Continue This Macro | 调试器继续此宏 | | Debugger Continue All Macros | 调试器继续所有宏 | # 执行 Execute | Execute | 执行 | | ------------------------------------- | ------------------------------ | | | | | Execute an AppleScript | 执行 AppleScript | | Execute Shortcut | 执行快捷方式 | | | | | Execute (or Edit) Shortcut | 执行（或编辑）快捷方式 | | Edit Shortcut | 编辑快捷方式 | | | | | Execute a Shell Script | 执行 Shell 脚本 | | Execute a Swift Script | 执行 Swift 脚本 | | a Execute a JavaScript For Automation | a 执行 JavaScript 以实现自动化 | | Execute a JavaScript in Front Browser | 在前端浏览器中执行 JavaScript | | Execute a JavaScript in Safari | 在 Safari 中执行 JavaScript | | Execute a JavaScript in Google Chrome | 在 Google Chrome 中执行 JavaScript | | Execute a JavaScript in Custom Prompt | 在自定义提示符中执行 JavaScript | | Execute an Automator Workflow | 执行 Automator 工作流程 | | Execute a Macro | 执行宏 | | Execute a Subroutine | 执行子程序 | | Return Result | 返回结果 | | | | | Trigger Macros by Hot Key | 通过热键触发宏 | # 文件 File | File | 文件 | | ---------------------------------- | ------------------ | | | | | Reveal a File | 显示文件 | | | | | Create Unique File | 创建独特的文件 | | Move a File | 移动文件 | | Rename a File | 重命名文件 | | | | | Move or Rename a File | 移动或重命名文件 | | | | | Copy a File | 复制文件 | | Duplicate a File | 复制文件 | | Trash a File | 删除文件 | | | | | Delete a File | 删除文件 | | | | | Open a File, Folder or Application | 打开文件、文件夹或应用程序 | | Read a File | 读取文件 | | | | | Write to a File | 写入文件 | | | | | Append Text to a File | 将文本附加到文件 | | New Folder | 新建文件夹 | | | | | Get File Attribute | 获取文件属性 | | | | | Set File Attribute | 设置文件属性 | | | | | Set File Icon | 设置文件图标 | | | | | Split Path | 分割路径 | | For Each Path in Finder Selection | 对于 Finder 选择中的每个路径 | | | | | For Each Path in Folder | 对于文件夹中的每个路径 | | | | | Prompt for File | 提示输入文件 | # 前端浏览器控制 Front Browser Control | Front Browser Control | 前端浏览器控制 | | ---------------------------------------- | -------------------- | | | | | New Front Browser Window | 新的前端浏览器窗口 | | | | | New Front Browser Tab | 新的前端浏览器选项卡 | | | | | Next Front Browser Tab | 下一个前端浏览器选项卡 | | | | | Previous Front Browser Tab | 上一个前端浏览器选项卡 | | | | | Select Front Browser Tab | 选择前端浏览器选项卡 | | | | | Wait For Front Browser to Finish Loading | 等待前端浏览器完成加载 | | Set Front Browser URL | 设置前端浏览器 URL | | | | | Set Front Browser Title | 设置前端浏览器标题 | | | | | Click Front Browser Link | 单击前端浏览器链接 | | | | | Focus Front Browser Field | 聚焦前端浏览器字段 | | | | | Select Front Browser Field | 选择前端浏览器字段 | | | | | Set Variable to Front Browser Field | 将变量设置为前端浏览器字段 | | | | | Set Front Browser Field to Text | 将前端浏览器字段设置为文本 | | | | | Set Front Browser Checkbox | 设置前端浏览器复选框 | | | | | Set Front Browser Radio Button | 设置前端浏览器单选按钮 | | | | | Submit Front Browser Form | 提交前端浏览器表单 | | | | | Reset Front Browser Form | 重置前端浏览器表单 | | | | | Execute a JavaScript in Front Browser | 在前端浏览器中执行 JavaScript | # 谷歌浏览器控制 Google Chrome Control | Google Chrome Control | 谷歌浏览器控制 | | ---------------------------------------- | ------------------------------ | | | | | New Google Chrome Window | 新的 Google Chrome 窗口 | | New Google Chrome Tab | 新的 Google Chrome 标签 | | Next Google Chrome Tab | 下一个 Google Chrome 标签 | | Previous Google Chrome Tab | 上一个 Google Chrome 标签 | | Select Google Chrome Tab | 选择 Google Chrome 标签 | | Wait For Google Chrome to Finish Loading | 等待 Google Chrome 完成加载 | | Set Google Chrome URL | 设置谷歌浏览器网址 | | Set Google Chrome Title | 设置 Google Chrome 标题 | | Click Google Chrome Link | 单击 Google Chrome 链接 | | Focus Google Chrome Field | 聚焦谷歌Chrome领域 | | Select Google Chrome Field | 选择 Google Chrome 字段 | | Set Variable to Google Chrome Field | 将变量设置为 Google Chrome 字段 | | Set Google Chrome Field to Text | 将 Google Chrome 字段设置为文本 | | Set Google Chrome Checkbox | 设置 Google Chrome 复选框 | | Set Google Chrome Radio Button | 设置 Google Chrome 单选按钮 | | Submit Google Chrome Form | 提交 Google Chrome 表单 | | Reset Google Chrome Form | 重置 Google Chrome 表单 | | Execute a JavaScript in Google Chrome | 在 Google Chrome 中执行 JavaScript | # 图像 Image | Image | 图像 | | ---------------------- | --------- | | | | | Set Clipboard to Image | 将剪贴板设置为图像 | | Set Desktop Image | 设置桌面图像 | | Screen Capture | 屏幕截图 | | Find Image on Screen | 在屏幕上查找图像 | | OCR Image | OCR图像 | | OCR Screen | OCR屏幕 | | Read a File | 读取文件 | | Write to a File | 写入文件 | | Create New Image | 创建新图像 | | Flip Image | 翻转图像 | | Rotate Image | 旋转图像 | | Resize Image | 调整图像大小 | | Resize Image to Fit | 调整图像大小以适合 | | Resize Canvas | 调整画布大小 | | | | | Add or Remove Margins | 添加或删除边距 | | Crop Image | 裁剪图像 | | Set Image DPI | 设置图像 DPI | | Composite onto Image | 合成到图像上 | | Draw Shape onto Image | 在图像上绘制形状 | | Trim Image | 修剪图像 | | Display Clipboard | 显示剪贴板 | | Get Image Size | 获取图像大小 | | Stream Deck Set Image | 流甲板设置图像 | | Set File Icon | 设置文件图标 | # 界面控制 Interface Control | Interface Control | 界面控制 | | ---------------------------------- | ----------- | | | | | Resize a Window | 调整窗口大小 | | Move a Window | 移动窗口 | | | | | Manipulate a Window | 操纵窗口 | | Bring a Window to the Front | 将窗户放在前面 | | Bring Application Windows to Front | 将应用程序窗口置于前面 | | Move or Click Mouse | 移动或单击鼠标 | | | | | Click at Found Image | 单击找到的图像 | | Select or Show a Menu Item | 选择或显示菜单项 | | | | | Select Menu by Name | 按名称选择菜单 | | a Press a Button | a 按一个按钮 | | a Press a Button When Enabled | a 启用后按下按钮 | | | | | Type a Keystroke | 输入一个按键 | | | | | Type Modifiers | 类型修饰符 | | Simulate Hardware Key | 模拟硬件密钥 | | Simulate Scroll Wheel | 模拟滚轮 | | Use Variable | 使用变量 | | | | | Set Next Engine Window Position | 设置下一个引擎窗口位置 | # 键盘大师 Keyboard Maestro | Keyboard Maestro | 键盘大师 | | ------------------------------------- | ----------- | | | | | Record Quick Macro | 录制快速宏 | | | | | Trigger Macro by Name | 按名称触发宏 | | Show Palette of Macros | 显示宏调色板 | | Show Palette of Macros with Touch Bar | 使用触摸栏显示宏调色板 | | Get Touch Bar Selection | 获取触摸栏选择 | | Execute a Macro | 执行宏 | | Execute a Subroutine | 执行子程序 | | Return Result | 返回结果 | | | | | Trigger Macros by Hot Key | 通过热键触发宏 | | Set Macro or Group Enable | 设置宏或组启用 | | Mark Macro | 马克·宏 | | | | | Activate Macro Group for One Action | 为一项操作激活宏组 | | Activate Macro Group | 激活宏组 | | Deactivate Macro Group | 停用宏组 | | Activate/Deactivate Macro Group | 激活/停用宏组 | | Show Macro Group for One Action | 显示一项操作的宏组 | | Show Macro Group | 显示宏组 | | Hide Macro Group | 隐藏宏组 | | | | | Show/Hidle Macro Group | 显示/隐藏宏组 | | Toggle Keyboard Maestro Dark Mode | 切换键盘大师深色模式 | | Cancel All Macros | 取消所有宏 | | Comment | 评论 | | | | | Group | 团体 | | | | | Set Next Engine Window Position | 设置下一个引擎窗口位置 | | Show Global Macro Palette | 显示全局宏调色板 | | Hide Global Macro Palette | 隐藏全局宏调色板 | | | | | Toggle Global Macro Palette | 切换全局宏调色板 | | Conceal Macro Palettes | 隐藏宏调色板 | | Show Applications Palette | 显示应用程序面板 | | Hide Applications Palette | 隐藏应用程序面板 | | Toggle Applications Palette | 切换应用程序面板 | | Show Status Menu | 显示状态菜单 | | | | | Clear Typed String Buffer | 清除类型化字符串缓冲区 | | Set Action Delay | 设置动作延迟 | # MIDI | MIDI | MIDI | | ------------------------ | ------------ | | | | | Send MIDl Note On | 发送 MIDl 注释 | | | | | Send MIDI Note Off | 发送 MIDI 音符关闭 | | | | | Send MIDl Control Change | 发送 MIDl 控制更改 | | Send MIDI Packet | 发送 MIDI 数据包 | # 音乐控制 Music Control | Music Control | 音乐控制 | | --------------------------------- | ------------ | | | | | Play a Specific Track | 播放特定曲目 | | Play a Specific Playlist | 播放特定的播放列表 | | Play a Random Track | 播放随机曲目 | | Play a Random Track from Playlist | 播放播放列表中的随机曲目 | | Play/Pause Current Track | 播放/暂停当前曲目 | | Pause Current Track | 暂停当前曲目 | | | | | Stop Current Track | 停止当前曲目 | | Fast-Forward Current Track | 快进当前轨道 | | Rewind Current Track | 快退当前曲目 | | Next Track | 下一曲目 | | Previous Track | 上一曲目 | | Increase Music Volume | 增加音乐音量 | | Decrease Music Volume | 降低音乐音量 | | Set Music Volume | 设置音乐音量 | | | | | Increase Rating by Half a Star | 评分增加半颗星 | | Decrease Rating by Half a Star | 评级降低半颗星 | | Set Rating | 设置评级 | # 通知 Notifications | Notifications | 通知 | | -------------------------- | ----------- | | | | | Set Mail Status | 设置邮件状态 | | | | | Send Mail Message | 发送邮件消息 | | Send SMS | 发简讯 | | | | | Send iMessage | 发送 iMessage | | Send Pushover Notification | 发送推送通知 | | Notification | 通知 | | | | | Display Text | 显示文字 | | Alert | 警报 | | | | | Prompt for User Input | 提示用户输入 | | | | | Custom HTML Prompt | 自定义 HTML 提示 | | Display Progress | 显示进度 | | System Beep | 系统提示音 | | Play Sound | 播放声音 | | Speak Text | 朗读文字 | | Log | 日志 | | | | | Highlight Location | 突出显示位置 | # 打开 Open | Open | 打开 | | -------------------------- | ----------- | | | | | Set Mail Status | 设置邮件状态 | | | | | Send Mail Message | 发送邮件消息 | | Send SMS | 发简讯 | | | | | Send iMessage | 发送 iMessage | | Send Pushover Notification | 发送推送通知 | | Notification | 通知 | | | | | Display Text | 显示文字 | | Alert | 警报 | | | | | Prompt for User Input | 提示用户输入 | | | | | Custom HTML Prompt | 自定义 HTML 提示 | | Display Progress | 显示进度 | | System Beep | 系统提示音 | | Play Sound | 播放声音 | | Speak Text | 朗读文字 | | Log | 日志 | | | | | Highlight Location | 突出显示位置 | # QuickTime 播放器控制 QuickTime Player Control | QuickTime Player Control | QuickTime 播放器控制 | | ----------------------------- | --------------- | | | | | Play Current Movie | 播放当前电影 | | Play/Pause Current Movie | 播放/暂停当前电影 | | Pause Current Movie | 暂停当前电影 | | | | | Step Forward Current Movie | 前进当前电影 | | Step Backward Current Movie | 向后退当前电影 | | Increase Current Movie Volume | 增加当前电影音量 | | Decrease Current Movie Volume | 降低当前电影音量 | | Set Current Movie Volume | 设置当前电影音量 | # Safari 控制 Safari Control | Safari Control | Safari 控制 | | --------------------------------- | ----------------------- | | | | | New Safari Window | 新的 Safari 窗口 | | | | | New Safari Tab | 新的 Safari 标签 | | | | | Next Safari Tab | 下一个 Safari 选项卡 | | Previous Safari Tab | 上一个 Safari 选项卡 | | | | | Select Safari Tab | 选择 Safari 选项卡 | | | | | Wait For Safari to Finish Loading | 等待 Safari 完成加载 | | Set Safari URL | 设置 Safari URL | | | | | Set Safari Title | 设置 Safari 标题 | | | | | Click Safari Link | 单击 Safari 链接 | | | | | Focus Safari Field | 焦点野生动物园领域 | | | | | Select Safari Field | 选择 Safari 字段 | | | | | Set Variable to Safari Field | 将变量设置为 Safari 字段 | | | | | Set Safari Field to Text | 将 Safari 字段设置为文本 | | | | | Set Safari Checkbox | 设置 Safari 复选框 | | | | | Set Safari Radio Button | 设置 Safari 单选按钮 | | | | | Submit Safari Form | 提交 Safari 表格 | | | | | Reset Safari Form | 重置 Safari 表单 | | | | | Execute a JavaScript in Safari | 在 Safari 中执行 JavaScript | # 串流面板控制 Stream Deck Control | Stream Deck Control | 串流面板控制 | | ---------------------- | -------- | | | | | Stream Deck Show OK | 串流面板显示正常 | | Stream Deck Show Alert | 串流面板显示警报 | | Stream Deck Set Title | 串流面板标题设置 | | | | | Stream Deck Set Image | 串流面板图像设置 | # 切换器 Switchers | Switchers | 切换器 | | ----------------------------------- | ------------ | | | | | Activate Application Launcher | 激活应用程序启动器 | | Activate Application Switcher | 激活应用程序切换器 | | Activate Window Switcher | 激活窗口切换器 | | Activate Named Clipboard Switcher | 激活命名剪贴板切换器 | | Activate Clipboard History Switcher | 激活剪贴板历史记录切换器 | # 系统控制 System Control | System Control | 系统控制 | | ---------------------------------- | ----------- | | | | | Put Computer to Sleep | 让计算机进入睡眠状态 | | Restart Computer | 重新启动计算机 | | Shut Down Computer | 关闭计算机 | | Set Screen Resolution | 设置屏幕分辨率 | | | | | Toggle System Dark Mode | 切换系统深色模式 | | Set Desktop Image | 设置桌面图像 | | Fast User Switch | 快速用户切换 | | | | | Login Window | 登录窗口 | | Log Out | 登出 | | Set Find Pasteboard | 设置查找粘贴板 | | | | | Set Keyboard Layout | 设置键盘布局 | | Open/Close the CD Tray | 打开/关闭 CD 托盘 | | Toggle System Sound Mute | 切换系统静音 | | Increase System Sound Volume | 提高系统音量 | | Small Increase System Sound Volume | 小幅增加系统音量 | | Decrease System Sound Volume | 降低系统音量 | | Small Decrease System Sound Volume | 小幅降低系统音量 | | Set System Output Volume | 设置系统输出音量 | | Set Audio Input Device | 设置音频输入设备 | | Set Audio Output Device | 设置音频输出设备 | | Set Audio Sound Effects Device | 设置音频音效设备 | | Mute Audio Device | 将音频设备静音 | | Unmute Audio Device | 取消音频设备静音 | | | | | Toggle Mute Audio Device | 切换音频设备静音 | | Increase Screen Brightness | 增加屏幕亮度 | | Small Increase Screen Brightness | 小幅增加屏幕亮度 | | Decrease Screen Brightness | 降低屏幕亮度 | | Small Decrease Screen Brightness | 小幅度降低屏幕亮度 | | Start Screen Saver | 启动屏幕保护程序 | | Stop Screen Saver | 停止屏幕保护程序 | | | | | Sleep Screen | 睡眠屏幕 | | Wake Screen | 唤醒屏幕 | | | | | Set Network Location | 设置网络位置 | | | | | Create Calendar Event | 创建日历事件 | | | | | Get Location | 获取位置 | # 文本 Text | Text | 文本 | | ----------------------------- | ----------- | | | | | Insert Text by Pasting | 通过粘贴插入文本 | | Insert Styled Text by Pasting | 通过粘贴插入样式文本 | | Insert Text by Typing | 通过键入插入文本 | | Display Text | 显示文字 | | a Type a Keystroke | a 输入击键 | | Set Clipboard to Text | 将剪贴板设置为文本 | | Prepend Text to Variable | 将文本添加到变量前面 | | Set Variable to Text | 将变量设置为文本 | | | | | Append Variable with Text | 附加变量与文本 | | Set Dictionary Value | 设置字典值 | | Set JSON Value | 设置 JSON 值 | | Set Variables to JSON | 将变量设置为 JSON | | Set Dictionary to JSON | 将字典设置为 JSON | | Apply Style to Clipboard | 将样式应用到剪贴板 | | Speak Text | 朗读文字 | # 变量 Variables | Variables | 变量 | | ---------------------------------- | ----------- | | | | | | | | Prepend Text to Variable | 将文本添加到变量前面 | | Set Variable to Text | 将变量设置为文本 | | | | | Append Variable with Text | 附加变量与文本 | | Set Variable to Calculation | 设置变量进行计算 | | Set Variable to Clipboard | 将变量设置为剪贴板 | | Set Dictionary Value | 设置字典值 | | Set JSON Value | 设置 JSON 值 | | Set Variables to JSON | 将变量设置为 JSON | | | | | Set Dictionary to JSON | 将字典设置为 JSON | | Set Variable to Keychain Password | 将变量设置为钥匙串密码 | | Set Keychain Password to Text | 将钥匙串密码设置为文本 | | Set Keychain Password to Variable | 将钥匙串密码设置为变量 | | Filter | 筛选 | | | | | Search and Replace | 搜索和替换 | | Search using Regular Expression | 使用正则表达式搜索 | | Substring of Variable or Clipboard | 变量或剪贴板的子字符串 | | Split Path | 分割路径 | | Use Variable | 使用变量 | | | | | Prompt for User Input | 提示用户输入 | | Prompt for Snippet | 提示片段 | | Prompt for File | 提示输入文件 | | Prompt With List | 提示列表 | | Prompt for Screen Rectangle | 提示输入屏幕矩形 | | Custom HTML Prompt | 自定义 HTML 提示 | | Display Progress | 显示进度 | # 网页 Web | Web | 网页 | | -------------- | ------ | | | | | Open a URL | 打开一个网址 | | Remote Trigger | 远程触发 | | Get a URL | 获取网址 | | Search the Web | 搜索网页 | # 变量 # 剪贴板 # 浮窗 Palettes # 编程和调试 Programming and Debugging # 有用的脚本 # 设置、同步与附加功能 # Menu详解 # 《优雅地使用Mac——小白轻松上手Keyboard Maestro》优惠课正在开发中！ # 拆解任务的方法 ![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403170957912.png)