butterbot-python 3.1.0.dev1__py3-none-any.whl

butterbot/sources/bilibili/data/danmaku_gift_data.py

@@ -0,0 +1,135 @@
+from dataclasses import dataclass
+
+from butterbot.core.data import BaseDataMixin
+
+from .dto import BlindGiftInfoDto, DanmakuGiftDTO, GiftMedalInfoDto
+
+
+@dataclass(frozen=True)
+class GiftMedalData(BaseDataMixin):
+    """
+    送礼用户粉丝牌数据
+    """
+
+    level: int  # 粉丝牌等级
+    name: str  # 粉丝牌名称
+    anchor_room_id: int  # 粉丝牌对应主播房间号
+    anchor_uname: str  # 粉丝牌对应主播名称
+    guard_level: int  # 舰长等级 (0=无, 1=总督, 2=提督, 3=舰长)
+    is_lighted: int  # 粉丝牌是否点亮 (1=点亮, 0=未点亮)
+    anchor_uid: int  # 粉丝牌对应主播UID
+
+    @classmethod
+    def from_dto(cls, medal: GiftMedalInfoDto) -> "GiftMedalData":
+        """从GiftMedalInfoDto构造GiftMedalData实例"""
+        return cls(
+            level=medal.level,
+            name=medal.name,
+            anchor_room_id=medal.anchor_room_id,
+            anchor_uname=medal.anchor_uname,
+            guard_level=medal.guard_level,
+            is_lighted=medal.is_lighted,
+            anchor_uid=medal.target_id,
+        )
+
+
+@dataclass(frozen=True)
+class BlindGiftData(BaseDataMixin):
+    """
+    盲盒礼物数据（从盲盒中开出的礼物信息）
+    """
+
+    blind_gift_config_id: int  # 盲盒配置ID
+    original_gift_id: int  # 原始盲盒礼物ID
+    original_gift_name: str  # 原始盲盒礼物名称
+    original_gift_price: int  # 原始盲盒价格（电池）
+    gift_action: str  # 礼物动作描述（如"爆出"）
+    gift_tip_price: int  # 开出礼物的价值（电池）
+
+    @classmethod
+    def from_dto(cls, blind_gift: BlindGiftInfoDto) -> "BlindGiftData":
+        """从BlindGiftInfoDto构造BlindGiftData实例"""
+        return cls(
+            blind_gift_config_id=blind_gift.blind_gift_config_id,
+            original_gift_id=blind_gift.original_gift_id,
+            original_gift_name=blind_gift.original_gift_name,
+            original_gift_price=blind_gift.original_gift_price,
+            gift_action=blind_gift.gift_action,
+            gift_tip_price=blind_gift.gift_tip_price,
+        )
+
+
+@dataclass(frozen=True)
+class DanmakuGiftData(BaseDataMixin):
+    """
+    礼物消息数据
+    """
+
+    room_display_id: int  # 房间号
+    room_real_id: int  # 房间真实ID
+    gift_id: int  # 礼物ID
+    gift_name: str  # 礼物名称
+    gift_num: int  # 礼物数量
+    price: int  # 单个礼物价格（电池）
+    total_coin: int  # 总价值（电池）
+    coin_type: str  # 货币类型 (gold=电池)
+    action: str  # 动作描述（如"投喂"）
+    uid: int  # 送礼用户UID
+    uname: str  # 送礼用户名
+    face: str  # 送礼用户头像URL
+    guard_level: int  # 舰长等级 (0=无, 1=总督, 2=提督, 3=舰长)
+    wealth_level: int  # 荣耀等级
+    receiver_uid: int  # 收礼用户UID（主播）
+    receiver_uname: str  # 收礼用户名（主播）
+    receiver_face: str  # 收礼用户头像URL（主播）
+    receiver_official_title: str  # 认证描述
+    medal: GiftMedalData | None  # 粉丝牌信息
+    blind_gift: BlindGiftData | None  # 盲盒礼物信息
+    timestamp: int  # 发送时间戳
+    is_first: bool  # 是否首次送礼
+    combo_total_coin: int  # 连击总价值
+    gift_gif: str  # 礼物动图URL
+    gift_img: str  # 礼物图片URL
+
+    @classmethod
+    def from_dto(cls, dto: DanmakuGiftDTO) -> "DanmakuGiftData":
+        """从DTO对象构造DanmakuGiftData实例
+
+        Args:
+            dto: DanmakuGiftDTO对象
+
+        Returns:
+            DanmakuGiftData实例
+        """
+        medal_data = GiftMedalData.from_dto(dto.medal) if dto.medal else None
+        blind_gift_data = (
+            BlindGiftData.from_dto(dto.blind_gift) if dto.blind_gift else None
+        )
+
+        return cls(
+            room_display_id=dto.room_display_id,
+            room_real_id=dto.room_real_id,
+            gift_id=dto.gift_id,
+            gift_name=dto.gift_name,
+            gift_num=dto.gift_num,
+            price=dto.price,
+            total_coin=dto.total_coin,
+            coin_type=dto.coin_type,
+            action=dto.action,
+            uid=dto.sender.uid,
+            uname=dto.sender.uname,
+            face=dto.sender.face,
+            guard_level=dto.sender.guard_level,
+            wealth_level=dto.sender.wealth_level,
+            receiver_uid=dto.receiver.uid,
+            receiver_uname=dto.receiver.uname,
+            receiver_face=dto.receiver.face,
+            receiver_official_title=dto.receiver.official_title,
+            medal=medal_data,
+            blind_gift=blind_gift_data,
+            timestamp=dto.timestamp,
+            is_first=dto.is_first,
+            combo_total_coin=dto.combo_total_coin,
+            gift_gif=dto.gift_info.gif if dto.gift_info else "",
+            gift_img=dto.gift_info.img_basic if dto.gift_info else "",
+        )

butterbot/sources/bilibili/data/danmaku_guard_data.py

@@ -0,0 +1,54 @@
+from dataclasses import dataclass
+
+from butterbot.core.data import BaseDataMixin
+
+from .dto import DanmakuGuardDTO
+
+# 舰长等级名称映射
+GUARD_LEVEL_NAME = {
+    1: "总督",
+    2: "提督",
+    3: "舰长",
+}
+
+
+@dataclass(frozen=True)
+class DanmakuGuardData(BaseDataMixin):
+    """
+    上舰事件数据
+    guard_level: 舰长等级 (1=总督, 2=提督, 3=舰长)
+    """
+
+    room_display_id: int  # 房间号
+    room_real_id: int  # 房间真实ID
+    uid: int  # 用户UID
+    username: str  # 用户名
+    guard_level: int  # 舰长等级 (1=总督, 2=提督, 3=舰长)
+    guard_name: str  # 舰长等级名称（如"舰长"）
+    num: int  # 购买数量
+    price: int  # 价格（电池）
+    gift_id: int  # 礼物ID
+    gift_name: str  # 礼物名称（如"舰长"）
+
+    @classmethod
+    def from_dto(cls, dto: DanmakuGuardDTO) -> "DanmakuGuardData":
+        """从DTO对象构造DanmakuGuardData实例
+
+        Args:
+            dto: DanmakuGuardDTO对象
+
+        Returns:
+            DanmakuGuardData实例
+        """
+        return cls(
+            room_display_id=dto.room_display_id,
+            room_real_id=dto.room_real_id,
+            uid=dto.uid,
+            username=dto.username,
+            guard_level=dto.guard_level,
+            guard_name=GUARD_LEVEL_NAME.get(dto.guard_level, "未知类型"),
+            num=dto.num,
+            price=dto.price,
+            gift_id=dto.gift_id,
+            gift_name=dto.gift_name,
+        )

butterbot/sources/bilibili/data/danmaku_msg_data.py

@@ -0,0 +1,71 @@
+from dataclasses import dataclass
+
+from butterbot.core.data import BaseDataMixin
+
+from .dto import DanmakuMsgDTO, MedalInfoDto
+
+
+@dataclass(frozen=True)
+class MedalData(BaseDataMixin):
+    """
+    粉丝牌数据
+    """
+
+    level: int  # 粉丝牌等级
+    name: str  # 粉丝牌名称
+    anchor_name: str  # 粉丝牌对应主播名
+    room_id: int  # 粉丝牌对应主播房间号
+    is_light: int  # 粉丝牌是否点亮 (1=点亮, 0=未点亮)
+    anchor_uid: int  # 粉丝牌对应主播UID
+
+    @classmethod
+    def from_dto(cls, medal: MedalInfoDto) -> "MedalData":
+        """从MedalInfo DTO构造MedalData实例"""
+        return cls(
+            level=medal.level,
+            name=medal.name,
+            anchor_name=medal.anchor_name,
+            room_id=medal.room_id,
+            is_light=medal.is_light,
+            anchor_uid=medal.anchor_uid,
+        )
+
+
+@dataclass(frozen=True)
+class DanmakuMsgData(BaseDataMixin):
+    """
+    弹幕消息数据
+    """
+
+    room_display_id: int  # 房间号
+    room_real_id: int  # 房间真实ID
+    message: str  # 弹幕内容
+    uid: int  # 用户UID
+    username: str  # 用户名
+    user_level: int  # 用户等级
+    face: str | None  # 头像URL
+    medal: MedalData | None  # 粉丝牌信息
+    timestamp: int  # 发送时间戳
+
+    @classmethod
+    def from_dto(cls, dto: DanmakuMsgDTO) -> "DanmakuMsgData":
+        """从DTO对象构造DanmakuMsgData实例
+
+        Args:
+            dto: DanmakuMsgDTO对象
+
+        Returns:
+            DanmakuMsgData实例
+        """
+        medal_data = MedalData.from_dto(dto.medal) if dto.medal else None
+        return cls(
+            room_display_id=dto.room_display_id,
+            room_real_id=dto.room_real_id,
+            message=dto.message,
+            uid=dto.user.uid,
+            username=dto.user.username,
+            user_level=dto.user.user_level,
+            face=dto.user.face,
+            medal=medal_data,
+            timestamp=dto.timestamp,
+        )

butterbot/sources/bilibili/data/dto/__init__.py

@@ -0,0 +1,59 @@
+from .danmaku_gift_dto import (
+    BlindGiftInfoDto,
+    DanmakuGiftDTO,
+    GiftInfoDto,
+    GiftMedalInfoDto,
+    GiftReceiverDto,
+    GiftSenderDto,
+)
+from .danmaku_guard_buy_dto import (
+    DanmakuGuardDTO,
+)
+from .danmaku_msg_dto import (
+    DanmakuMsgDTO,
+    MedalInfoDto,
+    UserInfoDto,
+)
+from .dynamic_dto import (
+    ArticleDto,
+    AuthorDto,
+    DynamicDTO,
+    LiveRcmdDto,
+    MusicDto,
+    StatDto,
+    VideoDto,
+)
+from .live_room_dto import (
+    AnchorInfoDto,
+    LiveRoomDTO,
+    NoticeBoardDto,
+    RoomInfoDto,
+    WatchedShowDto,
+)
+from .video_part_dto import VideoPartDto
+
+__all__ = [
+    "AnchorInfoDto",
+    "ArticleDto",
+    "AuthorDto",
+    "BlindGiftInfoDto",
+    "DanmakuGiftDTO",
+    "DanmakuGuardDTO",
+    "DanmakuMsgDTO",
+    "DynamicDTO",
+    "GiftInfoDto",
+    "GiftMedalInfoDto",
+    "GiftReceiverDto",
+    "GiftSenderDto",
+    "LiveRcmdDto",
+    "LiveRoomDTO",
+    "MedalInfoDto",
+    "MusicDto",
+    "NoticeBoardDto",
+    "RoomInfoDto",
+    "StatDto",
+    "UserInfoDto",
+    "VideoDto",
+    "VideoPartDto",
+    "WatchedShowDto",
+]

butterbot/sources/bilibili/data/dto/danmaku_gift_dto.py

@@ -0,0 +1,193 @@
+from logging import getLogger
+from typing import ClassVar
+
+from butterbot.core.data import BaseDataModel
+
+_log = getLogger("DanmakuGiftDTO")
+
+
+class BlindGiftInfoDto(BaseDataModel):
+    """
+    盲盒礼物信息（从盲盒中开出的礼物）
+    """
+
+    blind_gift_config_id: int  # 盲盒配置ID
+    original_gift_id: int  # 原始盲盒礼物ID
+    original_gift_name: str  # 原始盲盒礼物名称
+    original_gift_price: int  # 原始盲盒价格（电池）
+    gift_action: str  # 礼物动作描述（如"爆出"）
+    gift_tip_price: int  # 开出礼物的价值（电池）
+
+
+class GiftMedalInfoDto(BaseDataModel):
+    """
+    送礼用户的粉丝牌信息
+    """
+
+    level: int  # 勋章等级
+    name: str  # 勋章名称
+    anchor_room_id: int  # 主播房间号
+    anchor_uname: str  # 主播名称（可能为空）
+    guard_level: int  # 舰长等级 (0=无, 1=总督, 2=提督, 3=舰长)
+    is_lighted: int  # 是否点亮 (1=点亮, 0=未点亮)
+    target_id: int  # 勋章对应主播UID
+
+
+class GiftInfoDto(BaseDataModel):
+    """
+    礼物资源信息
+    """
+
+    img_basic: str  # 礼物基础图片URL
+    gif: str  # 礼物动图URL
+    webp: str  # 礼物webp图片URL
+
+
+class GiftSenderDto(BaseDataModel):
+    """
+    送礼用户信息
+    """
+
+    uid: int  # 用户UID
+    uname: str  # 用户名
+    face: str  # 头像URL
+    guard_level: int  # 舰长等级 (0=无, 1=总督, 2=提督, 3=舰长)
+    wealth_level: int  # 荣耀等级
+
+
+class GiftReceiverDto(BaseDataModel):
+    """
+    收礼用户信息（主播）
+    """
+
+    uid: int  # 用户UID
+    uname: str  # 用户名
+    face: str  # 头像URL
+    official_title: str  # 认证描述
+
+
+class DanmakuGiftDTO(BaseDataModel):
+    """
+    礼物消息DTO
+    """
+
+    discriminator_value: ClassVar[str] = "danmaku_gift"  # 数据类型标识
+
+    room_display_id: int  # 房间号
+    room_real_id: int  # 房间真实ID
+    gift_id: int  # 礼物ID
+    gift_name: str  # 礼物名称
+    gift_num: int  # 礼物数量
+    price: int  # 单个礼物价格（电池）
+    total_coin: int  # 总价值（电池）
+    coin_type: str  # 货币类型 (gold=电池, silver=银瓜子)
+    action: str  # 动作描述（如"投喂"）
+    sender: GiftSenderDto  # 送礼用户信息
+    receiver: GiftReceiverDto  # 收礼用户信息（主播）
+    medal: GiftMedalInfoDto | None = None  # 粉丝牌信息
+    gift_info: GiftInfoDto | None = None  # 礼物资源信息
+    blind_gift: BlindGiftInfoDto | None = None  # 盲盒礼物信息
+    timestamp: int = 0  # 发送时间戳
+    is_first: bool = False  # 是否首次送礼 (单次送礼, 无连击)
+    combo_total_coin: int = 0  # 连击总价值
+
+    @classmethod
+    def from_raw(cls, data: dict) -> "DanmakuGiftDTO | None":
+        """
+        从原始API数据构造DTO对象
+        """
+        try:
+            room_display_id = data.get("room_display_id", 0)
+            room_real_id = data.get("room_real_id", 0)
+
+            # 获取内层data
+            gift_data = data.get("data", {}).get("data", {})
+
+            # 送礼用户信息
+            sender = {
+                "uid": gift_data.get("uid", 0),
+                "uname": gift_data.get("uname", ""),
+                "face": gift_data.get("face", ""),
+                "guard_level": gift_data.get("guard_level", 0),
+                "wealth_level": gift_data.get("wealth_level", 0),
+            }
+
+            # 收礼用户信息（主播）
+            receiver_uinfo = gift_data.get("receiver_uinfo", {})
+            receiver_base = receiver_uinfo.get("base", {})
+            receiver = {
+                "uid": receiver_uinfo.get("uid", 0),
+                "uname": receiver_base.get("name", ""),
+                "face": receiver_base.get("face", ""),
+                "official_title": receiver_base.get("official_info", {}).get(
+                    "title", ""
+                ),
+            }
+
+            # 粉丝牌信息
+            medal = None
+            medal_info = gift_data.get("medal_info", {})
+            if medal_info:
+                medal = {
+                    "level": medal_info.get("medal_level", 0),
+                    "name": medal_info.get("medal_name", ""),
+                    "anchor_room_id": medal_info.get("anchor_roomid", 0),
+                    "anchor_uname": medal_info.get("anchor_uname", ""),
+                    "guard_level": medal_info.get("guard_level", 0),
+                    "is_lighted": medal_info.get("is_lighted", 0),
+                    "target_id": medal_info.get("target_id", 0),
+                }
+
+            # 礼物资源信息
+            gift_info = None
+            gift_info_data = gift_data.get("gift_info", {})
+            if gift_info_data:
+                gift_info = {
+                    "img_basic": gift_info_data.get("img_basic", ""),
+                    "gif": gift_info_data.get("gif", ""),
+                    "webp": gift_info_data.get("webp", ""),
+                }
+
+            # 盲盒礼物信息
+            blind_gift = None
+            blind_gift_data = gift_data.get("blind_gift")
+            if blind_gift_data:
+                blind_gift = {
+                    "blind_gift_config_id": blind_gift_data.get(
+                        "blind_gift_config_id", 0
+                    ),
+                    "original_gift_id": blind_gift_data.get("original_gift_id", 0),
+                    "original_gift_name": blind_gift_data.get("original_gift_name", ""),
+                    "original_gift_price": blind_gift_data.get(
+                        "original_gift_price", 0
+                    ),
+                    "gift_action": blind_gift_data.get("gift_action", ""),
+                    "gift_tip_price": blind_gift_data.get("gift_tip_price", 0),
+                }
+
+            # 构造标准化字典后使用model_validate
+            normalized_data = {
+                "room_display_id": room_display_id,
+                "room_real_id": room_real_id,
+                "gift_id": gift_data.get("giftId", 0),
+                "gift_name": gift_data.get("giftName", ""),
+                "gift_num": gift_data.get("num", 1),
+                "price": gift_data.get("price", 0),
+                "total_coin": gift_data.get("total_coin", 0),
+                "coin_type": gift_data.get("coin_type", "gold"),
+                "action": gift_data.get("action", ""),
+                "sender": sender,
+                "receiver": receiver,
+                "medal": medal,
+                "gift_info": gift_info,
+                "blind_gift": blind_gift,
+                "timestamp": gift_data.get("timestamp", 0),
+                "is_first": gift_data.get("is_first", False),
+                "combo_total_coin": gift_data.get("combo_total_coin", 0),
+            }
+
+            return cls.model_validate(normalized_data)
+
+        except Exception as e:
+            _log.error("解析礼物消息失败: %s", e)
+            return None

butterbot/sources/bilibili/data/dto/danmaku_guard_buy_dto.py

@@ -0,0 +1,54 @@
+from logging import getLogger
+from typing import ClassVar
+
+from butterbot.core.data import BaseDataModel
+
+_log = getLogger("DanmakuGuardDTO")
+
+
+class DanmakuGuardDTO(BaseDataModel):
+    """
+    舰长事件 DTO
+    guard_level: 舰长等级 (1=总督, 2=提督, 3=舰长)
+    """
+
+    discriminator_value: ClassVar[str] = "guard"  # 数据类型标识
+
+    room_display_id: int  # 房间号
+    room_real_id: int  # 房间真实ID
+    uid: int  # 用户UID
+    username: str  # 用户名
+    guard_level: int  # 舰长等级 (1=总督, 2=提督, 3=舰长)
+    num: int  # 购买数量
+    price: int  # 价格（电池）
+    gift_id: int  # 礼物ID
+    gift_name: str  # 礼物名称（如"舰长"）
+
+    @classmethod
+    def from_raw(cls, data: dict) -> "DanmakuGuardDTO | None":
+        """
+        从原始API数据构造DTO对象
+        """
+        try:
+            room_display_id = data.get("room_display_id", 0)
+            room_real_id = data.get("room_real_id", 0)
+
+            guard_data = data.get("data", {}).get("data", {})
+
+            normalized_data = {
+                "room_display_id": room_display_id,
+                "room_real_id": room_real_id,
+                "uid": guard_data.get("uid", 0),
+                "username": guard_data.get("username", ""),
+                "guard_level": guard_data.get("guard_level", 3),
+                "num": guard_data.get("num", 1),
+                "price": guard_data.get("price", 0),
+                "gift_id": guard_data.get("gift_id", 0),
+                "gift_name": guard_data.get("gift_name", ""),
+            }
+
+            return cls.model_validate(normalized_data)
+
+        except Exception as e:
+            _log.error("解析上舰数据失败: %s", e, exc_info=True)
+            return None

butterbot/sources/bilibili/data/dto/danmaku_msg_dto.py

@@ -0,0 +1,123 @@
+from logging import getLogger
+from typing import ClassVar
+
+from butterbot.core.data import BaseDataModel
+
+_log = getLogger("DanmakuMsgDTO")
+
+
+class MedalInfoDto(BaseDataModel):
+    """
+    粉丝牌信息
+    Tips:
+        如果当前直播间或者用户开启了"优先展示当前直播间的粉丝勋章
+        那么在该直播间无法获取到用户佩戴的其他主播的勋章信息"
+    """
+
+    level: int  # 勋章等级
+    name: str  # 勋章名称
+    anchor_name: str  # 主播名称
+    room_id: int  # 主播房间号
+    is_light: int  # 是否点亮 (1=点亮, 0=未点亮)
+    anchor_uid: int  # 主播UID
+
+
+class UserInfoDto(BaseDataModel):
+    """
+    用户基本信息
+    """
+
+    uid: int  # 用户UID
+    username: str  # 用户名
+    user_level: int  # 用户等级
+    face: str | None = None  # 头像URL
+
+
+class DanmakuMsgDTO(BaseDataModel):
+    """
+    弹幕消息DTO
+    """
+
+    discriminator_value: ClassVar[str] = "danmaku_msg"  # 数据类型标识
+
+    room_display_id: int  # 房间号
+    room_real_id: int  # 房间真实ID
+    message: str  # 弹幕内容
+    user: UserInfoDto  # 用户信息
+    medal: MedalInfoDto | None = None  # 粉丝牌信息
+    timestamp: int = 0  # 发送时间戳
+
+    @classmethod
+    def from_raw(cls, data: dict) -> "DanmakuMsgDTO | None":
+        """
+        从原始API数据构造DTO对象
+        注意: 由于弹幕数据格式特殊(数组形式), 需要先转换为字典格式
+        """
+        try:
+            room_display_id = data.get("room_display_id", 0)
+            room_real_id = data.get("room_real_id", 0)
+
+            # 获取info数组
+            info = data.get("data", {}).get("info", [])
+
+            # 提取弹幕内容 info[1]
+            message = info[1] if len(info) > 1 else ""
+
+            # 提取用户基本信息 info[2]: [uid, username, admin, vip, svip, ...]
+            user_basic = info[2] if len(info) > 2 else []
+            uid = user_basic[0] if len(user_basic) > 0 else 0
+            username = user_basic[1] if len(user_basic) > 1 else ""
+
+            # 提取用户等级信息 info[4]: [level, ...]
+            level_info = info[4] if len(info) > 4 else []
+            user_level = level_info[0] if len(level_info) > 0 else 0
+
+            # 提取头像 info[0][15].user.base
+            face = None
+            info_detail = info[0] if len(info) > 0 else []
+            if isinstance(info_detail, list) and len(info_detail) > 15:
+                user_detail_obj = info_detail[15]
+                if isinstance(user_detail_obj, dict):
+                    user_detail = user_detail_obj.get("user", {})
+                    if user_detail:
+                        base_info = user_detail.get("base", {})
+                        face = base_info.get("face")
+
+            # 提取粉丝牌信息 info[3]: [level, name, anchor_name, room_id, color, ...]
+            medal_info = None
+            medal_data = info[3] if len(info) > 3 else []
+            if medal_data and len(medal_data) > 0:
+                medal_info = {
+                    "level": medal_data[0] if len(medal_data) > 0 else 0,
+                    "name": medal_data[1] if len(medal_data) > 1 else "",
+                    "anchor_name": medal_data[2] if len(medal_data) > 2 else "",
+                    "room_id": medal_data[3] if len(medal_data) > 3 else 0,
+                    "is_light": medal_data[11] if len(medal_data) > 11 else 0,
+                    "anchor_uid": medal_data[12] if len(medal_data) > 12 else 0,
+                }
+
+            # 提取时间戳 info[9].ts
+            timestamp = 0
+            if len(info) > 9 and isinstance(info[9], dict):
+                timestamp = info[9].get("ts", 0)
+
+            # 构造标准化字典后使用model_validate
+            normalized_data = {
+                "room_display_id": room_display_id,
+                "room_real_id": room_real_id,
+                "message": message,
+                "user": {
+                    "uid": uid,
+                    "username": username,
+                    "user_level": user_level,
+                    "face": face,
+                },
+                "medal": medal_info,
+                "timestamp": timestamp,
+            }
+
+            return cls.model_validate(normalized_data)
+
+        except Exception as e:
+            _log.error("解析弹幕数据失败: %s", e, exc_info=True)
+            return None