mirror of
				https://github.com/nonebot/nonebot2.git
				synced 2025-10-30 22:46:40 +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 类型与类型注释相符时才会执行该处理函数!可用于多平台进行不同的处理。 | ||||
| 2. [nonebot.typing.Event](../api/typing.md#event): | ||||
| 3. `state`: | ||||
| 2. [nonebot.typing.Event](../api/typing.md#event): 即上报事件对象,可以获取到上报的所有信息。 | ||||
| 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