feat(Utils): 支持发送图片URL及频道图片处理

- 在 `MediaPayload` 中新增 `url` 字段用于存储媒体链接
- 在 `AutoReplyPayload` 和 `MessageSenderBasePayload` 中新增 `image` 字段，支持通过 URL 发送图片
- 新增 `set_image` 方法用于设置图片 URL
- 更新 `GuildMessageEvent.reply` 方法，支持通过 `media.url` 设置图片
- 修改 `send_auto_reply` 函数，支持传递 image 字段
- 更新 `upload_file` 函数，针对频道/频私场景直接返回原图片 URL，不再上传
- 更新文档注释，明确 image 参数仅适用于频道或频道私信场景
- 更新版本号至 2.1.0+13020
- 添加 `python-multipart` 依赖以支持文件处理

Signed-off-by: Shanshui2024 <[email protected]>

Author: Shanshui2024

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "AxTBot-Public"
-version = "2.1.0+13010"
+version = "2.1.0+13020"
 description = "AxTBot 社区机器人是由 AxT社区 开发并维护的公共、公益性QQ官方机器人，基于QQ开放平台 ，使用 Python 和 FastAPI 构建"
 authors = [
     {name = "Shanshui2024", email = "[email protected]"},
@@ -13,7 +13,8 @@ dependencies = [
     "pydantic==2.11.7","pydantic-core==2.33.2","PyNaCl==1.5.0","pypika-tortoise==0.6.1",
     "pyreadline3==3.5.4","pytz==2025.2","PyYAML==6.0.2","questionary==2.1.0","sniffio==1.3.1",
     "starlette==0.47.2","tortoise-orm==0.25.1","typing-inspection==0.4.1","typing-extensions==4.14.1",
-    "uvicorn==0.35.0","wcwidth==0.2.13","requests", "tomli", "aiohttp"
+    "uvicorn==0.35.0","wcwidth==0.2.13","requests", "tomli", "aiohttp",
+    "python-multipart"
 ]
 requires-python = ">=3.8"
 readme = "README.md"

src/Utils/EventClass.py

@@ -380,6 +380,7 @@ def __init__(self, payload: Optional[Dict] = None):
         self.file_info: str = self._payload.get('file_info', '')
         self.ttl: int = self._payload.get('ttl', 0)
         self.id: str = self._payload.get('id', '')
+        self.url: str = self._payload.get('url', '')
 
     def to_dict(self) -> Dict[str, Any]:
         if not self.file_info: return None
@@ -439,6 +440,7 @@ def __init__(self, event, is_direct_message = False):
         self.markdown: MarkdownPayload = None
         self.ark: ArkPayload = None
         self.media: MediaPayload = None
+        self.image = None
         self.event_id: str = None
 
     def set_content(self, content):
@@ -456,6 +458,9 @@ def set_ark(self, ark: ArkPayload = None):
     def set_media(self, media: MediaPayload = None):
         self.media = media
         return self
+    def set_image(self, image: str = None):
+        self.image = image
+        return self
 
 
 class MessageSenderBasePayload:    
@@ -474,6 +479,7 @@ def __init__(self, payload: Union[Dict[str, Any], str] = None):
         :param payload.keyboard: 按钮消息体
         :param payload.ark: Ark消息体
         :param payload.media: 媒体消息体
+        :param payload.image: 图片URL（仅适用于频道/频私发送图片）
 
         Powered by [AxTn Network](https://www.axtrk.com) 2023-2025
         """
@@ -494,6 +500,7 @@ def __init__(self, payload: Union[Dict[str, Any], str] = None):
         self.keyboard: KeyboardPayload = KeyboardPayload(self._raw_data.get('keyboard'))
         self.ark: ArkPayload = ArkPayload(self._raw_data.get('ark'))
         self.media: MediaPayload = MediaPayload(self._raw_data.get('media'))
+        self.image: str = self._raw_data.get('image', '')
 
     def to_dict(self) -> Dict[str, Any]:
         """将对象转换为字典"""
@@ -514,6 +521,8 @@ def to_dict(self) -> Dict[str, Any]:
             result['ark'] = self.ark.to_dict()
         if self.media.file_uuid:
             result['media'] = self.media.to_dict()
+        if self.image:
+            result['image'] = self.image
 
         return result
 
@@ -542,13 +551,15 @@ def mentions(self) -> List[AttrDict]:
     def is_direct_message(self) -> bool:
         """是否是私信消息"""
         return self.t == "DIRECT_MESSAGE_CREATE"
-    async def reply(self, content: str, markdown: MarkdownPayload = None, msg_id: str = None, ark: ArkPayload = None):
+    async def reply(self, content: str, markdown: MarkdownPayload = None, msg_id: str = None, ark: ArkPayload = None, media: MediaPayload = None):
         """快捷回复方法"""
         auto_payload = AutoReplyPayload(self, self.t == "DIRECT_MESSAGE_CREATE").set_content(content)
         if markdown:
             auto_payload.set_markdown(markdown)
         if ark:
             auto_payload.set_ark(ark)
+        if media.url:
+            auto_payload.set_image(media.url)
         from src.Utils.MessageSender import send_auto_reply
         await send_auto_reply(auto_payload)
 

src/Utils/MessageSender.py

@@ -249,6 +249,8 @@ async def send_auto_reply(payload: AutoReplyPayload) -> None:
     if payload.media:
         base_payload.media = payload.media
         base_payload.msg_type = 7
+    if payload.image:
+        base_payload.image = payload.image
     if payload.group_id:
         if payload.markdown or payload.ark:
             base_payload.content = " "
@@ -275,9 +277,14 @@ async def upload_file(payload: MediaUploadPayload):
     """上传文件至QQ服务器，返回文件信息
 
     :param payload: MediaUploadPayload 上传文件的负载
-    :return: dict or None 上传成功返回文件，失败返回None
+    :return dict: 文件信息 or None
+    :return url: 传入原url 用于处理频道图片
 
-    详见：https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/send-receive/rich-media.html
+    ---
+
+    详见：
+    - 群聊/私聊：https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/send-receive/rich-media.html
+    - 频道/频私：https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/post_messages.html
 
     Powered by AxTn Network 2023-2025
     """
@@ -286,6 +293,10 @@ async def upload_file(payload: MediaUploadPayload):
         url = open_url + f"/v2/groups/{payload.event.group_id}/files"
     elif payload.event.event_type == "私信":
         url = open_url + f"/v2/users/{payload.event.user_id}/files"
+    elif payload.event.event_type in ["频道艾特", "私域频道", "频道私信"]:
+        url = payload.url  # 频道图片上传使用原url
+        return MediaPayload({"url": payload.url})
+
     else:
         logger.error(f"上传文件失败: 不支持的消息类型 {payload.event.event_type}")
         return None