💡 update source docstring #46 #49

nonebot/adapters/__init__.py

@@ -60,6 +60,19 @@ class BaseBot(abc.ABC):
     async def check_permission(cls, driver: Driver, connection_type: str,
                                headers: dict,
                                body: Optional[dict]) -> Union[str, NoReturn]:
+        """
+        :说明:
+          检查连接请求是否合法的函数，如果合法则返回当前连接 ``唯一标识符``，通常为机器人 ID；如果不合法则抛出 ``RequestDenied`` 异常。
+        :参数:
+          * ``driver: Driver``: Driver 对象
+          * ``connection_type: str``: 连接类型
+          * ``headers: dict``: 请求头
+          * ``body: Optional[dict]``: 请求数据，WebSocket 连接该部分为空
+        :返回:
+          - ``str``: 连接唯一标识符
+        :异常:
+          - ``RequestDenied``: 请求非法
+        """
         raise NotImplementedError
 
     @abc.abstractmethod
@@ -84,7 +97,7 @@ class BaseBot(abc.ABC):
 
         .. code-block:: python
 
-            await bot.call_api("send_msg", data={"message": "hello world"})
+            await bot.call_api("send_msg", message="hello world"})
             await bot.send_msg(message="hello world")
         """
         raise NotImplementedError

nonebot/adapters/cqhttp/__init__.py

@@ -296,6 +296,10 @@ class Bot(BaseBot):
     async def check_permission(cls, driver: Driver, connection_type: str,
                                headers: dict,
                                body: Optional[dict]) -> Union[str, NoReturn]:
+        """
+        :说明:
+          CQHTTP (OneBot) 协议鉴权。参考 `鉴权 <https://github.com/howmanybots/onebot/blob/master/v11/specs/communication/authorization.md>`_
+        """
         x_self_id = headers.get("x-self-id")
         x_signature = headers.get("x-signature")
         access_token = get_auth_bearer(headers.get("authorization"))

nonebot/drivers/__init__.py

@@ -1,6 +1,6 @@
 """
 后端驱动适配基类
-===============
+=================
 
 各驱动请继承以下基类
 """
@@ -27,6 +27,7 @@ class BaseDriver(abc.ABC):
     def __init__(self, env: Env, config: Config):
         """
         :参数:
+
           * ``env: Env``: 包含环境信息的 Env 对象
           * ``config: Config``: 包含配置信息的 Config 对象
         """
@@ -136,6 +137,7 @@ class BaseWebSocket(object):
     def __init__(self, websocket):
         """
         :参数:
+
           * ``websocket: Any``: WebSocket 连接对象
         """
         self._websocket = websocket

nonebot/drivers/fastapi.py

@@ -150,7 +150,7 @@ class Driver(BaseDriver):
                                 detail=e.reason) from None
 
         if x_self_id in self._clients:
-            logger.warning("There's already a reverse websocket api connection,"
+            logger.warning("There's already a reverse websocket connection,"
                            "so the event may be handled twice.")
 
         bot = BotClass(self, "http", self.config, x_self_id)
@@ -178,6 +178,11 @@ class Driver(BaseDriver):
             await ws.close(code=status.WS_1008_POLICY_VIOLATION)
             return
 
+        if x_self_id in self._clients:
+            logger.warning("There's already a reverse websocket connection, "
+                           f"<y>{adapter.upper()} Bot {x_self_id}</y> ignored.")
+            await ws.close(code=status.WS_1008_POLICY_VIOLATION)
+
         bot = BotClass(self, "websocket", self.config, x_self_id, websocket=ws)
 
         await ws.accept()