消息段构建器 msgbuilder
lumen.msgbuilder 提供 OneBot v11 消息段的快捷构建函数：
| 函数 | 说明 | 示例 |
|---|---|---|
text(str) | 纯文本 | text("你好") |
at(qq) | @某人 | at(123456) |
face(id) | QQ 表情 | face(178) |
image(file) | 图片（支持 URL / 本地路径 / bytes / base64） | image("https://...") |
reply(message_id) | 回复 | reply(12345) |
poke(qq) | 戳一戳 | poke(123456) |
video(file) | 视频 | video("/path/to.mp4") |
record(file) | 语音 | record("/path/to.mp3") |
format_message(msg) | 统一格式化（字符串/段/列表互转） | format_message("hi") |
合并转发构建器
python
from endstone_lumenbridge.onebot.message import ForwardMessageBuilder
fwd = ForwardMessageBuilder()
fwd.add_custom_message("小助手", 10001, "第一条消息")
fwd.add_custom_message("小助手", 10001, [
lumen.msgbuilder.text("第二条 "),
lumen.msgbuilder.at(123456),
])
fwd.add_message_by_id(67890) # 引用已有消息
lumen.QClient.send_group_forward_msg(group_id, fwd.build())