K2cr2O1
c708761726
重构广播功能，从简单的回复转发模式改为更安全的会话模式： 1. 添加会话状态管理，60秒超时自动取消 2. 支持直接发送消息内容而非必须回复 3. 使用合并转发消息格式发送广播内容 4. 改进错误处理和状态报告 5. 添加类型提示和文档注释 同时修改相关API和模型： 1. 在GroupInfo中添加群备注和全员禁言字段 2. 改进get_forward_msg返回类型和兼容性处理 3. 清理不必要的Optional导入
245 lines
4.0 KiB
Python
245 lines
4.0 KiB
Python
"""
|
|
API 响应数据模型模块
|
|
|
|
定义了 API 返回的数据结构。
|
|
"""
|
|
from dataclasses import dataclass, field
|
|
from typing import List, Optional
|
|
|
|
|
|
@dataclass(slots=True)
|
|
class GroupInfo:
|
|
"""
|
|
群信息
|
|
"""
|
|
group_id: int = 0
|
|
"""群号"""
|
|
|
|
group_name: str = ""
|
|
"""群名称"""
|
|
|
|
member_count: int = 0
|
|
"""成员数"""
|
|
|
|
max_member_count: int = 0
|
|
"""最大成员数"""
|
|
|
|
group_remark: str = ""
|
|
"""群备注"""
|
|
|
|
group_all_shut: 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)
|
|
"""快乐源泉"""
|