mirror of
				https://github.com/nonebot/nonebot2.git
				synced 2025-10-31 15:06:42 +00:00 
			
		
		
		
	📝 finish plugin introduction
This commit is contained in:
		| @@ -254,5 +254,37 @@ async def handle(bot: Bot, event: Event, state: dict): | |||||||
| 参数分别为: | 参数分别为: | ||||||
|  |  | ||||||
| 1. [nonebot.typing.Bot](../api/typing.md#bot): 即事件上报连接对应的 Bot 对象,为 BaseBot 的子类。特别注意,此处的类型注释可以替换为指定的 Bot 类型,例如:`nonebot.adapters.cqhttp.Bot`,只有在上报事件的 Bot 类型与类型注释相符时才会执行该处理函数!可用于多平台进行不同的处理。 | 1. [nonebot.typing.Bot](../api/typing.md#bot): 即事件上报连接对应的 Bot 对象,为 BaseBot 的子类。特别注意,此处的类型注释可以替换为指定的 Bot 类型,例如:`nonebot.adapters.cqhttp.Bot`,只有在上报事件的 Bot 类型与类型注释相符时才会执行该处理函数!可用于多平台进行不同的处理。 | ||||||
| 2. [nonebot.typing.Event](../api/typing.md#event): | 2. [nonebot.typing.Event](../api/typing.md#event): 即上报事件对象,可以获取到上报的所有信息。 | ||||||
| 3. `state`: | 3. `state`: 状态字典,可以存储任意的信息 | ||||||
|  |  | ||||||
|  | #### 处理事件 | ||||||
|  |  | ||||||
|  | 在事件处理函数中,我们只需要对 `event` 做出相应的处理,存入状态字典 `state` 中,或者向用户发送消息、调用某个机器人 API 等等。 | ||||||
|  |  | ||||||
|  | 在 NoneBot 中,提供了几种特殊的处理函数: | ||||||
|  |  | ||||||
|  | ##### `@matcher.args_parser` | ||||||
|  |  | ||||||
|  | 这是一个装饰器,装饰一个函数来使它成为参数的默认解析函数,当使用 `matcher.got(xxx, [args_parser])` 获取到一条消息时,会运行 `matcher.got` 的 `args_parser` ,如果不存在则运行 `@matcher.args_parser`。 | ||||||
|  |  | ||||||
|  | ##### `matcher.pause` | ||||||
|  |  | ||||||
|  | 这个函数用于结束当前事件处理函数,强制接收一条新的消息再运行**下一个消息处理函数**。 | ||||||
|  |  | ||||||
|  | ##### `matcher.reject` | ||||||
|  |  | ||||||
|  | 这个函数用于结束当前事件处理函数,强制接收一条新的消息再**再次运行当前消息处理函数**。 | ||||||
|  |  | ||||||
|  | ##### `matcher.finish` | ||||||
|  |  | ||||||
|  | 这个函数用于直接结束当前事件处理。 | ||||||
|  |  | ||||||
|  | 以上三个函数都拥有一个参数 `prompt`,用于向用户发送一条消息。 | ||||||
|  |  | ||||||
|  | ## 结语 | ||||||
|  |  | ||||||
|  | 至此,相信你已经能够写出一个基础的插件了,更多的用法将会在 进阶 部分进行介绍,这里给出几个小提示: | ||||||
|  |  | ||||||
|  | - 请千万注意事件处理器的优先级设定 | ||||||
|  | - 在匹配规则中请勿使用耗时极长的函数 | ||||||
|  | - 同一个用户可以跨群(私聊)继续他的事件处理(除非做出权限限制,将在后续介绍) | ||||||
|   | |||||||
		Reference in New Issue
	
	Block a user