# 界面介绍

***

## 编辑器窗口

要编辑宏，请启动 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.md)在详情栏配置

#### ➋ 宏列（中间）

* 列出所选组中的所有宏
* 宏是描述您希望 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.md)。这里简单介绍一下菜单栏中的主要功能。

![](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（编辑）

<img src="https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142154239.png" alt="Edit" width="188">

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

<img src="https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142154962.png" alt="" width="188">

<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（动作）

<img src="https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142155071.png" alt="" width="188">

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

<img src="https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142155667.png" alt="" width="188">

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

6. Help（帮助）

<img src="https://cdn.jsdelivr.net/gh/wuzimuws/imgbed@main/img/202403142156388.png" alt="" width="188">

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://km.qxpai.cn/jie-mian-jie-shao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.