抽象send方法,添加注释

This commit is contained in:
2026-01-01 17:58:17 +08:00
parent 9146ffbb1a
commit 046dd0860f
9 changed files with 366 additions and 38 deletions

View File

@@ -1,17 +1,42 @@
"""
发送者模型模块
定义了 Sender 类,用于封装 OneBot 11 的发送者信息。
"""
from dataclasses import dataclass
from typing import Optional
@dataclass
class Sender:
"""
发送者信息类,对应 OneBot 11 标准中的 sender 字段
"""
user_id: int
"""发送者 QQ 号"""
nickname: str
"""昵称"""
sex: str = "unknown"
"""性别male 或 female 或 unknown"""
age: int = 0
"""年龄"""
# 群聊特有字段
card: Optional[str] = None # 群名片
area: Optional[str] = None # 地区
level: Optional[str] = None # 等级
role: Optional[str] = None # 角色: owner/admin/member
title: Optional[str] = None # 专属头衔
card: Optional[str] = None
"""群名片/备注"""
area: Optional[str] = None
"""地区"""
level: Optional[str] = None
"""成员等级"""
role: Optional[str] = None
"""角色owner 或 admin 或 member"""
title: Optional[str] = None
"""专属头衔"""