Version: Next

事件响应器

事件响应器（Matcher）是对接收到的事件进行响应的基本单元，所有的事件响应器都继承自 Matcher 基类。

在 NoneBot 中，事件响应器可以通过一系列特定的规则筛选出具有某种特征的事件，并按照特定的流程交由预定义的事件处理依赖进行处理。例如，在快速上手中，我们使用了内置插件 echo ，它定义的事件响应器能响应机器人用户发送的“/echo hello world”消息，提取“hello world”信息并作为回复消息发送。

事件响应器辅助函数

NoneBot 中所有事件响应器均继承自 Matcher 基类，但直接使用 Matcher.new() 方法创建事件响应器过于繁琐且不能记录插件信息。因此，NoneBot 中提供了一系列“事件响应器辅助函数”（下称“辅助函数”）来辅助我们用最简的方式创建带有不同规则预设的事件响应器，提高代码可读性和书写效率。通常情况下，我们只需要使用辅助函数即可完成事件响应器的创建。

在 NoneBot 中，辅助函数以 on() 或 on_<type/rule>() 形式出现（例如 on_command()），调用后根据不同的参数返回一个 Type[Matcher] 类型的新事件响应器。

目前 NoneBot 提供了多种功能各异的辅助函数、具有共同命令名称前缀的命令组以及具有共同参数的响应器组，均可以从 nonebot 模块直接导入使用，具体内容参考事件响应器进阶。

创建事件响应器

在上一节创建插件中，我们创建了一个 weather 插件，现在我们来实现他的功能。

我们直接使用 on_command() 辅助函数来创建一个事件响应器：

weather/__init__.py
from nonebot import on_command


weather = on_command("天气")

这样，我们就获得一个名为 weather 的事件响应器了，这个事件响应器会对 /天气 开头的消息进行响应。

提示

如果一条消息中包含“@机器人”或以“机器人的昵称”开始，例如 @bot /天气 时，协议适配器会将 event.is_tome() 判断为 True ，同时也会自动去除 @bot，即事件响应器收到的信息内容为 /天气，方便进行命令匹配。

为事件响应器添加参数

在辅助函数中，我们可以添加一些参数来对事件响应器进行更加精细的调整，例如事件响应器的优先级、匹配规则等。例如：

weather/__init__.py
from nonebot import on_command
from nonebot.rule import to_me


weather = on_command("天气", rule=to_me(), aliases={"weather", "查天气"}, priority=10, block=True)

这样，我们就获得了一个可以响应 天气、weather、查天气 三个命令，需要私聊或 @bot 时才会响应，优先级为 10 ，阻断事件传播的事件响应器了。这些内容的意义和使用方法将会在后续的章节中一一介绍。

提示

需要注意的是，不同的辅助函数有不同的可选参数，在使用之前可以参考事件响应器进阶或编辑器的提示。