chore(core.platform): 🚨 修正platform基类和webchat的错误Lint

Author: Dt8333

astrbot/core/platform/astr_message_event.py

@@ -4,7 +4,7 @@
 import hashlib
 import uuid
 
-from typing import Any
+from typing import Any, cast
 
 from collections.abc import AsyncGenerator
 
@@ -53,7 +53,7 @@ def __init__(
         """是否是 At 机器人或者带有唤醒词或者是私聊(插件注册的事件监听器会让 is_wake 设为 True, 但是不会让这个属性置为 True)"""
         self._extras: dict[str, Any] = {}
         self.session = MessageSesion(
-            platform_name=platform_meta.id,
+            platform_name=cast(str, platform_meta.id),
             message_type=message_obj.type,
             session_id=session_id,
         )
@@ -169,7 +169,9 @@ def get_sender_name(self) -> str:
         """
         获取消息发送者的名称。(可能会返回空字符串)
         """
-        return self.message_obj.sender.nickname
+        if isinstance(self.message_obj.sender.nickname, str):
+            return self.message_obj.sender.nickname
+        return ""
 
     def set_extra(self, key, value):
         """
@@ -300,7 +302,7 @@ def should_call_llm(self, call_llm: bool):
         """
         self.call_llm = call_llm
 
-    def get_result(self) -> MessageEventResult:
+    def get_result(self) -> MessageEventResult | None:
         """
         获取消息事件的结果。
         """
@@ -360,11 +362,11 @@ def request_llm(
         self,
         prompt: str,
         func_tool_manager=None,
-        session_id: str = None,
+        session_id: str = "",
         image_urls: list[str] = [],
         contexts: list = [],
         system_prompt: str = "",
-        conversation: Conversation = None,
+        conversation: Conversation | None = None,
     ) -> ProviderRequest:
         """
         创建一个 LLM 请求。
@@ -429,7 +431,7 @@ async def react(self, emoji: str):
         """
         await self.send(MessageChain([Plain(emoji)]))
 
-    async def get_group(self, group_id: str = None, **kwargs) -> Group | None:
+    async def get_group(self, group_id: str | None = None, **kwargs) -> Group | None:
         """获取一个群聊的数据, 如果不填写 group_id: 如果是私聊消息，返回 None。如果是群聊消息，返回当前群聊的数据。
 
         适配情况:

astrbot/core/platform/astrbot_message.py

@@ -7,7 +7,7 @@
 @dataclass
 class MessageMember:
     user_id: str  # 发送者id
-    nickname: str = None
+    nickname: str | None = None
 
     def __str__(self):
         # 使用 f-string 来构建返回的字符串表示形式
@@ -21,15 +21,15 @@ def __str__(self):
 class Group:
     group_id: str
     """群号"""
-    group_name: str = None
+    group_name: str | None = None
     """群名称"""
-    group_avatar: str = None
+    group_avatar: str | None = None
     """群头像"""
-    group_owner: str = None
+    group_owner: str | None = None
     """群主 id"""
-    group_admins: list[str] = None
+    group_admins: list[str] | None = None
     """群管理员 id"""
-    members: list[MessageMember] = None
+    members: list[MessageMember] | None = None
     """所有群成员"""
 
     def __str__(self):
@@ -54,7 +54,7 @@ class AstrBotMessage:
     self_id: str  # 机器人的识别id
     session_id: str  # 会话id。取决于 unique_session 的设置。
     message_id: str  # 消息id
-    group: Group  # 群组
+    group: Group | None  # 群组
     sender: MessageMember  # 发送者
     message: list[BaseMessageComponent]  # 消息链使用 Nakuru 的消息链格式
     message_str: str  # 最直观的纯文本消息字符串

astrbot/core/platform/message_session.py

@@ -11,7 +11,7 @@ class MessageSession:
     """平台适配器实例的唯一标识符。自 AstrBot v4.0.0 起，该字段实际为 platform_id。"""
     message_type: MessageType
     session_id: str
-    platform_id: str = None
+    platform_id: str | None = None
 
     def __str__(self):
         return f"{self.platform_id}:{self.message_type.value}:{self.session_id}"

astrbot/core/platform/platform.py

@@ -2,7 +2,8 @@
 import uuid
 from typing import Any
 
-from collections.abc import Awaitable
+from collections.abc import Coroutine
+
 from asyncio import Queue
 from .platform_metadata import PlatformMetadata
 from .astr_message_event import AstrMessageEvent
@@ -19,7 +20,7 @@ def __init__(self, event_queue: Queue):
         self.client_self_id = uuid.uuid4().hex
 
     @abc.abstractmethod
-    def run(self) -> Awaitable[Any]:
+    def run(self) -> Coroutine[Any, Any, None]:
         """
         得到一个平台的运行实例，需要返回一个协程对象。
         """
@@ -40,7 +41,7 @@ def meta(self) -> PlatformMetadata:
 
     async def send_by_session(
         self, session: MessageSesion, message_chain: MessageChain
-    ) -> Awaitable[Any]:
+    ) -> None:
         """
         通过会话发送消息。该方法旨在让插件能够直接通过**可持久化的会话数据**发送消息，而不需要保存 event 对象。
 

astrbot/core/platform/platform_metadata.py

@@ -7,12 +7,12 @@ class PlatformMetadata:
     """平台的名称，即平台的类型，如 aiocqhttp, discord, slack"""
     description: str
     """平台的描述"""
-    id: str = None
+    id: str | None = None
     """平台的唯一标识符，用于配置中识别特定平台"""
 
-    default_config_tmpl: dict = None
+    default_config_tmpl: dict | None = None
     """平台的默认配置模板"""
-    adapter_display_name: str = None
+    adapter_display_name: str | None = None
     """显示在 WebUI 配置页中的平台名称，如空则是 name"""
-    logo_path: str = None
+    logo_path: str | None = None
     """平台适配器的 logo 文件路径（相对于插件目录）"""

astrbot/core/platform/register.py

@@ -10,9 +10,9 @@
 def register_platform_adapter(
     adapter_name: str,
     desc: str,
-    default_config_tmpl: dict = None,
-    adapter_display_name: str = None,
-    logo_path: str = None,
+    default_config_tmpl: dict | None = None,
+    adapter_display_name: str | None = None,
+    logo_path: str | None = None,
 ):
     """用于注册平台适配器的带参装饰器。
 

astrbot/core/platform/sources/webchat/webchat_adapter.py

@@ -4,7 +4,9 @@
 import os
 from typing import Any
 
-from collections.abc import Awaitable, Callable
+from collections.abc import Coroutine
+
+from collections.abc import Callable
 from astrbot.core.platform import (
     Platform,
     AstrBotMessage,
@@ -133,7 +135,7 @@ async def convert_message(self, data: tuple) -> AstrBotMessage:
         abm.raw_message = data
         return abm
 
-    def run(self) -> Awaitable[Any]:
+    def run(self) -> Coroutine[Any, Any, None]:
         async def callback(data: tuple):
             abm = await self.convert_message(data)
             await self.handle_msg(abm)

astrbot/core/platform/sources/webchat/webchat_event.py

@@ -47,7 +47,9 @@ async def _send(message: MessageChain, session_id: str, streaming: bool = False)
                 # save image to local
                 filename = str(uuid.uuid4()) + ".jpg"
                 path = os.path.join(imgs_dir, filename)
-                if comp.file and comp.file.startswith("file:///"):
+                if comp.file is None:
+                    raise ValueError("Image file is None")
+                elif comp.file.startswith("file:///"):
                     ph = comp.file[8:]
                     with open(path, "wb") as f:
                         with open(ph, "rb") as f2:
@@ -76,7 +78,9 @@ async def _send(message: MessageChain, session_id: str, streaming: bool = False)
                 # save record to local
                 filename = str(uuid.uuid4()) + ".wav"
                 path = os.path.join(imgs_dir, filename)
-                if comp.file and comp.file.startswith("file:///"):
+                if comp.file is None:
+                    raise ValueError("Record file is None")
+                elif comp.file.startswith("file:///"):
                     ph = comp.file[8:]
                     with open(path, "wb") as f:
                         with open(ph, "rb") as f2: