Daily build

models/objects.py

@@ -0,0 +1,238 @@
+"""
+API 响应数据模型模块
+
+定义了 API 返回的数据结构。
+"""
+from dataclasses import dataclass, field
+from typing import List, Optional
+
+
+@dataclass
+class GroupInfo:
+    """
+    群信息
+    """
+    group_id: int = 0
+    """群号"""
+    
+    group_name: str = ""
+    """群名称"""
+    
+    member_count: int = 0
+    """成员数"""
+    
+    max_member_count: int = 0
+    """最大成员数"""
+
+
+@dataclass
+class GroupMemberInfo:
+    """
+    群成员信息
+    """
+    group_id: int = 0
+    """群号"""
+    
+    user_id: int = 0
+    """QQ 号"""
+    
+    nickname: str = ""
+    """昵称"""
+    
+    card: str = ""
+    """群名片/备注"""
+    
+    sex: str = "unknown"
+    """性别, male 或 female 或 unknown"""
+    
+    age: int = 0
+    """年龄"""
+    
+    area: str = ""
+    """地区"""
+    
+    join_time: int = 0
+    """加群时间戳"""
+    
+    last_sent_time: int = 0
+    """最后发言时间戳"""
+    
+    level: str = ""
+    """成员等级"""
+    
+    role: str = "member"
+    """角色, owner 或 admin 或 member"""
+    
+    unfriendly: bool = False
+    """是否不良记录成员"""
+    
+    title: str = ""
+    """专属头衔"""
+    
+    title_expire_time: int = 0
+    """专属头衔过期时间戳"""
+    
+    card_changeable: bool = False
+    """是否允许修改群名片"""
+
+
+@dataclass
+class FriendInfo:
+    """
+    好友信息
+    """
+    user_id: int = 0
+    """QQ 号"""
+    
+    nickname: str = ""
+    """昵称"""
+    
+    remark: str = ""
+    """备注"""
+
+
+@dataclass
+class StrangerInfo:
+    """
+    陌生人信息
+    """
+    user_id: int = 0
+    """QQ 号"""
+    
+    nickname: str = ""
+    """昵称"""
+    
+    sex: str = "unknown"
+    """性别, male 或 female 或 unknown"""
+    
+    age: int = 0
+    """年龄"""
+
+
+@dataclass
+class LoginInfo:
+    """
+    登录号信息
+    """
+    user_id: int = 0
+    """QQ 号"""
+    
+    nickname: str = ""
+    """昵称"""
+
+
+@dataclass
+class VersionInfo:
+    """
+    版本信息
+    """
+    app_name: str = ""
+    """应用名称"""
+    
+    app_version: str = ""
+    """应用版本"""
+    
+    protocol_version: str = ""
+    """OneBot 标准版本"""
+
+
+@dataclass
+class Status:
+    """
+    运行状态
+    """
+    online: bool = False
+    """是否在线"""
+    
+    good: bool = True
+    """运行状态是否良好"""
+
+
+@dataclass
+class EssenceMessage:
+    """
+    精华消息
+    """
+    sender_id: int = 0
+    """发送者 QQ 号"""
+    
+    sender_nick: str = ""
+    """发送者昵称"""
+    
+    sender_time: int = 0
+    """发送时间"""
+    
+    operator_id: int = 0
+    """操作者 QQ 号"""
+    
+    operator_nick: str = ""
+    """操作者昵称"""
+    
+    operator_time: int = 0
+    """操作时间"""
+    
+    message_id: int = 0
+    """消息 ID"""
+
+
+@dataclass
+class CurrentTalkative:
+    """
+    龙王信息
+    """
+    user_id: int = 0
+    """QQ 号"""
+    
+    nickname: str = ""
+    """昵称"""
+    
+    avatar: str = ""
+    """头像 URL"""
+    
+    day_count: int = 0
+    """持续天数"""
+
+
+@dataclass
+class HonorInfo:
+    """
+    荣誉信息
+    """
+    user_id: int = 0
+    """QQ 号"""
+    
+    nickname: str = ""
+    """昵称"""
+    
+    avatar: str = ""
+    """头像 URL"""
+    
+    description: str = ""
+    """荣誉描述"""
+
+
+@dataclass
+class GroupHonorInfo:
+    """
+    群荣誉信息
+    """
+    group_id: int = 0
+    """群号"""
+    
+    current_talkative: Optional[CurrentTalkative] = None
+    """当前龙王"""
+    
+    talkative_list: List[HonorInfo] = field(default_factory=list)
+    """历史龙王"""
+    
+    performer_list: List[HonorInfo] = field(default_factory=list)
+    """群聊之火"""
+    
+    legend_list: List[HonorInfo] = field(default_factory=list)
+    """群聊炽焰"""
+    
+    strong_newbie_list: List[HonorInfo] = field(default_factory=list)
+    """冒尖小春笋"""
+    
+    emotion_list: List[HonorInfo] = field(default_factory=list)
+    """快乐源泉"""