K2Cr2O1
f868553342
新增Discord适配器支持，实现Discord与QQ之间的消息互通 添加通用数据模型用于跨平台消息转换 扩展配置系统以支持Discord和日志配置 重构日志系统以使用配置中的日志级别 在反向WebSocket管理器中注册Bot实例 更新主程序以支持Discord客户端启动 添加测试脚本验证核心功能
102 lines
4.0 KiB
Python
102 lines
4.0 KiB
Python
# -*- coding: utf-8 -*-
|
||
"""
|
||
通用数据模型 (Universal Data Models)
|
||
|
||
此模块定义了平台无关的数据结构，用于在不同平台（如 OneBot, Discord）
|
||
和业务逻辑层（如 Plugins）之间传递数据。
|
||
"""
|
||
from dataclasses import dataclass, field
|
||
from typing import List, Optional, Union, Dict, Any
|
||
|
||
@dataclass
|
||
class UniversalMessageSegment:
|
||
"""
|
||
平台无关的通用消息段模型。
|
||
业务逻辑层只负责生成这个对象，由底层的 Adapter 负责将其翻译成特定平台的格式。
|
||
"""
|
||
type: str # 消息类型：'text', 'image', 'video', 'audio', 'at', 'reply' 等
|
||
data: Dict[str, Any] # 消息数据载荷
|
||
|
||
@staticmethod
|
||
def text(text: str) -> "UniversalMessageSegment":
|
||
return UniversalMessageSegment("text", {"text": text})
|
||
|
||
@staticmethod
|
||
def image(url: Optional[str] = None, base64: Optional[str] = None, file_path: Optional[str] = None) -> "UniversalMessageSegment":
|
||
"""
|
||
图片消息。
|
||
Discord 支持直接发 URL 或上传本地文件；OneBot 支持 URL、Base64 或本地路径。
|
||
"""
|
||
return UniversalMessageSegment("image", {"url": url, "base64": base64, "file_path": file_path})
|
||
|
||
@staticmethod
|
||
def video(url: Optional[str] = None, file_path: Optional[str] = None) -> "UniversalMessageSegment":
|
||
"""
|
||
视频消息。
|
||
Discord 通常直接发 URL 或作为附件上传；OneBot 支持 URL 或本地路径。
|
||
"""
|
||
return UniversalMessageSegment("video", {"url": url, "file_path": file_path})
|
||
|
||
@staticmethod
|
||
def at(user_id: str) -> "UniversalMessageSegment":
|
||
"""
|
||
@某人。
|
||
注意：为了兼容 Discord 的雪花 ID (Snowflake)，user_id 必须是字符串。
|
||
"""
|
||
return UniversalMessageSegment("at", {"user_id": user_id})
|
||
|
||
@staticmethod
|
||
def reply(message_id: str) -> "UniversalMessageSegment":
|
||
"""
|
||
回复某条消息。
|
||
"""
|
||
return UniversalMessageSegment("reply", {"message_id": message_id})
|
||
|
||
@dataclass
|
||
class UniversalUser:
|
||
"""通用用户模型"""
|
||
id: str # 用户唯一ID (QQ号 或 Discord Snowflake ID)
|
||
name: str # 用户昵称/群名片
|
||
avatar_url: str # 头像URL
|
||
is_bot: bool # 是否是机器人
|
||
|
||
@dataclass
|
||
class UniversalChannel:
|
||
"""通用频道/群组模型"""
|
||
id: str # 频道/群组唯一ID (QQ群号 或 Discord Channel ID)
|
||
name: str # 频道/群组名称
|
||
type: str # 类型：'private' (私聊), 'group' (QQ群), 'guild_text' (Discord文字频道) 等
|
||
guild_id: Optional[str] = None # 仅 Discord 有效：服务器(Guild) ID
|
||
|
||
@dataclass
|
||
class UniversalMessageEvent:
|
||
"""
|
||
平台无关的通用消息事件模型。
|
||
这是传递给业务逻辑层（如 bili.py）的最终对象。
|
||
"""
|
||
platform: str # 来源平台标识：'onebot' 或 'discord'
|
||
|
||
message_id: str # 消息唯一ID (QQ消息ID 或 Discord Message ID)
|
||
|
||
user: UniversalUser # 发送者信息
|
||
channel: UniversalChannel # 消息来源频道/群组信息
|
||
|
||
raw_message: str # 纯文本形式的消息内容（用于正则匹配、命令解析）
|
||
|
||
# 解析后的消息段列表（可选，如果你需要处理图文混排）
|
||
message: List[UniversalMessageSegment] = field(default_factory=list)
|
||
|
||
# 原始的底层事件对象（保留引用，方便高级操作）
|
||
# 例如：OneBot 的原始 JSON 字典，或 discord.py 的 discord.Message 对象
|
||
raw_event: Any = field(repr=False, default=None)
|
||
|
||
async def reply(self, message: Union[str, UniversalMessageSegment, List[UniversalMessageSegment]]):
|
||
"""
|
||
统一的回复接口。
|
||
这个方法应该是一个抽象方法或由具体的 Adapter 注入实现。
|
||
业务逻辑层调用此方法时，不需要关心底层是调用 OneBot API 还是 Discord API。
|
||
"""
|
||
raise NotImplementedError("此方法应由具体的 Platform Adapter 实现")
|
||
|
||
|