diff --git a/docs/api/adapters/README.md b/docs/api/adapters/README.md
index a0a0571e..9337ec17 100644
--- a/docs/api/adapters/README.md
+++ b/docs/api/adapters/README.md
@@ -4,3 +4,473 @@ sidebarDepth: 0
 ---
 
 # NoneBot.adapters 模块
+
+## 协议适配基类
+
+各协议请继承以下基类，并使用 `driver.register_adapter` 注册适配器
+
+
+## _class_ `Bot`
+
+基类：`abc.ABC`
+
+Bot 基类。用于处理上报消息，并提供 API 调用接口。
+
+
+### `driver`
+
+Driver 对象
+
+
+### `config`
+
+Config 配置对象
+
+
+### `_calling_api_hook`
+
+
+* **类型**
+
+    `Set[T_CallingAPIHook]`
+
+
+
+* **说明**
+
+    call_api 时执行的函数
+
+
+
+### `_called_api_hook`
+
+
+* **类型**
+
+    `Set[T_CalledAPIHook]`
+
+
+
+* **说明**
+
+    call_api 后执行的函数
+
+
+
+### `__init__(self_id, request)`
+
+
+* **参数**
+
+    
+    * `connection_type: str`: http 或者 websocket
+
+
+    * `self_id: str`: 机器人 ID
+
+
+    * `websocket: Optional[WebSocket]`: Websocket 连接对象
+
+
+
+### `self_id`
+
+机器人 ID
+
+
+### `request`
+
+连接信息
+
+
+### _abstract property_ `type`
+
+Adapter 类型
+
+
+### _classmethod_ `register(driver, config)`
+
+
+* **说明**
+
+    register 方法会在 driver.register_adapter 时被调用，用于初始化相关配置
+
+
+
+### _abstract async classmethod_ `check_permission(driver, request)`
+
+
+* **说明**
+
+    检查连接请求是否合法的函数，如果合法则返回当前连接 `唯一标识符`，通常为机器人 ID；如果不合法则抛出 `RequestDenied` 异常。
+
+
+
+* **参数**
+
+    
+    * `driver: Driver`: Driver 对象
+
+
+    * `connection_type: str`: 连接类型
+
+
+    * `headers: dict`: 请求头
+
+
+    * `body: Optional[bytes]`: 请求数据，WebSocket 连接该部分为 None
+
+
+
+* **返回**
+
+    
+    * `str`: 连接唯一标识符，`None` 代表连接不合法
+
+
+    * `HTTPResponse`: HTTP 上报响应
+
+
+
+* **异常**
+
+    
+    * `RequestDenied`: 请求非法
+
+
+
+### _abstract async_ `handle_message(message)`
+
+
+* **说明**
+
+    处理上报消息的函数，转换为 `Event` 事件后调用 `nonebot.message.handle_event` 进一步处理事件。
+
+
+
+* **参数**
+
+    
+    * `message: bytes`: 收到的上报消息
+
+
+
+### _abstract async_ `_call_api(api, **data)`
+
+
+* **说明**
+
+    `adapter` 实际调用 api 的逻辑实现函数，实现该方法以调用 api。
+
+
+
+* **参数**
+
+    
+    * `api: str`: API 名称
+
+
+    * `**data`: API 数据
+
+
+
+### _async_ `call_api(api, **data)`
+
+
+* **说明**
+
+    调用机器人 API 接口，可以通过该函数或直接通过 bot 属性进行调用
+
+
+
+* **参数**
+
+    
+    * `api: str`: API 名称
+
+
+    * `**data`: API 数据
+
+
+
+* **示例**
+
+
+```python
+await bot.call_api("send_msg", message="hello world")
+await bot.send_msg(message="hello world")
+```
+
+
+### _abstract async_ `send(event, message, **kwargs)`
+
+
+* **说明**
+
+    调用机器人基础发送消息接口
+
+
+
+* **参数**
+
+    
+    * `event: Event`: 上报事件
+
+
+    * `message: Union[str, Message, MessageSegment]`: 要发送的消息
+
+
+    * `**kwargs`
+
+
+
+## _class_ `MessageSegment`
+
+基类：`abc.ABC`, `Mapping`
+
+消息段基类
+
+
+### `type`
+
+
+* 类型: `str`
+
+
+* 说明: 消息段类型
+
+
+### `data`
+
+
+* 类型: `Dict[str, Union[str, list]]`
+
+
+* 说明: 消息段数据
+
+
+## _class_ `Message`
+
+基类：`List`[`nonebot.adapters._base.T_MessageSegment`], `abc.ABC`
+
+消息数组
+
+
+### `__init__(message=None, *args, **kwargs)`
+
+
+* **参数**
+
+    
+    * `message: Union[str, list, dict, MessageSegment, Message, Any]`: 消息内容
+
+
+
+### `append(obj)`
+
+
+* **说明**
+
+    添加一个消息段到消息数组末尾
+
+
+
+* **参数**
+
+    
+    * `obj: Union[str, MessageSegment]`: 要添加的消息段
+
+
+
+### `extend(obj)`
+
+
+* **说明**
+
+    拼接一个消息数组或多个消息段到消息数组末尾
+
+
+
+* **参数**
+
+    
+    * `obj: Union[Message, Iterable[MessageSegment]]`: 要添加的消息数组
+
+
+
+### `reduce()`
+
+
+* **说明**
+
+    缩减消息数组，即按 MessageSegment 的实现拼接相邻消息段
+
+
+
+### `extract_plain_text()`
+
+
+* **说明**
+
+    提取消息内纯文本消息
+
+
+
+## _class_ `Event`
+
+基类：`abc.ABC`, `pydantic.main.BaseModel`
+
+Event 基类。提供获取关键信息的方法，其余信息可直接获取。
+
+
+### _abstract_ `get_type()`
+
+
+* **说明**
+
+    获取事件类型的方法，类型通常为 NoneBot 内置的四种类型。
+
+
+
+* **返回**
+
+    
+    * `Literal["message", "notice", "request", "meta_event"]`
+
+
+    * 其他自定义 `str`
+
+
+
+### _abstract_ `get_event_name()`
+
+
+* **说明**
+
+    获取事件名称的方法。
+
+
+
+* **返回**
+
+    
+    * `str`
+
+
+
+### _abstract_ `get_event_description()`
+
+
+* **说明**
+
+    获取事件描述的方法，通常为事件具体内容。
+
+
+
+* **返回**
+
+    
+    * `str`
+
+
+
+### `get_log_string()`
+
+
+* **说明**
+
+    获取事件日志信息的方法，通常你不需要修改这个方法，只有当希望 NoneBot 隐藏该事件日志时，可以抛出 `NoLogException` 异常。
+
+
+
+* **返回**
+
+    
+    * `str`
+
+
+
+* **异常**
+
+    
+    * `NoLogException`
+
+
+
+### _abstract_ `get_user_id()`
+
+
+* **说明**
+
+    获取事件主体 id 的方法，通常是用户 id 。
+
+
+
+* **返回**
+
+    
+    * `str`
+
+
+
+### _abstract_ `get_session_id()`
+
+
+* **说明**
+
+    获取会话 id 的方法，用于判断当前事件属于哪一个会话，通常是用户 id、群组 id 组合。
+
+
+
+* **返回**
+
+    
+    * `str`
+
+
+
+### _abstract_ `get_message()`
+
+
+* **说明**
+
+    获取事件消息内容的方法。
+
+
+
+* **返回**
+
+    
+    * `Message`
+
+
+
+### `get_plaintext()`
+
+
+* **说明**
+
+    获取消息纯文本的方法，通常不需要修改，默认通过 `get_message().extract_plain_text` 获取。
+
+
+
+* **返回**
+
+    
+    * `str`
+
+
+
+### _abstract_ `is_tome()`
+
+
+* **说明**
+
+    获取事件是否与机器人有关的方法。
+
+
+
+* **返回**
+
+    
+    * `bool`
diff --git a/docs/api/adapters/cqhttp.md b/docs/api/adapters/cqhttp.md
index bd0ddf8e..760377e9 100644
--- a/docs/api/adapters/cqhttp.md
+++ b/docs/api/adapters/cqhttp.md
@@ -5,16 +5,673 @@ sidebarDepth: 0
 
 # NoneBot.adapters.cqhttp 模块
 
+## CQHTTP (OneBot) v11 协议适配
+
+协议详情请看: [CQHTTP](https://github.com/howmanybots/onebot/blob/master/README.md) | [OneBot](https://github.com/howmanybots/onebot/blob/master/README.md)
+
 # NoneBot.adapters.cqhttp.config 模块
 
+
+## _class_ `Config`
+
+CQHTTP 配置类
+
+
+* **配置项**
+
+    
+    * `access_token` / `cqhttp_access_token`: CQHTTP 协议授权令牌
+
+
+    * `secret` / `cqhttp_secret`: CQHTTP HTTP 上报数据签名口令
+
+
 # NoneBot.adapters.cqhttp.utils 模块
 
+
+## `escape(s, *, escape_comma=True)`
+
+
+* **说明**
+
+    对字符串进行 CQ 码转义。
+
+
+
+* **参数**
+
+    
+    * `s: str`: 需要转义的字符串
+
+
+    * `escape_comma: bool`: 是否转义逗号（`,`）。
+
+
+
+## `unescape(s)`
+
+
+* **说明**
+
+    对字符串进行 CQ 码去转义。
+
+
+
+* **参数**
+
+    
+    * `s: str`: 需要转义的字符串
+
+
 # NoneBot.adapters.cqhttp.exception 模块
 
+
+## _exception_ `ActionFailed`
+
+基类：[`nonebot.exception.ActionFailed`](../exception.md#nonebot.exception.ActionFailed), `nonebot.adapters.cqhttp.exception.CQHTTPAdapterException`
+
+
+* **说明**
+
+    API 请求返回错误信息。
+
+
+
+* **参数**
+
+    
+    * `retcode: Optional[int]`: 错误码
+
+
+
+## _exception_ `NetworkError`
+
+基类：[`nonebot.exception.NetworkError`](../exception.md#nonebot.exception.NetworkError), `nonebot.adapters.cqhttp.exception.CQHTTPAdapterException`
+
+
+* **说明**
+
+    网络错误。
+
+
+
+* **参数**
+
+    
+    * `retcode: Optional[int]`: 错误码
+
+
 # NoneBot.adapters.cqhttp.bot 模块
 
+
+## _async_ `_check_reply(bot, event)`
+
+
+* **说明**
+
+    检查消息中存在的回复，去除并赋值 `event.reply`, `event.to_me`
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: Event 对象
+
+
+
+## `_check_at_me(bot, event)`
+
+
+* **说明**
+
+    检查消息开头或结尾是否存在 @机器人，去除并赋值 `event.to_me`
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: Event 对象
+
+
+
+## `_check_nickname(bot, event)`
+
+
+* **说明**
+
+    检查消息开头是否存在，去除并赋值 `event.to_me`
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: Event 对象
+
+
+
+## `_handle_api_result(result)`
+
+
+* **说明**
+
+    处理 API 请求返回值。
+
+
+
+* **参数**
+
+    
+    * `result: Optional[Dict[str, Any]]`: API 返回数据
+
+
+
+* **返回**
+
+    
+    * `Any`: API 调用返回数据
+
+
+
+* **异常**
+
+    
+    * `ActionFailed`: API 调用失败
+
+
+
+## _class_ `Bot`
+
+基类：[`nonebot.adapters._base.Bot`](README.md#nonebot.adapters._base.Bot)
+
+CQHTTP 协议 Bot 适配。继承属性参考 [BaseBot](./#class-basebot) 。
+
+
+### _property_ `type`
+
+
+* 返回: `"cqhttp"`
+
+
+### _async classmethod_ `check_permission(driver, request)`
+
+
+* **说明**
+
+    CQHTTP (OneBot) 协议鉴权。参考 [鉴权](https://github.com/howmanybots/onebot/blob/master/v11/specs/communication/authorization.md)
+
+
+
+### _async_ `handle_message(message)`
+
+
+* **说明**
+
+    调用 [_check_reply](#async-check-reply-bot-event), [_check_at_me](#check-at-me-bot-event), [_check_nickname](#check-nickname-bot-event) 处理事件并转换为 [Event](#class-event)
+
+
+
+### _async_ `call_api(api, **data)`
+
+
+* **说明**
+
+    调用 CQHTTP 协议 API
+
+
+
+* **参数**
+
+    
+    * `api: str`: API 名称
+
+
+    * `**data: Any`: API 参数
+
+
+
+* **返回**
+
+    
+    * `Any`: API 调用返回数据
+
+
+
+* **异常**
+
+    
+    * `NetworkError`: 网络错误
+
+
+    * `ActionFailed`: API 调用失败
+
+
+
+### _async_ `send(event, message, at_sender=False, **kwargs)`
+
+
+* **说明**
+
+    根据 `event`  向触发事件的主体发送消息。
+
+
+
+* **参数**
+
+    
+    * `event: Event`: Event 对象
+
+
+    * `message: Union[str, Message, MessageSegment]`: 要发送的消息
+
+
+    * `at_sender: bool`: 是否 @ 事件主体
+
+
+    * `**kwargs`: 覆盖默认参数
+
+
+
+* **返回**
+
+    
+    * `Any`: API 调用返回数据
+
+
+
+* **异常**
+
+    
+    * `ValueError`: 缺少 `user_id`, `group_id`
+
+
+    * `NetworkError`: 网络错误
+
+
+    * `ActionFailed`: API 调用失败
+
+
 # NoneBot.adapters.cqhttp.message 模块
 
+
+## _class_ `MessageSegment`
+
+基类：`abc.ABC`, `Mapping`
+
+CQHTTP 协议 MessageSegment 适配。具体方法参考协议消息段类型或源码。
+
+
+### `is_text()`
+
+
+### _static_ `anonymous(ignore_failure=None)`
+
+
+### _static_ `at(user_id)`
+
+
+### _static_ `contact(type_, id)`
+
+
+### _static_ `contact_group(group_id)`
+
+
+### _static_ `contact_user(user_id)`
+
+
+### _static_ `dice()`
+
+
+### _static_ `face(id_)`
+
+
+### _static_ `forward(id_)`
+
+
+### _static_ `image(file, type_=None, cache=True, proxy=True, timeout=None)`
+
+
+### _static_ `json(data)`
+
+
+### _static_ `location(latitude, longitude, title=None, content=None)`
+
+
+### _static_ `music(type_, id_)`
+
+
+### _static_ `music_custom(url, audio, title, content=None, img_url=None)`
+
+
+### _static_ `node(id_)`
+
+
+### _static_ `node_custom(user_id, nickname, content)`
+
+
+### _static_ `poke(type_, id_)`
+
+
+### _static_ `record(file, magic=None, cache=None, proxy=None, timeout=None)`
+
+
+### _static_ `reply(id_)`
+
+
+### _static_ `rps()`
+
+
+### _static_ `shake()`
+
+
+### _static_ `share(url='', title='', content=None, image=None)`
+
+
+### _static_ `text(text)`
+
+
+### _static_ `video(file, cache=None, proxy=None, timeout=None)`
+
+
+### _static_ `xml(data)`
+
+
+### `type`
+
+
+* 类型: `str`
+
+
+* 说明: 消息段类型
+
+
+### `data`
+
+
+* 类型: `Dict[str, Union[str, list]]`
+
+
+* 说明: 消息段数据
+
+
+## _class_ `Message`
+
+基类：[`nonebot.adapters._base.Message`](README.md#nonebot.adapters._base.Message)[`nonebot.adapters.cqhttp.message.MessageSegment`]
+
+CQHTTP 协议 Message 适配。
+
+
+### `extract_plain_text()`
+
 # NoneBot.adapters.cqhttp.permission 模块
 
+
+## `PRIVATE`
+
+
+* **说明**: 匹配任意私聊消息类型事件
+
+
+## `PRIVATE_FRIEND`
+
+
+* **说明**: 匹配任意好友私聊消息类型事件
+
+
+## `PRIVATE_GROUP`
+
+
+* **说明**: 匹配任意群临时私聊消息类型事件
+
+
+## `PRIVATE_OTHER`
+
+
+* **说明**: 匹配任意其他私聊消息类型事件
+
+
+## `GROUP`
+
+
+* **说明**: 匹配任意群聊消息类型事件
+
+
+## `GROUP_MEMBER`
+
+
+* **说明**: 匹配任意群员群聊消息类型事件
+
+:::warning 警告
+该权限通过 event.sender 进行判断且不包含管理员以及群主！
+:::
+
+
+## `GROUP_ADMIN`
+
+
+* **说明**: 匹配任意群管理员群聊消息类型事件
+
+
+## `GROUP_OWNER`
+
+
+* **说明**: 匹配任意群主群聊消息类型事件
+
 # NoneBot.adapters.cqhttp.event 模块
+
+
+## _class_ `Event`
+
+基类：[`nonebot.adapters._base.Event`](README.md#nonebot.adapters._base.Event)
+
+CQHTTP 协议事件，字段与 CQHTTP 一致。各事件字段参考 [CQHTTP 文档](https://github.com/howmanybots/onebot/blob/master/README.md)
+
+
+## _class_ `MessageEvent`
+
+基类：`nonebot.adapters.cqhttp.event.Event`
+
+消息事件
+
+
+### `to_me`
+
+
+* **说明**
+
+    消息是否与机器人有关
+
+
+
+* **类型**
+
+    `bool`
+
+
+
+### `reply`
+
+
+* **说明**
+
+    消息中提取的回复消息，内容为 `get_msg` API 返回结果
+
+
+
+* **类型**
+
+    `Optional[Reply]`
+
+
+
+## _class_ `PrivateMessageEvent`
+
+基类：`nonebot.adapters.cqhttp.event.MessageEvent`
+
+私聊消息
+
+
+## _class_ `GroupMessageEvent`
+
+基类：`nonebot.adapters.cqhttp.event.MessageEvent`
+
+群消息
+
+
+## _class_ `NoticeEvent`
+
+基类：`nonebot.adapters.cqhttp.event.Event`
+
+通知事件
+
+
+## _class_ `GroupUploadNoticeEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NoticeEvent`
+
+群文件上传事件
+
+
+## _class_ `GroupAdminNoticeEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NoticeEvent`
+
+群管理员变动
+
+
+## _class_ `GroupDecreaseNoticeEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NoticeEvent`
+
+群成员减少事件
+
+
+## _class_ `GroupIncreaseNoticeEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NoticeEvent`
+
+群成员增加事件
+
+
+## _class_ `GroupBanNoticeEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NoticeEvent`
+
+群禁言事件
+
+
+## _class_ `FriendAddNoticeEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NoticeEvent`
+
+好友添加事件
+
+
+## _class_ `GroupRecallNoticeEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NoticeEvent`
+
+群消息撤回事件
+
+
+## _class_ `FriendRecallNoticeEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NoticeEvent`
+
+好友消息撤回事件
+
+
+## _class_ `NotifyEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NoticeEvent`
+
+提醒事件
+
+
+## _class_ `PokeNotifyEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NotifyEvent`
+
+戳一戳提醒事件
+
+
+## _class_ `LuckyKingNotifyEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NotifyEvent`
+
+群红包运气王提醒事件
+
+
+## _class_ `HonorNotifyEvent`
+
+基类：`nonebot.adapters.cqhttp.event.NotifyEvent`
+
+群荣誉变更提醒事件
+
+
+## _class_ `RequestEvent`
+
+基类：`nonebot.adapters.cqhttp.event.Event`
+
+请求事件
+
+
+## _class_ `FriendRequestEvent`
+
+基类：`nonebot.adapters.cqhttp.event.RequestEvent`
+
+加好友请求事件
+
+
+## _class_ `GroupRequestEvent`
+
+基类：`nonebot.adapters.cqhttp.event.RequestEvent`
+
+加群请求/邀请事件
+
+
+## _class_ `MetaEvent`
+
+基类：`nonebot.adapters.cqhttp.event.Event`
+
+元事件
+
+
+## _class_ `LifecycleMetaEvent`
+
+基类：`nonebot.adapters.cqhttp.event.MetaEvent`
+
+生命周期元事件
+
+
+## _class_ `HeartbeatMetaEvent`
+
+基类：`nonebot.adapters.cqhttp.event.MetaEvent`
+
+心跳元事件
+
+
+## `get_event_model(event_name)`
+
+
+* **说明**
+
+    根据事件名获取对应 `Event Model` 及 `FallBack Event Model` 列表
+
+
+
+* **返回**
+
+    
+    * `List[Type[Event]]`
diff --git a/docs/api/adapters/ding.md b/docs/api/adapters/ding.md
index 99ce3712..57410533 100644
--- a/docs/api/adapters/ding.md
+++ b/docs/api/adapters/ding.md
@@ -5,12 +5,330 @@ sidebarDepth: 0
 
 # NoneBot.adapters.ding 模块
 
+## 钉钉群机器人 协议适配
+
+协议详情请看: [钉钉文档](https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p)
+
 # NoneBot.adapters.ding.config 模块
 
+
+## _class_ `Config`
+
+钉钉配置类
+
+
+* **配置项**
+
+    
+    * `access_token` / `ding_access_token`: 钉钉令牌
+
+
+    * `secret` / `ding_secret`: 钉钉 HTTP 上报数据签名口令
+
+
 # NoneBot.adapters.ding.exception 模块
 
+
+## _exception_ `DingAdapterException`
+
+基类：[`nonebot.exception.AdapterException`](../exception.md#nonebot.exception.AdapterException)
+
+
+* **说明**
+
+    钉钉 Adapter 错误基类
+
+
+
+## _exception_ `ActionFailed`
+
+基类：[`nonebot.exception.ActionFailed`](../exception.md#nonebot.exception.ActionFailed), `nonebot.adapters.ding.exception.DingAdapterException`
+
+
+* **说明**
+
+    API 请求返回错误信息。
+
+
+
+* **参数**
+
+    
+    * `errcode: Optional[int]`: 错误码
+
+
+    * `errmsg: Optional[str]`: 错误信息
+
+
+
+## _exception_ `NetworkError`
+
+基类：[`nonebot.exception.NetworkError`](../exception.md#nonebot.exception.NetworkError), `nonebot.adapters.ding.exception.DingAdapterException`
+
+
+* **说明**
+
+    网络错误。
+
+
+
+* **参数**
+
+    
+    * `retcode: Optional[int]`: 错误码
+
+
+
+## _exception_ `SessionExpired`
+
+基类：`nonebot.adapters.ding.exception.ApiNotAvailable`, `nonebot.adapters.ding.exception.DingAdapterException`
+
+
+* **说明**
+
+    发消息的 session 已经过期。
+
+
 # NoneBot.adapters.ding.bot 模块
 
+
+## _class_ `Bot`
+
+基类：[`nonebot.adapters._base.Bot`](README.md#nonebot.adapters._base.Bot)
+
+钉钉 协议 Bot 适配。继承属性参考 [BaseBot](./#class-basebot) 。
+
+
+### _property_ `type`
+
+
+* 返回: `"ding"`
+
+
+### _async classmethod_ `check_permission(driver, request)`
+
+
+* **说明**
+
+    钉钉协议鉴权。参考 [鉴权](https://ding-doc.dingtalk.com/doc#/serverapi2/elzz1p)
+
+
+
+### _async_ `call_api(api, event=None, **data)`
+
+
+* **说明**
+
+    调用 钉钉 协议 API
+
+
+
+* **参数**
+
+    
+    * `api: str`: API 名称
+
+
+    * `event: Optional[MessageEvent]`: Event 对象
+
+
+    * `**data: Any`: API 参数
+
+
+
+* **返回**
+
+    
+    * `Any`: API 调用返回数据
+
+
+
+* **异常**
+
+    
+    * `NetworkError`: 网络错误
+
+
+    * `ActionFailed`: API 调用失败
+
+
+
+### _async_ `send(event, message, at_sender=False, webhook=None, secret=None, **kwargs)`
+
+
+* **说明**
+
+    根据 `event`  向触发事件的主体发送消息。
+
+
+
+* **参数**
+
+    
+    * `event: Event`: Event 对象
+
+
+    * `message: Union[str, Message, MessageSegment]`: 要发送的消息
+
+
+    * `at_sender: bool`: 是否 @ 事件主体
+
+
+    * `webhook: Optional[str]`: 该条消息将调用的 webhook 地址。不传则将使用 sessionWebhook，若其也不存在，该条消息不发送，使用自定义 webhook 时注意你设置的安全方式，如加关键词，IP地址，加签等等。
+
+
+    * `secret: Optional[str]`: 如果你使用自定义的 webhook 地址，推荐使用加签方式对消息进行验证，将 机器人安全设置页面，加签一栏下面显示的SEC开头的字符串 传入这个参数即可。
+
+
+    * `**kwargs`: 覆盖默认参数
+
+
+
+* **返回**
+
+    
+    * `Any`: API 调用返回数据
+
+
+
+* **异常**
+
+    
+    * `ValueError`: 缺少 `user_id`, `group_id`
+
+
+    * `NetworkError`: 网络错误
+
+
+    * `ActionFailed`: API 调用失败
+
+
 # NoneBot.adapters.ding.message 模块
 
+
+## _class_ `MessageSegment`
+
+基类：`abc.ABC`, `Mapping`
+
+钉钉 协议 MessageSegment 适配。具体方法参考协议消息段类型或源码。
+
+
+### _static_ `atAll()`
+
+@全体
+
+
+### _static_ `atMobiles(*mobileNumber)`
+
+@指定手机号人员
+
+
+### _static_ `atDingtalkIds(*dingtalkIds)`
+
+@指定 id，@ 默认会在消息段末尾。
+所以你可以在消息中使用 @{senderId} 占位，发送出去之后 @ 就会出现在占位的位置：
+``python
+message = MessageSegment.text(f"@{event.senderId}，你好")
+message += MessageSegment.atDingtalkIds(event.senderId)
+``
+
+
+### _static_ `text(text)`
+
+发送 `text` 类型消息
+
+
+### _static_ `image(picURL)`
+
+发送 `image` 类型消息
+
+
+### _static_ `extension(dict_)`
+
+"标记 text 文本的 extension 属性，需要与 text 消息段相加。
+
+
+### _static_ `code(code_language, code)`
+
+"发送 code 消息段
+
+
+### _static_ `markdown(title, text)`
+
+发送 `markdown` 类型消息
+
+
+### _static_ `actionCardSingleBtn(title, text, singleTitle, singleURL)`
+
+发送 `actionCardSingleBtn` 类型消息
+
+
+### _static_ `actionCardMultiBtns(title, text, btns, hideAvatar=False, btnOrientation='1')`
+
+发送 `actionCardMultiBtn` 类型消息
+
+
+* **参数**
+
+    
+    * `btnOrientation`: 0：按钮竖直排列 1：按钮横向排列
+
+
+    * `btns`: [{ "title": title, "actionURL": actionURL }, ...]
+
+
+
+### _static_ `feedCard(links)`
+
+发送 `feedCard` 类型消息
+
+
+* **参数**
+
+    
+    * `links`: [{ "title": xxx, "messageURL": xxx, "picURL": xxx }, ...]
+
+
+
+## _class_ `Message`
+
+基类：[`nonebot.adapters._base.Message`](README.md#nonebot.adapters._base.Message)[`nonebot.adapters.ding.message.MessageSegment`]
+
+钉钉 协议 Message 适配。
+
 # NoneBot.adapters.ding.event 模块
+
+
+## _class_ `Event`
+
+基类：[`nonebot.adapters._base.Event`](README.md#nonebot.adapters._base.Event)
+
+钉钉协议事件。各事件字段参考 [钉钉文档](https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p)
+
+
+## _class_ `ConversationType`
+
+基类：`str`, `enum.Enum`
+
+An enumeration.
+
+
+## _class_ `MessageEvent`
+
+基类：`nonebot.adapters.ding.event.Event`
+
+消息事件
+
+
+## _class_ `PrivateMessageEvent`
+
+基类：`nonebot.adapters.ding.event.MessageEvent`
+
+私聊消息事件
+
+
+## _class_ `GroupMessageEvent`
+
+基类：`nonebot.adapters.ding.event.MessageEvent`
+
+群消息事件
diff --git a/docs/api/adapters/mirai.md b/docs/api/adapters/mirai.md
index eaf54a4a..7804c06e 100644
--- a/docs/api/adapters/mirai.md
+++ b/docs/api/adapters/mirai.md
@@ -5,24 +5,1918 @@ sidebarDepth: 0
 
 # NoneBot.adapters.mirai 模块
 
+## Mirai-API-HTTP 协议适配
+
+协议详情请看: [mirai-api-http 文档](https://github.com/project-mirai/mirai-api-http/tree/master/docs)
+
+::: tip
+该Adapter目前仍然处在早期实验性阶段, 并未经过充分测试
+
+如果你在使用过程中遇到了任何问题, 请前往 [Issue页面](https://github.com/nonebot/nonebot2/issues) 为我们提供反馈
+:::
+
+::: danger
+Mirai-API-HTTP 的适配器以 [AGPLv3许可](https://opensource.org/licenses/AGPL-3.0) 单独开源
+
+这意味着在使用该适配器时需要 **以该许可开源您的完整程序代码**
+:::
+
 # NoneBot.adapters.mirai.config 模块
 
+
+## _class_ `Config`
+
+Mirai 配置类
+
+
+* **必填**
+
+    
+    * `auth_key` / `mirai_auth_key`: mirai-api-http 的 auth_key
+
+
+    * `mirai_host`: mirai-api-http 的地址
+
+
+    * `mirai_port`: mirai-api-http 的端口
+
+
 # NoneBot.adapters.mirai.bot 模块
 
+
+## _class_ `SessionManager`
+
+基类：`object`
+
+Bot会话管理器, 提供API主动调用接口
+
+
+### _async_ `post(path, *, params=None)`
+
+
+* **说明**
+
+    以POST方式主动提交API请求
+
+
+
+* **参数**
+
+    
+    * `path: str`: 对应API路径
+
+
+    * `params: Optional[Dict[str, Any]]`: 请求参数 (无需sessionKey)
+
+
+
+* **返回**
+
+    
+    * `Dict[str, Any]`: API 返回值
+
+
+
+### _async_ `request(path, *, params=None)`
+
+
+* **说明**
+
+    以GET方式主动提交API请求
+
+
+
+* **参数**
+
+    
+    * `path: str`: 对应API路径
+
+
+    * `params: Optional[Dict[str, Any]]`: 请求参数 (无需sessionKey)
+
+
+
+### _async_ `upload(path, *, params)`
+
+
+* **说明**
+
+    以表单(`multipart/form-data`)形式主动提交API请求
+
+
+
+* **参数**
+
+    
+    * `path: str`: 对应API路径
+
+
+    * `params: Dict[str, Any]`: 请求参数 (无需sessionKey)
+
+
+
+## _class_ `Bot`
+
+基类：[`nonebot.adapters._base.Bot`](README.md#nonebot.adapters._base.Bot)
+
+mirai-api-http 协议 Bot 适配。
+
+::: warning
+API中为了使代码更加整洁, 我们采用了与PEP8相符的命名规则取代Mirai原有的驼峰命名
+
+部分字段可能与文档在符号上不一致
+:::
+
+
+### _property_ `api`
+
+返回该Bot对象的会话管理实例以提供API主动调用
+
+
+### _async_ `call_api(api, **data)`
+
+::: danger
+由于Mirai的HTTP API特殊性, 该API暂时无法实现
+:::
+
+::: tip
+你可以使用 `MiraiBot.api` 中提供的调用方法来代替
+:::
+
+
+### `send(event, message, at_sender=False)`
+
+
+* **说明**
+
+    根据 `event` 向触发事件的主体发送信息
+
+
+
+* **参数**
+
+    
+    * `event: Event`: Event对象
+
+
+    * `message: Union[MessageChain, MessageSegment, str]`: 要发送的消息
+
+
+    * `at_sender: bool`: 是否 @ 事件主体
+
+
+
+### `send_friend_message(target, message_chain)`
+
+
+* **说明**
+
+    使用此方法向指定好友发送消息
+
+
+
+* **参数**
+
+    
+    * `target: int`: 发送消息目标好友的 QQ 号
+
+
+    * `message_chain: MessageChain`: 消息链，是一个消息对象构成的数组
+
+
+
+### `send_temp_message(qq, group, message_chain)`
+
+
+* **说明**
+
+    使用此方法向临时会话对象发送消息
+
+
+
+* **参数**
+
+    
+    * `qq: int`: 临时会话对象 QQ 号
+
+
+    * `group: int`: 临时会话群号
+
+
+    * `message_chain: MessageChain`: 消息链，是一个消息对象构成的数组
+
+
+
+### `send_group_message(group, message_chain, quote=None)`
+
+
+* **说明**
+
+    使用此方法向指定群发送消息
+
+
+
+* **参数**
+
+    
+    * `group: int`: 发送消息目标群的群号
+
+
+    * `message_chain: MessageChain`: 消息链，是一个消息对象构成的数组
+
+
+    * `quote: Optional[int]`: 引用一条消息的 message_id 进行回复
+
+
+
+### `recall(target)`
+
+
+* **说明**
+
+    使用此方法撤回指定消息。对于bot发送的消息，有2分钟时间限制。对于撤回群聊中群员的消息，需要有相应权限
+
+
+
+* **参数**
+
+    
+    * `target: int`: 需要撤回的消息的message_id
+
+
+
+### `send_image_message(target, qq, group, urls)`
+
+
+* **说明**
+
+    使用此方法向指定对象（群或好友）发送图片消息
+    除非需要通过此手段获取image_id，否则不推荐使用该接口
+
+    > 当qq和group同时存在时，表示发送临时会话图片，qq为临时会话对象QQ号，group为临时会话发起的群号
+
+
+
+* **参数**
+
+    
+    * `target: int`: 发送对象的QQ号或群号，可能存在歧义
+
+
+    * `qq: int`: 发送对象的QQ号
+
+
+    * `group: int`: 发送对象的群号
+
+
+    * `urls: List[str]`: 是一个url字符串构成的数组
+
+
+
+* **返回**
+
+    
+    * `List[str]`: 一个包含图片imageId的数组
+
+
+
+### `upload_image(type, img)`
+
+
+* **说明**
+
+    使用此方法上传图片文件至服务器并返回Image_id
+
+
+
+* **参数**
+
+    
+    * `type: str`: "friend" 或 "group" 或 "temp"
+
+
+    * `img: BytesIO`: 图片的BytesIO对象
+
+
+
+### `upload_voice(type, voice)`
+
+
+* **说明**
+
+    使用此方法上传语音文件至服务器并返回voice_id
+
+
+
+* **参数**
+
+    
+    * `type: str`: 当前仅支持 "group"
+
+
+    * `voice: BytesIO`: 语音的BytesIO对象
+
+
+
+### `fetch_message(count=10)`
+
+
+* **说明**
+
+    使用此方法获取bot接收到的最老消息和最老各类事件
+    (会从MiraiApiHttp消息记录中删除)
+
+
+
+* **参数**
+
+    
+    * `count: int`: 获取消息和事件的数量
+
+
+
+### `fetch_latest_message(count=10)`
+
+
+* **说明**
+
+    使用此方法获取bot接收到的最新消息和最新各类事件
+    (会从MiraiApiHttp消息记录中删除)
+
+
+
+* **参数**
+
+    
+    * `count: int`: 获取消息和事件的数量
+
+
+
+### `peek_message(count=10)`
+
+
+* **说明**
+
+    使用此方法获取bot接收到的最老消息和最老各类事件
+    (不会从MiraiApiHttp消息记录中删除)
+
+
+
+* **参数**
+
+    
+    * `count: int`: 获取消息和事件的数量
+
+
+
+### `peek_latest_message(count=10)`
+
+
+* **说明**
+
+    使用此方法获取bot接收到的最新消息和最新各类事件
+    (不会从MiraiApiHttp消息记录中删除)
+
+
+
+* **参数**
+
+    
+    * `count: int`: 获取消息和事件的数量
+
+
+
+### `messsage_from_id(id)`
+
+
+* **说明**
+
+    通过messageId获取一条被缓存的消息
+    使用此方法获取bot接收到的消息和各类事件
+
+
+
+* **参数**
+
+    
+    * `id: int`: 获取消息的message_id
+
+
+
+### `count_message()`
+
+
+* **说明**
+
+    使用此方法获取bot接收并缓存的消息总数，注意不包含被删除的
+
+
+
+### `friend_list()`
+
+
+* **说明**
+
+    使用此方法获取bot的好友列表
+
+
+
+* **返回**
+
+    
+    * `List[Dict[str, Any]]`: 返回的好友列表数据
+
+
+
+### `group_list()`
+
+
+* **说明**
+
+    使用此方法获取bot的群列表
+
+
+
+* **返回**
+
+    
+    * `List[Dict[str, Any]]`: 返回的群列表数据
+
+
+
+### `member_list(target)`
+
+
+* **说明**
+
+    使用此方法获取bot指定群种的成员列表
+
+
+
+* **参数**
+
+    
+    * `target: int`: 指定群的群号
+
+
+
+* **返回**
+
+    
+    * `List[Dict[str, Any]]`: 返回的群成员列表数据
+
+
+
+### `mute(target, member_id, time)`
+
+
+* **说明**
+
+    使用此方法指定群禁言指定群员（需要有相关权限）
+
+
+
+* **参数**
+
+    
+    * `target: int`: 指定群的群号
+
+
+    * `member_id: int`: 指定群员QQ号
+
+
+    * `time: int`: 禁言时长，单位为秒，最多30天
+
+
+
+### `unmute(target, member_id)`
+
+
+* **说明**
+
+    使用此方法指定群解除群成员禁言（需要有相关权限）
+
+
+
+* **参数**
+
+    
+    * `target: int`: 指定群的群号
+
+
+    * `member_id: int`: 指定群员QQ号
+
+
+
+### `kick(target, member_id, msg)`
+
+
+* **说明**
+
+    使用此方法移除指定群成员（需要有相关权限）
+
+
+
+* **参数**
+
+    
+    * `target: int`: 指定群的群号
+
+
+    * `member_id: int`: 指定群员QQ号
+
+
+    * `msg: str`: 信息
+
+
+
+### `quit(target)`
+
+
+* **说明**
+
+    使用此方法使Bot退出群聊
+
+
+
+* **参数**
+
+    
+    * `target: int`: 退出的群号
+
+
+
+### `mute_all(target)`
+
+
+* **说明**
+
+    使用此方法令指定群进行全体禁言（需要有相关权限）
+
+
+
+* **参数**
+
+    
+    * `target: int`: 指定群的群号
+
+
+
+### `unmute_all(target)`
+
+
+* **说明**
+
+    使用此方法令指定群解除全体禁言（需要有相关权限）
+
+
+
+* **参数**
+
+    
+    * `target: int`: 指定群的群号
+
+
+
+### `group_config(target)`
+
+
+* **说明**
+
+    使用此方法获取群设置
+
+
+
+* **参数**
+
+    
+    * `target: int`: 指定群的群号
+
+
+
+* **返回**
+
+
+```json
+{
+    "name": "群名称",
+    "announcement": "群公告",
+    "confessTalk": true,
+    "allowMemberInvite": true,
+    "autoApprove": true,
+    "anonymousChat": true
+}
+```
+
+
+### `modify_group_config(target, config)`
+
+
+* **说明**
+
+    使用此方法修改群设置（需要有相关权限）
+
+
+
+* **参数**
+
+    
+    * `target: int`: 指定群的群号
+
+
+    * `config: Dict[str, Any]`: 群设置, 格式见 `group_config` 的返回值
+
+
+
+### `member_info(target, member_id)`
+
+
+* **说明**
+
+    使用此方法获取群员资料
+
+
+
+* **参数**
+
+    
+    * `target: int`: 指定群的群号
+
+
+    * `member_id: int`: 群员QQ号
+
+
+
+* **返回**
+
+
+```json
+{
+    "name": "群名片",
+    "specialTitle": "群头衔"
+}
+```
+
+
+### `modify_member_info(target, member_id, info)`
+
+
+* **说明**
+
+    使用此方法修改群员资料（需要有相关权限）
+
+
+
+* **参数**
+
+    
+    * `target: int`: 指定群的群号
+
+
+    * `member_id: int`: 群员QQ号
+
+
+    * `info: Dict[str, Any]`: 群员资料, 格式见 `member_info` 的返回值
+
+
 # NoneBot.adapters.mirai.bot_ws 模块
 
+
+## _class_ `WebSocket`
+
+基类：[`nonebot.drivers.WebSocket`](../drivers/README.md#nonebot.drivers.WebSocket)
+
+
+## _class_ `WebsocketBot`
+
+基类：`nonebot.adapters.mirai.bot.Bot`
+
+mirai-api-http 正向 Websocket 协议 Bot 适配。
+
+
+### _classmethod_ `register(driver, config, qq)`
+
+
+* **说明**
+
+    注册该Adapter
+
+
+
+* **参数**
+
+    
+    * `driver: Driver`: 程序所使用的\`\`Driver\`\`
+
+
+    * `config: Config`: 程序配置对象
+
+
+    * `qq: int`: 要使用的Bot的QQ号 **注意: 在使用正向Websocket时必须指定该值!**
+
+
 # NoneBot.adapters.mirai.message 模块
 
+
+## _class_ `MessageType`
+
+基类：`str`, `enum.Enum`
+
+消息类型枚举类
+
+
+## _class_ `MessageSegment`
+
+基类：`abc.ABC`, `Mapping`
+
+Mirai-API-HTTP 协议 MessageSegment 适配。具体方法参考 [mirai-api-http 消息类型](https://github.com/project-mirai/mirai-api-http/blob/master/docs/MessageType.md)
+
+
+### `as_dict()`
+
+导出可以被正常json序列化的结构体
+
+
+### _classmethod_ `quote(id, group_id, sender_id, target_id, origin)`
+
+
+* **说明**
+
+    生成回复引用消息段
+
+
+
+* **参数**
+
+    
+    * `id: int`: 被引用回复的原消息的message_id
+
+
+    * `group_id: int`: 被引用回复的原消息所接收的群号，当为好友消息时为0
+
+
+    * `sender_id: int`: 被引用回复的原消息的发送者的QQ号
+
+
+    * `target_id: int`: 被引用回复的原消息的接收者者的QQ号（或群号）
+
+
+    * `origin: MessageChain`: 被引用回复的原消息的消息链对象
+
+
+
+### _classmethod_ `at(target)`
+
+
+* **说明**
+
+    @某个人
+
+
+
+* **参数**
+
+    
+    * `target: int`: 群员QQ号
+
+
+
+### _classmethod_ `at_all()`
+
+
+* **说明**
+
+    @全体成员
+
+
+
+### _classmethod_ `face(face_id=None, name=None)`
+
+
+* **说明**
+
+    发送QQ表情
+
+
+
+* **参数**
+
+    
+    * `face_id: Optional[int]`: QQ表情编号，可选，优先高于name
+
+
+    * `name: Optional[str]`: QQ表情拼音，可选
+
+
+
+### _classmethod_ `plain(text)`
+
+
+* **说明**
+
+    纯文本消息
+
+
+
+* **参数**
+
+    
+    * `text: str`: 文字消息
+
+
+
+### _classmethod_ `image(image_id=None, url=None, path=None)`
+
+
+* **说明**
+
+    图片消息
+
+
+
+* **参数**
+
+    
+    * `image_id: Optional[str]`: 图片的image_id，群图片与好友图片格式不同。不为空时将忽略url属性
+
+
+    * `url: Optional[str]`: 图片的URL，发送时可作网络图片的链接
+
+
+    * `path: Optional[str]`: 图片的路径，发送本地图片
+
+
+
+### _classmethod_ `flash_image(image_id=None, url=None, path=None)`
+
+
+* **说明**
+
+    闪照消息
+
+
+
+* **参数**
+
+    同 `image`
+
+
+
+### _classmethod_ `voice(voice_id=None, url=None, path=None)`
+
+
+* **说明**
+
+    语音消息
+
+
+
+* **参数**
+
+    
+    * `voice_id: Optional[str]`: 语音的voice_id，不为空时将忽略url属性
+
+
+    * `url: Optional[str]`: 语音的URL，发送时可作网络语音的链接
+
+
+    * `path: Optional[str]`: 语音的路径，发送本地语音
+
+
+
+### _classmethod_ `xml(xml)`
+
+
+* **说明**
+
+    XML消息
+
+
+
+* **参数**
+
+    
+    * `xml: str`: XML文本
+
+
+
+### _classmethod_ `json(json)`
+
+
+* **说明**
+
+    Json消息
+
+
+
+* **参数**
+
+    
+    * `json: str`: Json文本
+
+
+
+### _classmethod_ `app(content)`
+
+
+* **说明**
+
+    应用程序消息
+
+
+
+* **参数**
+
+    
+    * `content: str`: 内容
+
+
+
+### _classmethod_ `poke(name)`
+
+
+* **说明**
+
+    戳一戳消息
+
+
+
+* **参数**
+
+    
+    * `name: str`: 戳一戳的类型
+
+
+        * `Poke`: 戳一戳
+
+
+        * `ShowLove`: 比心
+
+
+        * `Like`: 点赞
+
+
+        * `Heartbroken`: 心碎
+
+
+        * `SixSixSix`: 666
+
+
+        * `FangDaZhao`: 放大招
+
+
+
+## _class_ `MessageChain`
+
+基类：[`nonebot.adapters._base.Message`](README.md#nonebot.adapters._base.Message)[`nonebot.adapters.mirai.message.MessageSegment`]
+
+Mirai 协议 Message 适配
+
+由于Mirai协议的Message实现较为特殊, 故使用MessageChain命名
+
+
+### `reduce()`
+
+
+* **说明**
+
+    忽略为空的消息段, 合并相邻的纯文本消息段
+
+
+
+### `export()`
+
+导出为可以被正常json序列化的数组
+
+
+### `extract_first(*type)`
+
+
+* **说明**
+
+    弹出该消息链的第一个消息
+
+
+
+* **参数**
+
+    
+    * \*type: MessageType: 指定的消息类型, 当指定后如类型不匹配不弹出
+
+
 # NoneBot.adapters.mirai.utils 模块
 
+
+## _exception_ `ActionFailed`
+
+基类：[`nonebot.exception.ActionFailed`](../exception.md#nonebot.exception.ActionFailed)
+
+
+* **说明**
+
+    API 请求成功返回数据，但 API 操作失败。
+
+
+
+## _exception_ `InvalidArgument`
+
+基类：[`nonebot.exception.AdapterException`](../exception.md#nonebot.exception.AdapterException)
+
+
+* **说明**
+
+    调用API的参数出错
+
+
+
+## `catch_network_error(function)`
+
+
+* **说明**
+
+    捕捉函数抛出的httpx网络异常并释放 `NetworkError` 异常
+
+    处理返回数据, 在code不为0时释放 `ActionFailed` 异常
+
+
+::: warning
+此装饰器只支持使用了httpx的异步函数
+:::
+
+
+## `argument_validation(function)`
+
+
+* **说明**
+
+    通过函数签名中的类型注解来对传入参数进行运行时校验
+
+    会在参数出错时释放 `InvalidArgument` 异常
+
+
 # NoneBot.adapters.mirai.event 模块
 
+::: warning 
+事件中为了使代码更加整洁, 我们采用了与PEP8相符的命名规则取代Mirai原有的驼峰命名
+
+部分字段可能与文档在符号上不一致
+:::
+
+
+## _class_ `Event`
+
+基类：[`nonebot.adapters._base.Event`](README.md#nonebot.adapters._base.Event)
+
+mirai-api-http 协议事件，字段与 mirai-api-http 一致。各事件字段参考 [mirai-api-http 事件类型](https://github.com/project-mirai/mirai-api-http/blob/master/docs/EventType.md)
+
+
+### _classmethod_ `new(data)`
+
+此事件类的工厂函数, 能够通过事件数据选择合适的子类进行序列化
+
+
+### `normalize_dict(**kwargs)`
+
+返回可以被json正常反序列化的结构体
+
+
+## _class_ `UserPermission`
+
+基类：`str`, `enum.Enum`
+
+
+* **说明**
+
+
+用户权限枚举类
+
+> 
+> * `OWNER`: 群主
+
+
+> * `ADMINISTRATOR`: 群管理
+
+
+> * `MEMBER`: 普通群成员
+
+
+## _class_ `MessageEvent`
+
+基类：`nonebot.adapters.mirai.event.base.Event`
+
+消息事件基类
+
+
+## _class_ `GroupMessage`
+
+基类：`nonebot.adapters.mirai.event.message.MessageEvent`
+
+群消息事件
+
+
+## _class_ `FriendMessage`
+
+基类：`nonebot.adapters.mirai.event.message.MessageEvent`
+
+好友消息事件
+
+
+## _class_ `TempMessage`
+
+基类：`nonebot.adapters.mirai.event.message.MessageEvent`
+
+临时会话消息事件
+
+
+## _class_ `NoticeEvent`
+
+基类：`nonebot.adapters.mirai.event.base.Event`
+
+通知事件基类
+
+
+## _class_ `MuteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+禁言类事件基类
+
+
+## _class_ `BotMuteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MuteEvent`
+
+Bot被禁言
+
+
+## _class_ `BotUnmuteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MuteEvent`
+
+Bot被取消禁言
+
+
+## _class_ `MemberMuteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MuteEvent`
+
+群成员被禁言事件（该成员不是Bot）
+
+
+## _class_ `MemberUnmuteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MuteEvent`
+
+群成员被取消禁言事件（该成员不是Bot）
+
+
+## _class_ `BotJoinGroupEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+Bot加入了一个新群
+
+
+## _class_ `BotLeaveEventActive`
+
+基类：`nonebot.adapters.mirai.event.notice.BotJoinGroupEvent`
+
+Bot主动退出一个群
+
+
+## _class_ `BotLeaveEventKick`
+
+基类：`nonebot.adapters.mirai.event.notice.BotJoinGroupEvent`
+
+Bot被踢出一个群
+
+
+## _class_ `MemberJoinEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+新人入群的事件
+
+
+## _class_ `MemberLeaveEventKick`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberJoinEvent`
+
+成员被踢出群（该成员不是Bot）
+
+
+## _class_ `MemberLeaveEventQuit`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberJoinEvent`
+
+成员主动离群（该成员不是Bot）
+
+
+## _class_ `FriendRecallEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+好友消息撤回
+
+
+## _class_ `GroupRecallEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.FriendRecallEvent`
+
+群消息撤回
+
+
+## _class_ `GroupStateChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+群变化事件基类
+
+
+## _class_ `GroupNameChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+某个群名改变
+
+
+## _class_ `GroupEntranceAnnouncementChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+某群入群公告改变
+
+
+## _class_ `GroupMuteAllEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+全员禁言
+
+
+## _class_ `GroupAllowAnonymousChatEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+匿名聊天
+
+
+## _class_ `GroupAllowConfessTalkEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+坦白说
+
+
+## _class_ `GroupAllowMemberInviteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+允许群员邀请好友加群
+
+
+## _class_ `MemberStateChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+群成员变化事件基类
+
+
+## _class_ `MemberCardChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberStateChangeEvent`
+
+群名片改动
+
+
+## _class_ `MemberSpecialTitleChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberStateChangeEvent`
+
+群头衔改动（只有群主有操作限权）
+
+
+## _class_ `BotGroupPermissionChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberStateChangeEvent`
+
+Bot在群里的权限被改变
+
+
+## _class_ `MemberPermissionChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberStateChangeEvent`
+
+成员权限改变的事件（该成员不是Bot）
+
+
+## _class_ `RequestEvent`
+
+基类：`nonebot.adapters.mirai.event.base.Event`
+
+请求事件基类
+
+
+## _class_ `NewFriendRequestEvent`
+
+基类：`nonebot.adapters.mirai.event.request.RequestEvent`
+
+添加好友申请
+
+
+### _async_ `approve(bot)`
+
+
+* **说明**
+
+    通过此人的好友申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+
+### _async_ `reject(bot, operate=1, message='')`
+
+
+* **说明**
+
+    拒绝此人的好友申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+    * `operate: Literal[1, 2]`: 响应的操作类型
+
+
+        * `1`: 拒绝添加好友
+
+
+        * `2`: 拒绝添加好友并添加黑名单，不再接收该用户的好友申请
+
+
+    * `message: str`: 回复的信息
+
+
+
+## _class_ `MemberJoinRequestEvent`
+
+基类：`nonebot.adapters.mirai.event.request.RequestEvent`
+
+用户入群申请（Bot需要有管理员权限）
+
+
+### _async_ `approve(bot)`
+
+
+* **说明**
+
+    通过此人的加群申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+
+### _async_ `reject(bot, operate=1, message='')`
+
+
+* **说明**
+
+    拒绝(忽略)此人的加群申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+    * `operate: Literal[1, 2, 3, 4]`: 响应的操作类型
+
+
+        * `1`: 拒绝入群
+
+
+        * `2`: 忽略请求
+
+
+        * `3`: 拒绝入群并添加黑名单，不再接收该用户的入群申请
+
+
+        * `4`: 忽略入群并添加黑名单，不再接收该用户的入群申请
+
+
+    * `message: str`: 回复的信息
+
+
+
+## _class_ `BotInvitedJoinGroupRequestEvent`
+
+基类：`nonebot.adapters.mirai.event.request.RequestEvent`
+
+Bot被邀请入群申请
+
+
+### _async_ `approve(bot)`
+
+
+* **说明**
+
+    通过这份被邀请入群申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+
+### _async_ `reject(bot, message='')`
+
+
+* **说明**
+
+    拒绝这份被邀请入群申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+    * `message: str`: 邀请消息
+
+
 # NoneBot.adapters.mirai.event.base 模块
 
+
+## _class_ `UserPermission`
+
+基类：`str`, `enum.Enum`
+
+
+* **说明**
+
+
+用户权限枚举类
+
+> 
+> * `OWNER`: 群主
+
+
+> * `ADMINISTRATOR`: 群管理
+
+
+> * `MEMBER`: 普通群成员
+
+
+## _class_ `Event`
+
+基类：[`nonebot.adapters._base.Event`](README.md#nonebot.adapters._base.Event)
+
+mirai-api-http 协议事件，字段与 mirai-api-http 一致。各事件字段参考 [mirai-api-http 事件类型](https://github.com/project-mirai/mirai-api-http/blob/master/docs/EventType.md)
+
+
+### _classmethod_ `new(data)`
+
+此事件类的工厂函数, 能够通过事件数据选择合适的子类进行序列化
+
+
+### `normalize_dict(**kwargs)`
+
+返回可以被json正常反序列化的结构体
+
 # NoneBot.adapters.mirai.event.meta 模块
 
+
+## _class_ `MetaEvent`
+
+基类：`nonebot.adapters.mirai.event.base.Event`
+
+元事件基类
+
+
+## _class_ `BotOnlineEvent`
+
+基类：`nonebot.adapters.mirai.event.meta.MetaEvent`
+
+Bot登录成功
+
+
+## _class_ `BotOfflineEventActive`
+
+基类：`nonebot.adapters.mirai.event.meta.MetaEvent`
+
+Bot主动离线
+
+
+## _class_ `BotOfflineEventForce`
+
+基类：`nonebot.adapters.mirai.event.meta.MetaEvent`
+
+Bot被挤下线
+
+
+## _class_ `BotOfflineEventDropped`
+
+基类：`nonebot.adapters.mirai.event.meta.MetaEvent`
+
+Bot被服务器断开或因网络问题而掉线
+
+
+## _class_ `BotReloginEvent`
+
+基类：`nonebot.adapters.mirai.event.meta.MetaEvent`
+
+Bot主动重新登录
+
 # NoneBot.adapters.mirai.event.message 模块
 
+
+## _class_ `MessageEvent`
+
+基类：`nonebot.adapters.mirai.event.base.Event`
+
+消息事件基类
+
+
+## _class_ `GroupMessage`
+
+基类：`nonebot.adapters.mirai.event.message.MessageEvent`
+
+群消息事件
+
+
+## _class_ `FriendMessage`
+
+基类：`nonebot.adapters.mirai.event.message.MessageEvent`
+
+好友消息事件
+
+
+## _class_ `TempMessage`
+
+基类：`nonebot.adapters.mirai.event.message.MessageEvent`
+
+临时会话消息事件
+
 # NoneBot.adapters.mirai.event.notice 模块
 
+
+## _class_ `NoticeEvent`
+
+基类：`nonebot.adapters.mirai.event.base.Event`
+
+通知事件基类
+
+
+## _class_ `MuteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+禁言类事件基类
+
+
+## _class_ `BotMuteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MuteEvent`
+
+Bot被禁言
+
+
+## _class_ `BotUnmuteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MuteEvent`
+
+Bot被取消禁言
+
+
+## _class_ `MemberMuteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MuteEvent`
+
+群成员被禁言事件（该成员不是Bot）
+
+
+## _class_ `MemberUnmuteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MuteEvent`
+
+群成员被取消禁言事件（该成员不是Bot）
+
+
+## _class_ `BotJoinGroupEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+Bot加入了一个新群
+
+
+## _class_ `BotLeaveEventActive`
+
+基类：`nonebot.adapters.mirai.event.notice.BotJoinGroupEvent`
+
+Bot主动退出一个群
+
+
+## _class_ `BotLeaveEventKick`
+
+基类：`nonebot.adapters.mirai.event.notice.BotJoinGroupEvent`
+
+Bot被踢出一个群
+
+
+## _class_ `MemberJoinEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+新人入群的事件
+
+
+## _class_ `MemberLeaveEventKick`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberJoinEvent`
+
+成员被踢出群（该成员不是Bot）
+
+
+## _class_ `MemberLeaveEventQuit`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberJoinEvent`
+
+成员主动离群（该成员不是Bot）
+
+
+## _class_ `FriendRecallEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+好友消息撤回
+
+
+## _class_ `GroupRecallEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.FriendRecallEvent`
+
+群消息撤回
+
+
+## _class_ `GroupStateChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+群变化事件基类
+
+
+## _class_ `GroupNameChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+某个群名改变
+
+
+## _class_ `GroupEntranceAnnouncementChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+某群入群公告改变
+
+
+## _class_ `GroupMuteAllEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+全员禁言
+
+
+## _class_ `GroupAllowAnonymousChatEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+匿名聊天
+
+
+## _class_ `GroupAllowConfessTalkEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+坦白说
+
+
+## _class_ `GroupAllowMemberInviteEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.GroupStateChangeEvent`
+
+允许群员邀请好友加群
+
+
+## _class_ `MemberStateChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.NoticeEvent`
+
+群成员变化事件基类
+
+
+## _class_ `MemberCardChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberStateChangeEvent`
+
+群名片改动
+
+
+## _class_ `MemberSpecialTitleChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberStateChangeEvent`
+
+群头衔改动（只有群主有操作限权）
+
+
+## _class_ `BotGroupPermissionChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberStateChangeEvent`
+
+Bot在群里的权限被改变
+
+
+## _class_ `MemberPermissionChangeEvent`
+
+基类：`nonebot.adapters.mirai.event.notice.MemberStateChangeEvent`
+
+成员权限改变的事件（该成员不是Bot）
+
 # NoneBot.adapters.mirai.event.request 模块
+
+
+## _class_ `RequestEvent`
+
+基类：`nonebot.adapters.mirai.event.base.Event`
+
+请求事件基类
+
+
+## _class_ `NewFriendRequestEvent`
+
+基类：`nonebot.adapters.mirai.event.request.RequestEvent`
+
+添加好友申请
+
+
+### _async_ `approve(bot)`
+
+
+* **说明**
+
+    通过此人的好友申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+
+### _async_ `reject(bot, operate=1, message='')`
+
+
+* **说明**
+
+    拒绝此人的好友申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+    * `operate: Literal[1, 2]`: 响应的操作类型
+
+
+        * `1`: 拒绝添加好友
+
+
+        * `2`: 拒绝添加好友并添加黑名单，不再接收该用户的好友申请
+
+
+    * `message: str`: 回复的信息
+
+
+
+## _class_ `MemberJoinRequestEvent`
+
+基类：`nonebot.adapters.mirai.event.request.RequestEvent`
+
+用户入群申请（Bot需要有管理员权限）
+
+
+### _async_ `approve(bot)`
+
+
+* **说明**
+
+    通过此人的加群申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+
+### _async_ `reject(bot, operate=1, message='')`
+
+
+* **说明**
+
+    拒绝(忽略)此人的加群申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+    * `operate: Literal[1, 2, 3, 4]`: 响应的操作类型
+
+
+        * `1`: 拒绝入群
+
+
+        * `2`: 忽略请求
+
+
+        * `3`: 拒绝入群并添加黑名单，不再接收该用户的入群申请
+
+
+        * `4`: 忽略入群并添加黑名单，不再接收该用户的入群申请
+
+
+    * `message: str`: 回复的信息
+
+
+
+## _class_ `BotInvitedJoinGroupRequestEvent`
+
+基类：`nonebot.adapters.mirai.event.request.RequestEvent`
+
+Bot被邀请入群申请
+
+
+### _async_ `approve(bot)`
+
+
+* **说明**
+
+    通过这份被邀请入群申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+
+### _async_ `reject(bot, message='')`
+
+
+* **说明**
+
+    拒绝这份被邀请入群申请
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: 当前的 `Bot` 对象
+
+
+    * `message: str`: 邀请消息
diff --git a/docs/api/drivers/README.md b/docs/api/drivers/README.md
index d9590d2b..903c5d13 100644
--- a/docs/api/drivers/README.md
+++ b/docs/api/drivers/README.md
@@ -4,3 +4,425 @@ sidebarDepth: 0
 ---
 
 # NoneBot.drivers 模块
+
+## 后端驱动适配基类
+
+各驱动请继承以下基类
+
+
+## _class_ `Driver`
+
+基类：`abc.ABC`
+
+Driver 基类。
+
+
+### `_adapters`
+
+
+* **类型**
+
+    `Dict[str, Type[Bot]]`
+
+
+
+* **说明**
+
+    已注册的适配器列表
+
+
+
+### `_bot_connection_hook`
+
+
+* **类型**
+
+    `Set[T_BotConnectionHook]`
+
+
+
+* **说明**
+
+    Bot 连接建立时执行的函数
+
+
+
+### `_bot_disconnection_hook`
+
+
+* **类型**
+
+    `Set[T_BotDisconnectionHook]`
+
+
+
+* **说明**
+
+    Bot 连接断开时执行的函数
+
+
+
+### _abstract_ `__init__(env, config)`
+
+
+* **参数**
+
+    
+    * `env: Env`: 包含环境信息的 Env 对象
+
+
+    * `config: Config`: 包含配置信息的 Config 对象
+
+
+
+### `env`
+
+
+* **类型**
+
+    `str`
+
+
+
+* **说明**
+
+    环境名称
+
+
+
+### `config`
+
+
+* **类型**
+
+    `Config`
+
+
+
+* **说明**
+
+    配置对象
+
+
+
+### `_clients`
+
+
+* **类型**
+
+    `Dict[str, Bot]`
+
+
+
+* **说明**
+
+    已连接的 Bot
+
+
+
+### _property_ `bots`
+
+
+* **类型**
+
+    `Dict[str, Bot]`
+
+
+
+* **说明**
+
+    获取当前所有已连接的 Bot
+
+
+
+### `register_adapter(name, adapter, **kwargs)`
+
+
+* **说明**
+
+    注册一个协议适配器
+
+
+
+* **参数**
+
+    
+    * `name: str`: 适配器名称，用于在连接时进行识别
+
+
+    * `adapter: Type[Bot]`: 适配器 Class
+
+
+
+### _abstract property_ `type`
+
+驱动类型名称
+
+
+### _abstract property_ `logger`
+
+驱动专属 logger 日志记录器
+
+
+### _abstract_ `run(host=None, port=None, *args, **kwargs)`
+
+
+* **说明**
+
+    启动驱动框架
+
+
+
+* **参数**
+
+    
+    * `host: Optional[str]`: 驱动绑定 IP
+
+
+    * `post: Optional[int]`: 驱动绑定端口
+
+
+    * `*args`
+
+
+    * `**kwargs`
+
+
+
+### _abstract_ `on_startup(func)`
+
+注册一个在驱动启动时运行的函数
+
+
+### _abstract_ `on_shutdown(func)`
+
+注册一个在驱动停止时运行的函数
+
+
+### `on_bot_connect(func)`
+
+
+* **说明**
+
+    装饰一个函数使他在 bot 通过 WebSocket 连接成功时执行。
+
+
+
+* **函数参数**
+
+    
+    * `bot: Bot`: 当前连接上的 Bot 对象
+
+
+
+### `on_bot_disconnect(func)`
+
+
+* **说明**
+
+    装饰一个函数使他在 bot 通过 WebSocket 连接断开时执行。
+
+
+
+* **函数参数**
+
+    
+    * `bot: Bot`: 当前连接上的 Bot 对象
+
+
+
+### `_bot_connect(bot)`
+
+在 WebSocket 连接成功后，调用该函数来注册 bot 对象
+
+
+### `_bot_disconnect(bot)`
+
+在 WebSocket 连接断开后，调用该函数来注销 bot 对象
+
+
+## _class_ `ReverseDriver`
+
+基类：`nonebot.drivers.Driver`
+
+Reverse Driver 基类。将后端框架封装，以满足适配器使用。
+
+
+### _abstract property_ `server_app`
+
+驱动 APP 对象
+
+
+### _abstract property_ `asgi`
+
+驱动 ASGI 对象
+
+
+### _abstract async_ `_handle_http(*args, **kwargs)`
+
+用于处理 HTTP 类型请求的函数
+
+
+### _abstract async_ `_handle_ws_reverse(*args, **kwargs)`
+
+用于处理 WebSocket 类型请求的函数
+
+
+## _class_ `HTTPConnection`
+
+基类：`abc.ABC`
+
+
+### `http_version`
+
+One of "1.0", "1.1" or "2".
+
+
+### `scheme`
+
+URL scheme portion (likely "http" or "https").
+
+
+### `path`
+
+HTTP request target excluding any query string,
+with percent-encoded sequences and UTF-8 byte sequences
+decoded into characters.
+
+
+### `query_string`
+
+URL portion after the ?, percent-encoded.
+
+
+### `headers`
+
+A dict of name-value pairs,
+where name is the header name, and value is the header value.
+
+Order of header values must be preserved from the original HTTP request;
+order of header names is not important.
+
+Header names must be lowercased.
+
+
+### _abstract property_ `type`
+
+Connection type.
+
+
+## _class_ `HTTPRequest`
+
+基类：`nonebot.drivers.HTTPConnection`
+
+HTTP 请求封装。参考 [asgi http scope](https://asgi.readthedocs.io/en/latest/specs/www.html#http-connection-scope)。
+
+
+### `method`
+
+The HTTP method name, uppercased.
+
+
+### `body`
+
+Body of the request.
+
+Optional; if missing defaults to b"".
+
+
+### _property_ `type`
+
+Always `http`
+
+
+## _class_ `HTTPResponse`
+
+基类：`object`
+
+HTTP 响应封装。参考 [asgi http scope](https://asgi.readthedocs.io/en/latest/specs/www.html#http-connection-scope)。
+
+
+### `status`
+
+HTTP status code.
+
+
+### `body`
+
+HTTP body content.
+
+Optional; if missing defaults to `None`.
+
+
+### `headers`
+
+A dict of name-value pairs,
+where name is the header name, and value is the header value.
+
+Order must be preserved in the HTTP response.
+
+Header names must be lowercased.
+
+Optional; if missing defaults to an empty dict.
+
+
+### _property_ `type`
+
+Always `http`
+
+
+## _class_ `WebSocket`
+
+基类：`nonebot.drivers.HTTPConnection`, `abc.ABC`
+
+WebSocket 连接封装。参考 [asgi websocket scope](https://asgi.readthedocs.io/en/latest/specs/www.html#websocket-connection-scope)。
+
+
+### _property_ `type`
+
+Always `websocket`
+
+
+### _abstract property_ `closed`
+
+
+* **类型**
+
+    `bool`
+
+
+
+* **说明**
+
+    连接是否已经关闭
+
+
+
+### _abstract async_ `accept()`
+
+接受 WebSocket 连接请求
+
+
+### _abstract async_ `close(code)`
+
+关闭 WebSocket 连接请求
+
+
+### _abstract async_ `receive()`
+
+接收一条 WebSocket text 信息
+
+
+### _abstract async_ `receive_bytes()`
+
+接收一条 WebSocket binary 信息
+
+
+### _abstract async_ `send(data)`
+
+发送一条 WebSocket text 信息
+
+
+### _abstract async_ `send_bytes(data)`
+
+发送一条 WebSocket text 信息
diff --git a/docs/api/drivers/fastapi.md b/docs/api/drivers/fastapi.md
index 747d3580..005f37b2 100644
--- a/docs/api/drivers/fastapi.md
+++ b/docs/api/drivers/fastapi.md
@@ -4,3 +4,137 @@ sidebarDepth: 0
 ---
 
 # NoneBot.drivers.fastapi 模块
+
+## FastAPI 驱动适配
+
+后端使用方法请参考: [FastAPI 文档](https://fastapi.tiangolo.com/)
+
+
+## _class_ `Config`
+
+基类：`pydantic.env_settings.BaseSettings`
+
+FastAPI 驱动框架设置，详情参考 FastAPI 文档
+
+
+### `fastapi_openapi_url`
+
+
+* **类型**
+
+    `Optional[str]`
+
+
+
+* **说明**
+
+    `openapi.json` 地址，默认为 `None` 即关闭
+
+
+
+### `fastapi_docs_url`
+
+
+* **类型**
+
+    `Optional[str]`
+
+
+
+* **说明**
+
+    `swagger` 地址，默认为 `None` 即关闭
+
+
+
+### `fastapi_redoc_url`
+
+
+* **类型**
+
+    `Optional[str]`
+
+
+
+* **说明**
+
+    `redoc` 地址，默认为 `None` 即关闭
+
+
+
+### `fastapi_reload_dirs`
+
+
+* **类型**
+
+    `List[str]`
+
+
+
+* **说明**
+
+    `debug` 模式下重载监控文件夹列表，默认为 uvicorn 默认值
+
+
+
+## _class_ `Driver`
+
+基类：[`nonebot.drivers.ReverseDriver`](README.md#nonebot.drivers.ReverseDriver)
+
+FastAPI 驱动框架
+
+
+* **上报地址**
+
+    
+    * `/{adapter name}/`: HTTP POST 上报
+
+
+    * `/{adapter name}/http/`: HTTP POST 上报
+
+
+    * `/{adapter name}/ws`: WebSocket 上报
+
+
+    * `/{adapter name}/ws/`: WebSocket 上报
+
+
+
+### _property_ `type`
+
+驱动名称: `fastapi`
+
+
+### _property_ `server_app`
+
+`FastAPI APP` 对象
+
+
+### _property_ `asgi`
+
+`FastAPI APP` 对象
+
+
+### _property_ `logger`
+
+fastapi 使用的 logger
+
+
+### `on_startup(func)`
+
+参考文档: [Events](https://fastapi.tiangolo.com/advanced/events/#startup-event)
+
+
+### `on_shutdown(func)`
+
+参考文档: [Events](https://fastapi.tiangolo.com/advanced/events/#startup-event)
+
+
+### `run(host=None, port=None, *, app=None, **kwargs)`
+
+使用 `uvicorn` 启动 FastAPI
+
+
+## _class_ `WebSocket`
+
+基类：[`nonebot.drivers.WebSocket`](README.md#nonebot.drivers.WebSocket)
diff --git a/docs/api/drivers/quart.md b/docs/api/drivers/quart.md
index 222a4bb0..35fbc26f 100644
--- a/docs/api/drivers/quart.md
+++ b/docs/api/drivers/quart.md
@@ -4,3 +4,81 @@ sidebarDepth: 0
 ---
 
 # NoneBot.drivers.quart 模块
+
+## Quart 驱动适配
+
+后端使用方法请参考: [Quart 文档](https://pgjones.gitlab.io/quart/index.html)
+
+
+## _class_ `Config`
+
+基类：`pydantic.env_settings.BaseSettings`
+
+Quart 驱动框架设置
+
+
+### `quart_reload_dirs`
+
+
+* **类型**
+
+    `List[str]`
+
+
+
+* **说明**
+
+    `debug` 模式下重载监控文件夹列表，默认为 uvicorn 默认值
+
+
+
+## _class_ `Driver`
+
+基类：[`nonebot.drivers.ReverseDriver`](README.md#nonebot.drivers.ReverseDriver)
+
+Quart 驱动框架
+
+
+* **上报地址**
+
+    
+    * `/{adapter name}/http`: HTTP POST 上报
+
+
+    * `/{adapter name}/ws`: WebSocket 上报
+
+
+
+### _property_ `type`
+
+驱动名称: `quart`
+
+
+### _property_ `server_app`
+
+`Quart` 对象
+
+
+### _property_ `asgi`
+
+`Quart` 对象
+
+
+### _property_ `logger`
+
+Quart 使用的 logger
+
+
+### `on_startup(func)`
+
+参考文档: [Startup and Shutdown](https://pgjones.gitlab.io/quart/how_to_guides/startup_shutdown.html)
+
+
+### `on_shutdown(func)`
+
+参考文档: [Startup and Shutdown](https://pgjones.gitlab.io/quart/how_to_guides/startup_shutdown.html)
+
+
+### `run(host=None, port=None, *, app=None, **kwargs)`
+
+使用 `uvicorn` 启动 Quart
diff --git a/docs/api/exception.md b/docs/api/exception.md
index 4838c52d..f48a493b 100644
--- a/docs/api/exception.md
+++ b/docs/api/exception.md
@@ -4,3 +4,190 @@ sidebarDepth: 0
 ---
 
 # NoneBot.exception 模块
+
+## 异常
+
+下列文档中的异常是所有 NoneBot 运行时可能会抛出的。
+这些异常并非所有需要用户处理，在 NoneBot 内部运行时被捕获，并进行对应操作。
+
+
+## _exception_ `NoneBotException`
+
+基类：`Exception`
+
+
+* **说明**
+
+    所有 NoneBot 发生的异常基类。
+
+
+
+## _exception_ `IgnoredException`
+
+基类：`nonebot.exception.NoneBotException`
+
+
+* **说明**
+
+    指示 NoneBot 应该忽略该事件。可由 PreProcessor 抛出。
+
+
+
+* **参数**
+
+    
+    * `reason`: 忽略事件的原因
+
+
+
+## _exception_ `ParserExit`
+
+基类：`nonebot.exception.NoneBotException`
+
+
+* **说明**
+
+    `shell command` 处理消息失败时返回的异常
+
+
+
+* **参数**
+
+    
+    * `status`
+
+
+    * `message`
+
+
+
+## _exception_ `PausedException`
+
+基类：`nonebot.exception.NoneBotException`
+
+
+* **说明**
+
+    指示 NoneBot 结束当前 `Handler` 并等待下一条消息后继续下一个 `Handler`。
+    可用于用户输入新信息。
+
+
+
+* **用法**
+
+    可以在 `Handler` 中通过 `Matcher.pause()` 抛出。
+
+
+
+## _exception_ `RejectedException`
+
+基类：`nonebot.exception.NoneBotException`
+
+
+* **说明**
+
+    指示 NoneBot 结束当前 `Handler` 并等待下一条消息后重新运行当前 `Handler`。
+    可用于用户重新输入。
+
+
+
+* **用法**
+
+    可以在 `Handler` 中通过 `Matcher.reject()` 抛出。
+
+
+
+## _exception_ `FinishedException`
+
+基类：`nonebot.exception.NoneBotException`
+
+
+* **说明**
+
+    指示 NoneBot 结束当前 `Handler` 且后续 `Handler` 不再被运行。
+    可用于结束用户会话。
+
+
+
+* **用法**
+
+    可以在 `Handler` 中通过 `Matcher.finish()` 抛出。
+
+
+
+## _exception_ `StopPropagation`
+
+基类：`nonebot.exception.NoneBotException`
+
+
+* **说明**
+
+    指示 NoneBot 终止事件向下层传播。
+
+
+
+* **用法**
+
+    在 `Matcher.block == True` 时抛出。
+
+
+
+## _exception_ `AdapterException`
+
+基类：`nonebot.exception.NoneBotException`
+
+
+* **说明**
+
+    代表 `Adapter` 抛出的异常，所有的 `Adapter` 都要在内部继承自这个 `Exception`
+
+
+
+* **参数**
+
+    
+    * `adapter_name: str`: 标识 adapter
+
+
+
+## _exception_ `NoLogException`
+
+基类：`Exception`
+
+
+* **说明**
+
+    指示 NoneBot 对当前 `Event` 进行处理但不显示 Log 信息，可在 `get_log_string` 时抛出
+
+
+
+## _exception_ `ApiNotAvailable`
+
+基类：`nonebot.exception.AdapterException`
+
+
+* **说明**
+
+    在 API 连接不可用时抛出。
+
+
+
+## _exception_ `NetworkError`
+
+基类：`nonebot.exception.AdapterException`
+
+
+* **说明**
+
+    在网络出现问题时抛出，如: API 请求地址不正确, API 请求无返回或返回状态非正常等。
+
+
+
+## _exception_ `ActionFailed`
+
+基类：`nonebot.exception.AdapterException`
+
+
+* **说明**
+
+    API 请求成功返回数据，但 API 操作失败。
diff --git a/docs/api/handler.md b/docs/api/handler.md
index b68aa96f..dc2ab74f 100644
--- a/docs/api/handler.md
+++ b/docs/api/handler.md
@@ -4,3 +4,108 @@ sidebarDepth: 0
 ---
 
 # NoneBot.handler 模块
+
+## 事件处理函数
+
+该模块实现事件处理函数的封装，以实现动态参数等功能。
+
+
+## _class_ `Handler`
+
+基类：`object`
+
+事件处理函数类
+
+
+### `__init__(func)`
+
+装饰事件处理函数以便根据动态参数运行
+
+
+### `func`
+
+
+* **类型**
+
+    `T_Handler`
+
+
+
+* **说明**
+
+    事件处理函数
+
+
+
+### `signature`
+
+
+* **类型**
+
+    `inspect.Signature`
+
+
+
+* **说明**
+
+    事件处理函数签名
+
+
+
+### _property_ `bot_type`
+
+
+* **类型**
+
+    `Union[Type["Bot"], inspect.Parameter.empty]`
+
+
+
+* **说明**
+
+    事件处理函数接受的 Bot 对象类型
+
+
+
+### _property_ `event_type`
+
+
+* **类型**
+
+    `Optional[Union[Type[Event], inspect.Parameter.empty]]`
+
+
+
+* **说明**
+
+    事件处理函数接受的 event 类型 / 不需要 event 参数
+
+
+
+### _property_ `state_type`
+
+
+* **类型**
+
+    `Optional[Union[T_State, inspect.Parameter.empty]]`
+
+
+
+* **说明**
+
+    事件处理函数是否接受 state 参数
+
+
+
+### _property_ `matcher_type`
+
+
+* **类型**
+
+    `Optional[Union[Type["Matcher"], inspect.Parameter.empty]]`
+
+
+
+* **说明**
+
+    事件处理函数是否接受 matcher 参数
diff --git a/docs/api/matcher.md b/docs/api/matcher.md
index cdcf108f..28e4cbe4 100644
--- a/docs/api/matcher.md
+++ b/docs/api/matcher.md
@@ -4,3 +4,583 @@ sidebarDepth: 0
 ---
 
 # NoneBot.matcher 模块
+
+## 事件响应器
+
+该模块实现事件响应器的创建与运行，并提供一些快捷方法来帮助用户更好的与机器人进行对话 。
+
+
+## `matchers`
+
+
+* **类型**
+
+    `Dict[int, List[Type[Matcher]]]`
+
+
+
+* **说明**
+
+    用于存储当前所有的事件响应器
+
+
+
+## _class_ `Matcher`
+
+基类：`object`
+
+事件响应器类
+
+
+### `module`
+
+
+* **类型**
+
+    `Optional[ModuleType]`
+
+
+
+* **说明**
+
+    事件响应器所在模块
+
+
+
+### `plugin_name`
+
+
+* **类型**
+
+    `Optional[str]`
+
+
+
+* **说明**
+
+    事件响应器所在插件名
+
+
+
+### `module_name`
+
+
+* **类型**
+
+    `Optional[str]`
+
+
+
+* **说明**
+
+    事件响应器所在模块名
+
+
+
+### `module_prefix`
+
+
+* **类型**
+
+    `Optional[str]`
+
+
+
+* **说明**
+
+    事件响应器所在模块前缀
+
+
+
+### `type`
+
+
+* **类型**
+
+    `str`
+
+
+
+* **说明**
+
+    事件响应器类型
+
+
+
+### `rule`
+
+
+* **类型**
+
+    `Rule`
+
+
+
+* **说明**
+
+    事件响应器匹配规则
+
+
+
+### `permission`
+
+
+* **类型**
+
+    `Permission`
+
+
+
+* **说明**
+
+    事件响应器触发权限
+
+
+
+### `priority`
+
+
+* **类型**
+
+    `int`
+
+
+
+* **说明**
+
+    事件响应器优先级
+
+
+
+### `block`
+
+
+* **类型**
+
+    `bool`
+
+
+
+* **说明**
+
+    事件响应器是否阻止事件传播
+
+
+
+### `temp`
+
+
+* **类型**
+
+    `bool`
+
+
+
+* **说明**
+
+    事件响应器是否为临时
+
+
+
+### `expire_time`
+
+
+* **类型**
+
+    `Optional[datetime]`
+
+
+
+* **说明**
+
+    事件响应器过期时间点
+
+
+
+### `_default_state`
+
+
+* **类型**
+
+    `T_State`
+
+
+
+* **说明**
+
+    事件响应器默认状态
+
+
+
+### `_default_state_factory`
+
+
+* **类型**
+
+    `Optional[T_State]`
+
+
+
+* **说明**
+
+    事件响应器默认工厂函数
+
+
+
+### `_default_parser`
+
+
+* **类型**
+
+    `Optional[T_ArgsParser]`
+
+
+
+* **说明**
+
+    事件响应器默认参数解析函数
+
+
+
+### `_default_type_updater`
+
+
+* **类型**
+
+    `Optional[T_TypeUpdater]`
+
+
+
+* **说明**
+
+    事件响应器类型更新函数
+
+
+
+### `_default_permission_updater`
+
+
+* **类型**
+
+    `Optional[T_PermissionUpdater]`
+
+
+
+* **说明**
+
+    事件响应器权限更新函数
+
+
+
+### `__init__()`
+
+实例化 Matcher 以便运行
+
+
+### `handlers`
+
+
+* **类型**
+
+    `List[Handler]`
+
+
+
+* **说明**
+
+    事件响应器拥有的事件处理函数列表
+
+
+
+### _classmethod_ `new(type_='', rule=None, permission=None, handlers=None, temp=False, priority=1, block=False, *, module=None, expire_time=None, default_state=None, default_state_factory=None, default_parser=None, default_type_updater=None, default_permission_updater=None)`
+
+
+* **说明**
+
+    创建一个新的事件响应器，并存储至 [matchers](#matchers)
+
+
+
+* **参数**
+
+    
+    * `type_: str`: 事件响应器类型，与 `event.get_type()` 一致时触发，空字符串表示任意
+
+
+    * `rule: Optional[Rule]`: 匹配规则
+
+
+    * `permission: Optional[Permission]`: 权限
+
+
+    * `handlers: Optional[List[T_Handler]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器，即触发一次后删除
+
+
+    * `priority: int`: 响应优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级的响应器传播
+
+
+    * `module: Optional[str]`: 事件响应器所在模块名称
+
+
+    * `default_state: Optional[T_State]`: 默认状态 `state`
+
+
+    * `default_state_factory: Optional[T_StateFactory]`: 默认状态 `state` 的工厂函数
+
+
+    * `expire_time: Optional[datetime]`: 事件响应器最终有效时间点，过时即被删除
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`: 新的事件响应器类
+
+
+
+### _async classmethod_ `check_perm(bot, event)`
+
+
+* **说明**
+
+    检查是否满足触发权限
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: 上报事件
+
+
+
+* **返回**
+
+    
+    * `bool`: 是否满足权限
+
+
+
+### _async classmethod_ `check_rule(bot, event, state)`
+
+
+* **说明**
+
+    检查是否满足匹配规则
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: 上报事件
+
+
+    * `state: T_State`: 当前状态
+
+
+
+* **返回**
+
+    
+    * `bool`: 是否满足匹配规则
+
+
+
+### _classmethod_ `args_parser(func)`
+
+
+* **说明**
+
+    装饰一个函数来更改当前事件响应器的默认参数解析函数
+
+
+
+* **参数**
+
+    
+    * `func: T_ArgsParser`: 参数解析函数
+
+
+
+### _classmethod_ `type_updater(func)`
+
+
+* **说明**
+
+    装饰一个函数来更改当前事件响应器的默认响应事件类型更新函数
+
+
+
+* **参数**
+
+    
+    * `func: T_TypeUpdater`: 响应事件类型更新函数
+
+
+
+### _classmethod_ `permission_updater(func)`
+
+
+* **说明**
+
+    装饰一个函数来更改当前事件响应器的默认会话权限更新函数
+
+
+
+* **参数**
+
+    
+    * `func: T_PermissionUpdater`: 会话权限更新函数
+
+
+
+### _classmethod_ `handle()`
+
+
+* **说明**
+
+    装饰一个函数来向事件响应器直接添加一个处理函数
+
+
+
+* **参数**
+
+    
+    * 无
+
+
+
+### _classmethod_ `receive()`
+
+
+* **说明**
+
+    装饰一个函数来指示 NoneBot 在接收用户新的一条消息后继续运行该函数
+
+
+
+* **参数**
+
+    
+    * 无
+
+
+
+### _classmethod_ `got(key, prompt=None, args_parser=None)`
+
+
+* **说明**
+
+    装饰一个函数来指示 NoneBot 当要获取的 `key` 不存在时接收用户新的一条消息并经过 `ArgsParser` 处理后再运行该函数，如果 `key` 已存在则直接继续运行
+
+
+
+* **参数**
+
+    
+    * `key: str`: 参数名
+
+
+    * `prompt: Optional[Union[str, Message, MessageSegment]]`: 在参数不存在时向用户发送的消息
+
+
+    * `args_parser: Optional[T_ArgsParser]`: 可选参数解析函数，空则使用默认解析函数
+
+
+
+### _async classmethod_ `send(message, **kwargs)`
+
+
+* **说明**
+
+    发送一条消息给当前交互用户
+
+
+
+* **参数**
+
+    
+    * `message: Union[str, Message, MessageSegment]`: 消息内容
+
+
+    * `**kwargs`: 其他传递给 `bot.send` 的参数，请参考对应 adapter 的 bot 对象 api
+
+
+
+### _async classmethod_ `finish(message=None, **kwargs)`
+
+
+* **说明**
+
+    发送一条消息给当前交互用户并结束当前事件响应器
+
+
+
+* **参数**
+
+    
+    * `message: Union[str, Message, MessageSegment]`: 消息内容
+
+
+    * `**kwargs`: 其他传递给 `bot.send` 的参数，请参考对应 adapter 的 bot 对象 api
+
+
+
+### _async classmethod_ `pause(prompt=None, **kwargs)`
+
+
+* **说明**
+
+    发送一条消息给当前交互用户并暂停事件响应器，在接收用户新的一条消息后继续下一个处理函数
+
+
+
+* **参数**
+
+    
+    * `prompt: Union[str, Message, MessageSegment]`: 消息内容
+
+
+    * `**kwargs`: 其他传递给 `bot.send` 的参数，请参考对应 adapter 的 bot 对象 api
+
+
+
+### _async classmethod_ `reject(prompt=None, **kwargs)`
+
+
+* **说明**
+
+    发送一条消息给当前交互用户并暂停事件响应器，在接收用户新的一条消息后重新运行当前处理函数
+
+
+
+* **参数**
+
+    
+    * `prompt: Union[str, Message, MessageSegment]`: 消息内容
+
+
+    * `**kwargs`: 其他传递给 `bot.send` 的参数，请参考对应 adapter 的 bot 对象 api
+
+
+
+### `stop_propagation()`
+
+
+* **说明**
+
+    阻止事件传播
diff --git a/docs/api/message.md b/docs/api/message.md
index e0e7bad0..5bd6c332 100644
--- a/docs/api/message.md
+++ b/docs/api/message.md
@@ -4,3 +4,140 @@ sidebarDepth: 0
 ---
 
 # NoneBot.message 模块
+
+## 事件处理
+
+NoneBot 内部处理并按优先级分发事件给所有事件响应器，提供了多个插槽以进行事件的预处理等。
+
+
+## `event_preprocessor(func)`
+
+
+* **说明**
+
+    事件预处理。装饰一个函数，使它在每次接收到事件并分发给各响应器之前执行。
+
+
+
+* **参数**
+
+    事件预处理函数接收三个参数。
+
+
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: Event 对象
+
+
+    * `state: T_State`: 当前 State
+
+
+
+## `event_postprocessor(func)`
+
+
+* **说明**
+
+    事件后处理。装饰一个函数，使它在每次接收到事件并分发给各响应器之后执行。
+
+
+
+* **参数**
+
+    事件后处理函数接收三个参数。
+
+
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: Event 对象
+
+
+    * `state: T_State`: 当前事件运行前 State
+
+
+
+## `run_preprocessor(func)`
+
+
+* **说明**
+
+    运行预处理。装饰一个函数，使它在每次事件响应器运行前执行。
+
+
+
+* **参数**
+
+    运行预处理函数接收四个参数。
+
+
+    * `matcher: Matcher`: 当前要运行的事件响应器
+
+
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: Event 对象
+
+
+    * `state: T_State`: 当前 State
+
+
+
+## `run_postprocessor(func)`
+
+
+* **说明**
+
+    运行后处理。装饰一个函数，使它在每次事件响应器运行后执行。
+
+
+
+* **参数**
+
+    运行后处理函数接收五个参数。
+
+
+    * `matcher: Matcher`: 运行完毕的事件响应器
+
+
+    * `exception: Optional[Exception]`: 事件响应器运行错误（如果存在）
+
+
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: Event 对象
+
+
+    * `state: T_State`: 当前 State
+
+
+
+## _async_ `handle_event(bot, event)`
+
+
+* **说明**
+
+    处理一个事件。调用该函数以实现分发事件。
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: Event 对象
+
+
+
+* **示例**
+
+
+```python
+import asyncio
+asyncio.create_task(handle_event(bot, event))
+```
diff --git a/docs/api/nonebot.md b/docs/api/nonebot.md
index a8b76044..6ecd5e9d 100644
--- a/docs/api/nonebot.md
+++ b/docs/api/nonebot.md
@@ -4,3 +4,275 @@ sidebarDepth: 0
 ---
 
 # NoneBot 模块
+
+## 快捷导入
+
+为方便使用，`nonebot` 模块从子模块导入了部分内容
+
+
+* `on_message` => `nonebot.plugin.on_message`
+
+
+* `on_notice` => `nonebot.plugin.on_notice`
+
+
+* `on_request` => `nonebot.plugin.on_request`
+
+
+* `on_metaevent` => `nonebot.plugin.on_metaevent`
+
+
+* `on_startswith` => `nonebot.plugin.on_startswith`
+
+
+* `on_endswith` => `nonebot.plugin.on_endswith`
+
+
+* `on_keyword` => `nonebot.plugin.on_keyword`
+
+
+* `on_command` => `nonebot.plugin.on_command`
+
+
+* `on_shell_command` => `nonebot.plugin.on_shell_command`
+
+
+* `on_regex` => `nonebot.plugin.on_regex`
+
+
+* `CommandGroup` => `nonebot.plugin.CommandGroup`
+
+
+* `Matchergroup` => `nonebot.plugin.MatcherGroup`
+
+
+* `load_plugin` => `nonebot.plugin.load_plugin`
+
+
+* `load_plugins` => `nonebot.plugin.load_plugins`
+
+
+* `load_all_plugins` => `nonebot.plugin.load_all_plugins`
+
+
+* `load_from_json` => `nonebot.plugin.load_from_json`
+
+
+* `load_from_toml` => `nonebot.plugin.load_from_toml`
+
+
+* `load_builtin_plugins` => `nonebot.plugin.load_builtin_plugins`
+
+
+* `get_plugin` => `nonebot.plugin.get_plugin`
+
+
+* `get_loaded_plugins` => `nonebot.plugin.get_loaded_plugins`
+
+
+* `export` => `nonebot.plugin.export`
+
+
+* `require` => `nonebot.plugin.require`
+
+
+## `get_driver()`
+
+
+* **说明**
+
+    获取全局 Driver 对象。可用于在计划任务的回调中获取当前 Driver 对象。
+
+
+
+* **返回**
+
+    
+    * `Driver`: 全局 Driver 对象
+
+
+
+* **异常**
+
+    
+    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
+
+
+
+* **用法**
+
+
+```python
+driver = nonebot.get_driver()
+```
+
+
+## `get_app()`
+
+
+* **说明**
+
+    获取全局 Driver 对应 Server App 对象。
+
+
+
+* **返回**
+
+    
+    * `Any`: Server App 对象
+
+
+
+* **异常**
+
+    
+    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
+
+
+
+* **用法**
+
+
+```python
+app = nonebot.get_app()
+```
+
+
+## `get_asgi()`
+
+
+* **说明**
+
+    获取全局 Driver 对应 Asgi 对象。
+
+
+
+* **返回**
+
+    
+    * `Any`: Asgi 对象
+
+
+
+* **异常**
+
+    
+    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
+
+
+
+* **用法**
+
+
+```python
+asgi = nonebot.get_asgi()
+```
+
+
+## `get_bots()`
+
+
+* **说明**
+
+    获取所有通过 ws 连接 NoneBot 的 Bot 对象。
+
+
+
+* **返回**
+
+    
+    * `Dict[str, Bot]`: 一个以字符串 ID 为键，Bot 对象为值的字典
+
+
+
+* **异常**
+
+    
+    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
+
+
+
+* **用法**
+
+
+```python
+bots = nonebot.get_bots()
+```
+
+
+## `init(*, _env_file=None, **kwargs)`
+
+
+* **说明**
+
+    初始化 NoneBot 以及 全局 Driver 对象。
+
+    NoneBot 将会从 .env 文件中读取环境信息，并使用相应的 env 文件配置。
+
+    你也可以传入自定义的 _env_file 来指定 NoneBot 从该文件读取配置。
+
+
+
+* **参数**
+
+    
+    * `_env_file: Optional[str]`: 配置文件名，默认从 .env.{env_name} 中读取配置
+
+
+    * `**kwargs`: 任意变量，将会存储到 Config 对象里
+
+
+
+* **返回**
+
+    
+    * `None`
+
+
+
+* **用法**
+
+
+```python
+nonebot.init(database=Database(...))
+```
+
+
+## `run(host=None, port=None, *args, **kwargs)`
+
+
+* **说明**
+
+    启动 NoneBot，即运行全局 Driver 对象。
+
+
+
+* **参数**
+
+    
+    * `host: Optional[str]`: 主机名／IP，若不传入则使用配置文件中指定的值
+
+
+    * `port: Optional[int]`: 端口，若不传入则使用配置文件中指定的值
+
+
+    * `*args`: 传入 Driver.run 的位置参数
+
+
+    * `**kwargs`: 传入 Driver.run 的命名参数
+
+
+
+* **返回**
+
+    
+    * `None`
+
+
+
+* **用法**
+
+
+```python
+nonebot.run(host="127.0.0.1", port=8080)
+```
diff --git a/docs/api/permission.md b/docs/api/permission.md
index e2ef8488..e99b7e8b 100644
--- a/docs/api/permission.md
+++ b/docs/api/permission.md
@@ -4,3 +4,134 @@ sidebarDepth: 0
 ---
 
 # NoneBot.permission 模块
+
+## 权限
+
+每个 `Matcher` 拥有一个 `Permission` ，其中是 **异步** `PermissionChecker` 的集合，只要有一个 `PermissionChecker` 检查结果为 `True` 时就会继续运行。
+
+:::tip 提示
+`PermissionChecker` 既可以是 async function 也可以是 sync function
+:::
+
+
+## _class_ `Permission`
+
+基类：`object`
+
+
+* **说明**
+
+    `Matcher` 规则类，当事件传递时，在 `Matcher` 运行前进行检查。
+
+
+
+* **示例**
+
+
+```python
+Permission(async_function) | sync_function
+# 等价于
+from nonebot.utils import run_sync
+Permission(async_function, run_sync(sync_function))
+```
+
+
+### `__init__(*checkers)`
+
+
+* **参数**
+
+    
+    * `*checkers: Callable[[Bot, Event], Awaitable[bool]]`: **异步** PermissionChecker
+
+
+
+### `checkers`
+
+
+* **说明**
+
+    存储 `PermissionChecker`
+
+
+
+* **类型**
+
+    
+    * `Set[Callable[[Bot, Event], Awaitable[bool]]]`
+
+
+
+### _async_ `__call__(bot, event)`
+
+
+* **说明**
+
+    检查是否满足某个权限
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: Event 对象
+
+
+
+* **返回**
+
+    
+    * `bool`
+
+
+
+## `MESSAGE`
+
+
+* **说明**: 匹配任意 `message` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 message type 的 Matcher。
+
+
+## `NOTICE`
+
+
+* **说明**: 匹配任意 `notice` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 notice type 的 Matcher。
+
+
+## `REQUEST`
+
+
+* **说明**: 匹配任意 `request` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 request type 的 Matcher。
+
+
+## `METAEVENT`
+
+
+* **说明**: 匹配任意 `meta_event` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 meta_event type 的 Matcher。
+
+
+## `USER(*user, perm=None)`
+
+
+* **说明**
+
+    `event` 的 `session_id` 在白名单内且满足 perm
+
+
+
+* **参数**
+
+    
+    * `*user: str`: 白名单
+
+
+    * `perm: Optional[Permission]`: 需要同时满足的权限
+
+
+
+## `SUPERUSER`
+
+
+* **说明**: 匹配任意超级用户消息类型事件
diff --git a/docs/api/plugin.md b/docs/api/plugin.md
index d23b7087..c51c93b2 100644
--- a/docs/api/plugin.md
+++ b/docs/api/plugin.md
@@ -4,3 +4,1489 @@ sidebarDepth: 0
 ---
 
 # NoneBot.plugin 模块
+
+## 插件
+
+为 NoneBot 插件开发提供便携的定义函数。
+
+
+## `plugins`
+
+
+* **类型**
+
+    `Dict[str, Plugin]`
+
+
+
+* **说明**
+
+    已加载的插件
+
+
+
+## _class_ `Plugin`
+
+基类：`object`
+
+存储插件信息
+
+
+### `name`
+
+
+* **类型**: `str`
+
+
+* **说明**: 插件名称，使用 文件/文件夹 名称作为插件名
+
+
+### `module`
+
+
+* **类型**: `ModuleType`
+
+
+* **说明**: 插件模块对象
+
+
+### _property_ `export`
+
+
+* **类型**: `Export`
+
+
+* **说明**: 插件内定义的导出内容
+
+
+### _property_ `matcher`
+
+
+* **类型**: `Set[Type[Matcher]]`
+
+
+* **说明**: 插件内定义的 `Matcher`
+
+
+## `on(type='', rule=None, permission=None, *, handlers=None, temp=False, priority=1, block=False, state=None, state_factory=None)`
+
+
+* **说明**
+
+    注册一个基础事件响应器，可自定义类型。
+
+
+
+* **参数**
+
+    
+    * `type: str`: 事件响应器类型
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## `on_metaevent(rule=None, *, handlers=None, temp=False, priority=1, block=False, state=None, state_factory=None)`
+
+
+* **说明**
+
+    注册一个元事件响应器。
+
+
+
+* **参数**
+
+    
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## `on_message(rule=None, permission=None, *, handlers=None, temp=False, priority=1, block=True, state=None, state_factory=None)`
+
+
+* **说明**
+
+    注册一个消息事件响应器。
+
+
+
+* **参数**
+
+    
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## `on_notice(rule=None, *, handlers=None, temp=False, priority=1, block=False, state=None, state_factory=None)`
+
+
+* **说明**
+
+    注册一个通知事件响应器。
+
+
+
+* **参数**
+
+    
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## `on_request(rule=None, *, handlers=None, temp=False, priority=1, block=False, state=None, state_factory=None)`
+
+
+* **说明**
+
+    注册一个请求事件响应器。
+
+
+
+* **参数**
+
+    
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## `on_startswith(msg, rule=None, ignorecase=False, **kwargs)`
+
+
+* **说明**
+
+    注册一个消息事件响应器，并且当消息的\*\*文本部分\*\*以指定内容开头时响应。
+
+
+
+* **参数**
+
+    
+    * `msg: Union[str, Tuple[str, ...]]`: 指定消息开头内容
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `ignorecase: bool`: 是否忽略大小写
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## `on_endswith(msg, rule=None, ignorecase=False, **kwargs)`
+
+
+* **说明**
+
+    注册一个消息事件响应器，并且当消息的\*\*文本部分\*\*以指定内容结尾时响应。
+
+
+
+* **参数**
+
+    
+    * `msg: Union[str, Tuple[str, ...]]`: 指定消息结尾内容
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `ignorecase: bool`: 是否忽略大小写
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## `on_keyword(keywords, rule=None, **kwargs)`
+
+
+* **说明**
+
+    注册一个消息事件响应器，并且当消息纯文本部分包含关键词时响应。
+
+
+
+* **参数**
+
+    
+    * `keywords: Set[str]`: 关键词列表
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## `on_command(cmd, rule=None, aliases=None, **kwargs)`
+
+
+* **说明**
+
+    注册一个消息事件响应器，并且当消息以指定命令开头时响应。
+
+    命令匹配规则参考: [命令形式匹配](rule.html#command-command)
+
+
+
+* **参数**
+
+    
+    * `cmd: Union[str, Tuple[str, ...]]`: 指定命令内容
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `aliases: Optional[Set[Union[str, Tuple[str, ...]]]]`: 命令别名
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## `on_shell_command(cmd, rule=None, aliases=None, parser=None, **kwargs)`
+
+
+* **说明**
+
+    注册一个支持 `shell_like` 解析参数的命令消息事件响应器。
+
+    与普通的 `on_command` 不同的是，在添加 `parser` 参数时, 响应器会自动处理消息。
+
+    并将用户输入的原始参数列表保存在 `state["argv"]`, `parser` 处理的参数保存在 `state["args"]` 中
+
+
+
+* **参数**
+
+    
+    * `cmd: Union[str, Tuple[str, ...]]`: 指定命令内容
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `aliases: Optional[Set[Union[str, Tuple[str, ...]]]]`: 命令别名
+
+
+    * `parser: Optional[ArgumentParser]`: `nonebot.rule.ArgumentParser` 对象
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## `on_regex(pattern, flags=0, rule=None, **kwargs)`
+
+
+* **说明**
+
+    注册一个消息事件响应器，并且当消息匹配正则表达式时响应。
+
+    命令匹配规则参考: [正则匹配](rule.html#regex-regex-flags-0)
+
+
+
+* **参数**
+
+    
+    * `pattern: str`: 正则表达式
+
+
+    * `flags: Union[int, re.RegexFlag]`: 正则匹配标志
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## _class_ `CommandGroup`
+
+基类：`object`
+
+命令组，用于声明一组有相同名称前缀的命令。
+
+
+### `__init__(cmd, **kwargs)`
+
+
+* **参数**
+
+    
+    * `cmd: Union[str, Tuple[str, ...]]`: 命令前缀
+
+
+    * `**kwargs`: 其他传递给 `on_command` 的参数默认值，参考 [on_command](#on-command-cmd-rule-none-aliases-none-kwargs)
+
+
+
+### `basecmd`
+
+
+* **类型**: `Tuple[str, ...]`
+
+
+* **说明**: 命令前缀
+
+
+### `base_kwargs`
+
+
+* **类型**: `Dict[str, Any]`
+
+
+* **说明**: 其他传递给 `on_command` 的参数默认值
+
+
+### `command(cmd, **kwargs)`
+
+
+* **说明**
+
+    注册一个新的命令。
+
+
+
+* **参数**
+
+    
+    * `cmd: Union[str, Tuple[str, ...]]`: 命令前缀
+
+
+    * `**kwargs`: 其他传递给 `on_command` 的参数，将会覆盖命令组默认值
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+### `shell_command(cmd, **kwargs)`
+
+
+* **说明**
+
+    注册一个新的命令。
+
+
+
+* **参数**
+
+    
+    * `cmd: Union[str, Tuple[str, ...]]`: 命令前缀
+
+
+    * `**kwargs`: 其他传递给 `on_shell_command` 的参数，将会覆盖命令组默认值
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## _class_ `MatcherGroup`
+
+基类：`object`
+
+事件响应器组合，统一管理。为 `Matcher` 创建提供默认属性。
+
+
+### `__init__(**kwargs)`
+
+
+* **说明**
+
+    创建一个事件响应器组合，参数为默认值，与 `on` 一致
+
+
+
+### `matchers`
+
+
+* **类型**
+
+    `List[Type[Matcher]]`
+
+
+
+* **说明**
+
+    组内事件响应器列表
+
+
+
+### `base_kwargs`
+
+
+* **类型**: `Dict[str, Any]`
+
+
+* **说明**: 其他传递给 `on` 的参数默认值
+
+
+### `on(**kwargs)`
+
+
+* **说明**
+
+    注册一个基础事件响应器，可自定义类型。
+
+
+
+* **参数**
+
+    
+    * `type: str`: 事件响应器类型
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+### `on_metaevent(**kwargs)`
+
+
+* **说明**
+
+    注册一个元事件响应器。
+
+
+
+* **参数**
+
+    
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+### `on_message(**kwargs)`
+
+
+* **说明**
+
+    注册一个消息事件响应器。
+
+
+
+* **参数**
+
+    
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+### `on_notice(**kwargs)`
+
+
+* **说明**
+
+    注册一个通知事件响应器。
+
+
+
+* **参数**
+
+    
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+### `on_request(**kwargs)`
+
+
+* **说明**
+
+    注册一个请求事件响应器。
+
+
+
+* **参数**
+
+    
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+### `on_startswith(msg, **kwargs)`
+
+
+* **说明**
+
+    注册一个消息事件响应器，并且当消息的\*\*文本部分\*\*以指定内容开头时响应。
+
+
+
+* **参数**
+
+    
+    * `msg: Union[str, Tuple[str, ...]]`: 指定消息开头内容
+
+
+    * `ignorecase: bool`: 是否忽略大小写
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+### `on_endswith(msg, **kwargs)`
+
+
+* **说明**
+
+    注册一个消息事件响应器，并且当消息的\*\*文本部分\*\*以指定内容结尾时响应。
+
+
+
+* **参数**
+
+    
+    * `msg: Union[str, Tuple[str, ...]]`: 指定消息结尾内容
+
+
+    * `ignorecase: bool`: 是否忽略大小写
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+### `on_keyword(keywords, **kwargs)`
+
+
+* **说明**
+
+    注册一个消息事件响应器，并且当消息纯文本部分包含关键词时响应。
+
+
+
+* **参数**
+
+    
+    * `keywords: Set[str]`: 关键词列表
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+### `on_command(cmd, aliases=None, **kwargs)`
+
+
+* **说明**
+
+    注册一个消息事件响应器，并且当消息以指定命令开头时响应。
+
+    命令匹配规则参考: [命令形式匹配](rule.html#command-command)
+
+
+
+* **参数**
+
+    
+    * `cmd: Union[str, Tuple[str, ...]]`: 指定命令内容
+
+
+    * `aliases: Optional[Set[Union[str, Tuple[str, ...]]]]`: 命令别名
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+### `on_shell_command(cmd, aliases=None, parser=None, **kwargs)`
+
+
+* **说明**
+
+    注册一个支持 `shell_like` 解析参数的命令消息事件响应器。
+
+    与普通的 `on_command` 不同的是，在添加 `parser` 参数时, 响应器会自动处理消息。
+
+    并将用户输入的原始参数列表保存在 `state["argv"]`, `parser` 处理的参数保存在 `state["args"]` 中
+
+
+
+* **参数**
+
+    
+    * `cmd: Union[str, Tuple[str, ...]]`: 指定命令内容
+
+
+    * `aliases: Optional[Set[Union[str, Tuple[str, ...]]]]`: 命令别名
+
+
+    * `parser: Optional[ArgumentParser]`: `nonebot.rule.ArgumentParser` 对象
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+### `on_regex(pattern, flags=0, **kwargs)`
+
+
+* **说明**
+
+    注册一个消息事件响应器，并且当消息匹配正则表达式时响应。
+
+    命令匹配规则参考: [正则匹配](rule.html#regex-regex-flags-0)
+
+
+
+* **参数**
+
+    
+    * `pattern: str`: 正则表达式
+
+
+    * `flags: Union[int, re.RegexFlag]`: 正则匹配标志
+
+
+    * `rule: Optional[Union[Rule, T_RuleChecker]]`: 事件响应规则
+
+
+    * `permission: Optional[Permission]`: 事件响应权限
+
+
+    * `handlers: Optional[List[Union[T_Handler, Handler]]]`: 事件处理函数列表
+
+
+    * `temp: bool`: 是否为临时事件响应器（仅执行一次）
+
+
+    * `priority: int`: 事件响应器优先级
+
+
+    * `block: bool`: 是否阻止事件向更低优先级传递
+
+
+    * `state: Optional[T_State]`: 默认 state
+
+
+    * `state_factory: Optional[T_StateFactory]`: 默认 state 的工厂函数
+
+
+
+* **返回**
+
+    
+    * `Type[Matcher]`
+
+
+
+## `load_plugin(module_path)`
+
+
+* **说明**
+
+    使用 `PluginManager` 加载单个插件，可以是本地插件或是通过 `pip` 安装的插件。
+
+
+
+* **参数**
+
+    
+    * `module_path: str`: 插件名称 `path.to.your.plugin`
+
+
+
+* **返回**
+
+    
+    * `Optional[Plugin]`
+
+
+
+## `load_plugins(*plugin_dir)`
+
+
+* **说明**
+
+    导入目录下多个插件，以 `_` 开头的插件不会被导入！
+
+
+
+* **参数**
+
+    
+    * `*plugin_dir: str`: 插件路径
+
+
+
+* **返回**
+
+    
+    * `Set[Plugin]`
+
+
+
+## `load_all_plugins(module_path, plugin_dir)`
+
+
+* **说明**
+
+    导入指定列表中的插件以及指定目录下多个插件，以 `_` 开头的插件不会被导入！
+
+
+
+* **参数**
+
+    
+    * `module_path: Set[str]`: 指定插件集合
+
+
+    * `plugin_dir: Set[str]`: 指定插件路径集合
+
+
+
+* **返回**
+
+    
+    * `Set[Plugin]`
+
+
+
+## `load_from_json(file_path, encoding='utf-8')`
+
+
+* **说明**
+
+    导入指定 json 文件中的 `plugins` 以及 `plugin_dirs` 下多个插件，以 `_` 开头的插件不会被导入！
+
+
+
+* **参数**
+
+    
+    * `file_path: str`: 指定 json 文件路径
+
+
+    * `encoding: str`: 指定 json 文件编码
+
+
+
+* **返回**
+
+    
+    * `Set[Plugin]`
+
+
+
+## `load_from_toml(file_path, encoding='utf-8')`
+
+
+* **说明**
+
+    导入指定 toml 文件 `[nonebot.plugins]` 中的 `plugins` 以及 `plugin_dirs` 下多个插件，
+    以 `_` 开头的插件不会被导入！
+
+
+
+* **参数**
+
+    
+    * `file_path: str`: 指定 toml 文件路径
+
+
+    * `encoding: str`: 指定 toml 文件编码
+
+
+
+* **返回**
+
+    
+    * `Set[Plugin]`
+
+
+
+## `load_builtin_plugins(name='echo')`
+
+
+* **说明**
+
+    导入 NoneBot 内置插件
+
+
+
+* **返回**
+
+    
+    * `Plugin`
+
+
+
+## `get_plugin(name)`
+
+
+* **说明**
+
+    获取当前导入的某个插件。
+
+
+
+* **参数**
+
+    
+    * `name: str`: 插件名，与 `load_plugin` 参数一致。如果为 `load_plugins` 导入的插件，则为文件(夹)名。
+
+
+
+* **返回**
+
+    
+    * `Optional[Plugin]`
+
+
+
+## `get_loaded_plugins()`
+
+
+* **说明**
+
+    获取当前已导入的所有插件。
+
+
+
+* **返回**
+
+    
+    * `Set[Plugin]`
+
+
+
+## `require(name)`
+
+
+* **说明**
+
+    获取一个插件的导出内容
+
+
+
+* **参数**
+
+    
+    * `name: str`: 插件名，与 `load_plugin` 参数一致。如果为 `load_plugins` 导入的插件，则为文件(夹)名。
+
+
+
+* **返回**
+
+    
+    * `Optional[Export]`
+
+
+
+## _class_ `Export`
+
+基类：`dict`
+
+
+* **说明**
+
+    插件导出内容以使得其他插件可以获得。
+
+
+
+* **示例**
+
+
+```python
+nonebot.export().default = "bar"
+
+@nonebot.export()
+def some_function():
+    pass
+
+# this doesn't work before python 3.9
+# use
+# export = nonebot.export(); @export.sub
+# instead
+# See also PEP-614: https://www.python.org/dev/peps/pep-0614/
+@nonebot.export().sub
+def something_else():
+    pass
+```
+
+
+## `export()`
+
+
+* **说明**
+
+    获取插件的导出内容对象
+
+
+
+* **返回**
+
+    
+    * `Export`
diff --git a/docs/api/rule.md b/docs/api/rule.md
index 138e2245..0ee615df 100644
--- a/docs/api/rule.md
+++ b/docs/api/rule.md
@@ -4,3 +4,263 @@ sidebarDepth: 0
 ---
 
 # NoneBot.rule 模块
+
+## 规则
+
+每个事件响应器 `Matcher` 拥有一个匹配规则 `Rule` ，其中是 **异步** `RuleChecker` 的集合，只有当所有 `RuleChecker` 检查结果为 `True` 时继续运行。
+
+:::tip 提示
+`RuleChecker` 既可以是 async function 也可以是 sync function，但在最终会被 `nonebot.utils.run_sync` 转换为 async function
+:::
+
+
+## _class_ `Rule`
+
+基类：`object`
+
+
+* **说明**
+
+    `Matcher` 规则类，当事件传递时，在 `Matcher` 运行前进行检查。
+
+
+
+* **示例**
+
+
+```python
+Rule(async_function) & sync_function
+# 等价于
+from nonebot.utils import run_sync
+Rule(async_function, run_sync(sync_function))
+```
+
+
+### `__init__(*checkers)`
+
+
+* **参数**
+
+    
+    * `*checkers: Callable[[Bot, Event, T_State], Awaitable[bool]]`: **异步** RuleChecker
+
+
+
+### `checkers`
+
+
+* **说明**
+
+    存储 `RuleChecker`
+
+
+
+* **类型**
+
+    
+    * `Set[Callable[[Bot, Event, T_State], Awaitable[bool]]]`
+
+
+
+### _async_ `__call__(bot, event, state)`
+
+
+* **说明**
+
+    检查是否符合所有规则
+
+
+
+* **参数**
+
+    
+    * `bot: Bot`: Bot 对象
+
+
+    * `event: Event`: Event 对象
+
+
+    * `state: T_State`: 当前 State
+
+
+
+* **返回**
+
+    
+    * `bool`
+
+
+
+## `startswith(msg, ignorecase=False)`
+
+
+* **说明**
+
+    匹配消息开头
+
+
+
+* **参数**
+
+    
+    * `msg: str`: 消息开头字符串
+
+
+
+## `endswith(msg, ignorecase=False)`
+
+
+* **说明**
+
+    匹配消息结尾
+
+
+
+* **参数**
+
+    
+    * `msg: str`: 消息结尾字符串
+
+
+
+## `keyword(*keywords)`
+
+
+* **说明**
+
+    匹配消息关键词
+
+
+
+* **参数**
+
+    
+    * `*keywords: str`: 关键词
+
+
+
+## `command(*cmds)`
+
+
+* **说明**
+
+    命令形式匹配，根据配置里提供的 `command_start`, `command_sep` 判断消息是否为命令。
+
+    可以通过 `state["_prefix"]["command"]` 获取匹配成功的命令（例：`("test",)`），通过 `state["_prefix"]["raw_command"]` 获取匹配成功的原始命令文本（例：`"/test"`）。
+
+
+
+* **参数**
+
+    
+    * `*cmds: Union[str, Tuple[str, ...]]`: 命令内容
+
+
+
+* **示例**
+
+    使用默认 `command_start`, `command_sep` 配置
+
+    命令 `("test",)` 可以匹配：`/test` 开头的消息
+    命令 `("test", "sub")` 可以匹配”`/test.sub` 开头的消息
+
+
+:::tip 提示
+命令内容与后续消息间无需空格！
+:::
+
+
+## _class_ `ArgumentParser`
+
+基类：`argparse.ArgumentParser`
+
+
+* **说明**
+
+    `shell_like` 命令参数解析器，解析出错时不会退出程序。
+
+
+
+## `shell_command(*cmds, parser=None)`
+
+
+* **说明**
+
+    支持 `shell_like` 解析参数的命令形式匹配，根据配置里提供的 `command_start`, `command_sep` 判断消息是否为命令。
+
+    可以通过 `state["_prefix"]["command"]` 获取匹配成功的命令（例：`("test",)`），通过 `state["_prefix"]["raw_command"]` 获取匹配成功的原始命令文本（例：`"/test"`）。
+
+    可以通过 `state["argv"]` 获取用户输入的原始参数列表
+
+    添加 `parser` 参数后, 可以自动处理消息并将结果保存在 `state["args"]` 中。
+
+
+
+* **参数**
+
+    
+    * `*cmds: Union[str, Tuple[str, ...]]`: 命令内容
+
+
+    * `parser: Optional[ArgumentParser]`: `nonebot.rule.ArgumentParser` 对象
+
+
+
+* **示例**
+
+    使用默认 `command_start`, `command_sep` 配置，更多示例参考 `argparse` 标准库文档。
+
+
+```python
+from nonebot.rule import ArgumentParser
+
+parser = ArgumentParser()
+parser.add_argument("-a", action="store_true")
+
+rule = shell_command("ls", parser=parser)
+```
+
+:::tip 提示
+命令内容与后续消息间无需空格！
+:::
+
+
+## `regex(regex, flags=0)`
+
+
+* **说明**
+
+    根据正则表达式进行匹配。
+
+    可以通过 `state["_matched"]` `state["_matched_groups"]` `state["_matched_dict"]`
+    获取正则表达式匹配成功的文本。
+
+
+
+* **参数**
+
+    
+    * `regex: str`: 正则表达式
+
+
+    * `flags: Union[int, re.RegexFlag]`: 正则标志
+
+
+:::tip 提示
+正则表达式匹配使用 search 而非 match，如需从头匹配请使用 `r"^xxx"` 来确保匹配开头
+:::
+
+
+## `to_me()`
+
+
+* **说明**
+
+    通过 `event.is_tome()` 判断事件是否与机器人有关
+
+
+
+* **参数**
+
+    
+    * 无