# 写在前面：为什么要做中文手册？

我最早了解到 `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`的形式，更直观地展示具体用法及不同条目之间的区别。
* 配套有详细视频教程，目前视频教程正在开发中，敬请期待！


---

# 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/xie-zai-qian-mian-wei-shen-me-yao-zuo-zhong-wen-shou-ce.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.