# 界面介绍

***

## 编辑器窗口

要编辑宏，请启动 Keyboard Maestro 应用程序。它将显示一个或多个编辑器窗口。如果关闭最后一个编辑器窗口，Keyboard Maestro 应用程序将退出，但 Keyboard Maestro 引擎将继续运行以执行宏。通常，您仅在想要更改宏时才启动 Keyboard Maestro 编辑器应用程序，并且仅让 Keyboard Maestro 引擎正常运行。 您可以通过选择“文件”➤“新建编辑器窗口”菜单来创建新的编辑器窗口。

### 窗口元素

![主界面](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403141547606.png)

#### ➊ 宏组列（左侧）

* #### 您帐户中的所有智能组（顶部）和宏组的列表

* 智能组是保存的宏搜索。

* [宏组的属性](https://km.qxpai.cn/jie-mian-jie-shao/hong-zu-de-shu-xing-pei-zhi)在详情栏配置

#### ➋ 宏列（中间）

* 列出所选组中的所有宏
* 宏是描述您希望 Keyboard Maestro 执⾏的操作的主要⽅式。
* 您可以使⽤搜索字段（右上⾓）过 滤列表以查找特定宏。

#### ➌ 详情列（右侧）

* 显⽰或编辑所选宏、宏组或智能组的详细信息。

  * 您可以在此处输⼊所选宏的实际详细信息。
  * 布局根据选择的类型⽽变化。对于宏，它包括名称、启⽤状态、触发器和操作。对于宏组，它包括名称和启⽤ 状态，以及有关何时以及如何激活或显⽰的详细信息。对于智能组，它包括名称和要显⽰的宏。

#### ➍ 分隔线

* 您可以使⽤分隔线调整列的⼤⼩，然后双击它们以⾃动调整列的⼤⼩。

#### ➎ 顶部工具栏

* 顶部的⼯具栏显⽰适⽤于所有宏的⼯具。详情请参阅[顶部工具栏](https://km.qxpai.cn/broken-reference)。

![](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详解](https://km.qxpai.cn/menu-xiang-jie)。这里简单介绍一下菜单栏中的主要功能。

![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142058624.png)

1. File（文件）

<div data-full-width="true"><img src="https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142132797.png" alt="File" width="188"></div>

|                         | 含义      | 解释                                                                                                 |
| ----------------------- | ------- | -------------------------------------------------------------------------------------------------- |
| 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](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142154239.png)

|                       | 含义          | 解释                                                                                                       |
| --------------------- | ----------- | -------------------------------------------------------------------------------------------------------- |
| 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（视图）

![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142154962.png)

<table><thead><tr><th width="288"></th><th>含义</th><th>解释</th></tr></thead><tbody><tr><td>Sort Macros by</td><td></td><td></td></tr><tr><td>Select Groups Column</td><td></td><td></td></tr><tr><td>Select Macros Column</td><td></td><td></td></tr><tr><td>Go to Macro</td><td></td><td></td></tr><tr><td>Go to Last Aborted Action</td><td></td><td></td></tr><tr><td>Reveal Parent Group</td><td></td><td></td></tr><tr><td>Hide Disabled Macro Groups</td><td></td><td></td></tr><tr><td>Evaluate Condition Results</td><td></td><td></td></tr><tr><td>Enable Macro</td><td></td><td></td></tr><tr><td>Stop Editing Macros</td><td></td><td></td></tr><tr><td>Rename...</td><td></td><td></td></tr><tr><td>Record Without Delay</td><td></td><td></td></tr></tbody></table>

4. Actions（动作）

![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142155071.png)

|                          | 含义 | 解释 |
| ------------------------ | -- | -- |
| 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（窗口）

![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142155667.png)

|                         | 含义 | 解释 |
| ----------------------- | -- | -- |
| Minimize                |    |    |
| 全部最小化                   |    |    |
| Zoom                    |    |    |
| Keyboard Maestro Editor |    |    |
| Macro Library           |    |    |
| Icon Chooser            |    |    |
| Macro Inspector         |    |    |
| Mouse Display           |    |    |
| Value Inspector         |    |    |
| Bring All to Front      |    |    |

6. Help（帮助）

![](https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142156388.png)

|                                       | 含义                    | 解释 |
| ------------------------------------- | --------------------- | -- |
| 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                   |                       |    |
