From 56e489b458d55faa4bb0d7a2ac3e4379f889bbd1 Mon Sep 17 00:00:00 2001
From: yanyongyu <yanyongyu_1@126.com>
Date: Sun, 25 Apr 2021 13:18:36 +0800
Subject: [PATCH] :memo: update doc

---
 docs/advanced/overloaded-handlers.md | 36 ++++++++++++++++++++--------
 1 file changed, 26 insertions(+), 10 deletions(-)

diff --git a/docs/advanced/overloaded-handlers.md b/docs/advanced/overloaded-handlers.md
index 6e0ff782..1895727b 100644
--- a/docs/advanced/overloaded-handlers.md
+++ b/docs/advanced/overloaded-handlers.md
@@ -2,9 +2,9 @@
 
 当我们在编写 `nonebot2` 应用时，常常会遇到这样一个问题：该怎么让同一类型的不同事件执行不同的响应逻辑？又或者如何让不同的 `adapter` 针对同一类型的事件作出不同响应？
 
-针对这个问题， `nonebot2` 提供一个便捷而高效的解决方案：事件处理函数重载机制。简单地说，`handler` (事件处理函数) 会根据其参数的 `type hints` (类型标注) 来对相对应的 `adapter` 和 `Event` 进行响应，并且会忽略不符合其参数类型标注的情况。
+针对这个问题， `nonebot2` 提供一个便捷而高效的解决方案：事件处理函数重载机制。简单地说，`handler` (事件处理函数) 会根据其参数的 `type hints` ([PEP484 类型标注](https://www.python.org/dev/peps/pep-0484/)) 来对相对应的 `adapter` 和 `Event` 进行响应，并且会忽略不符合其参数类型标注的情况。
 
-必须要注意的是，该机制利用了 `inspect` 标准库获取到了事件处理函数的 `singnature` (签名) ，进一步获取到参数名称和类型标注。故而，我们在编写 `handler` 时，参数的名称和类型标注必须要符合 `T_handler` 之规定，详情可以参看 **指南** 中的[事件处理](../guide/creating-a-handler)。
+必须要注意的是，该机制利用了 `inspect` 标准库获取到了事件处理函数的 `singnature` (签名) ，进一步获取到参数名称和类型标注。故而，我们在编写 `handler` 时，参数的名称和类型标注必须要符合 `T_Handler` 规定，详情可以参看 **指南** 中的[事件处理](../guide/creating-a-handler)。
 
 ::: tip 提示
 
@@ -19,30 +19,46 @@
 首先，我们需要导入需要的方法、类型。
 
 ```python
-from nonebot.adapters.cqhttp.bot import Bot
-from nonebot.adapters.cqhttp.event import GroupMessageEvent, PrivateMessageEvent
-from nonebot.plugin import on_command
+from nonebot import on_command
+from nonebot.adapters.cqhttp import Bot, GroupMessageEvent, PrivateMessageEvent
 ```
 
 之后，我们可以注册一个 `Matcher` 来响应 `消息事件` 。
 
 ```python
-matcher = on_command('testoverload')
+matcher = on_command("testoverload")
 ```
 
-最后,  我们编写不同的 `handler` 并编写不同的类型标注来实现事件处理函数重载：
+最后, 我们编写不同的 `handler` 并编写不同的类型标注来实现事件处理函数重载：
 
 ```python
 @matcher.handle()
 async def _(bot: Bot, event: GroupMessageEvent):
-    await matcher.send('群聊消息事件响应成功！')
+    await matcher.send("群聊消息事件响应成功！")
 
 
 @matcher.handle()
 async def _(bot: Bot, event: PrivateMessageEvent):
-    await matcher.send('私聊消息事件响应成功！')
+    await matcher.send("私聊消息事件响应成功！")
 ```
 
 此时，我们可以在群聊或私聊中对我们的机器人发送 `testoverload` ，它会在不同的场景做出不同的应答。
 
-这样一个简单的事件处理函数重载就完成了。
\ No newline at end of file
+这样一个简单的事件处理函数重载就完成了。
+
+## 进阶
+
+事件处理函数重载机制同样支持被 `matcher.got` 等装饰器装饰的函数。 例如：
+
+```python
+@matcher.got("key1", prompt="群事件提问")
+async def _(bot: Bot, event: GroupMessageEvent):
+    await matcher.send("群聊消息事件响应成功！")
+
+
+@matcher.got("key2", prompt="私聊事件提问")
+async def _(bot: Bot, event: PrivateMessageEvent):
+    await matcher.send("私聊消息事件响应成功！")
+```
+
+只有触发事件符合的函数才会触发装饰器。