onebot-protocol

OneBot 通信协议，定义消息收发的公共数据结构。基于 OneBot 11 标准，使用 Pydantic 提供类型安全的模型定义。

模块职责：models.py 定义全部公共消息模型与兼容归一化；__init__.py 只导出稳定名称。

MessagePayload（OneBot 11 字段名）

解析时仍接受旧名别名：source_type→message_type、bot_id→self_id、messages→message、session_id→group_id/user_id。

Adapter 应无损上报消息，并用 mentioned_self 传递寻址事实；是否触发回复由宿主业务层决定，不属于协议模型的过滤职责。

特性

• 消息段类型包含文本、提及、图片、语音、视频、文件、位置、回复和合并转发
• 图片、语音、音频、视频、文件段共用 FileData（name、content、mime_type、size）
• 支持 discriminated union，根据 type 字段自动解析消息类型

文件载荷 FileData

image / voice / audio / video / file 各段类型的 data 均为对应子类，字段与 FileData 相同。

支持的消息类型

合并转发

forward.data 包含 message_id 和 content。content 中每个节点可带 user_id、nickname、time 与 message；message 使用相同的消息段模型，因此可以继续包含 forward。