python-library-onebot-protocol 0.1.0

OneBot 风格消息载荷与消息段模型

onebot-protocol

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

特性

• 完整的消息段（Message Segment）类型：文本、提及、图片、语音、视频、文件、位置、回复等
• 图片、语音、音频、视频、文件段共用 FileData（name、content、mime_type、size）
• 支持 discriminated union，根据 type 字段自动解析消息类型

文件载荷 FileData

字段	说明
name	显示用文件名（可选）
content	内容引用，如 URL、平台资源标识或 Base64 等（可选，编码由实现方约定）
mime_type	MIME 类型（可选）
size	字节大小（可选）

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

支持的消息类型

类型	说明
text	纯文本
mention	@某人
mention_all	@所有人
image	图片
voice	语音
audio	音频
video	视频
file	文件
location	位置
reply	回复