OneBot 消息收发

发送群消息

# 纯文本
lumen.QClient.send_group_msg(group_id, "你好")

# 富文本（消息段数组）
lumen.QClient.send_group_msg(group_id, [
    lumen.msgbuilder.at(123456),
    lumen.msgbuilder.text(" 欢迎进群！"),
    lumen.msgbuilder.image("https://example.com/welcome.png"),
])

常用发送方法

方法	说明
send_group_msg(group_id, message)	发群消息
send_private_msg(user_id, message)	发私聊消息
send_group_forward_msg(group_id, messages)	发合并转发
delete_msg(message_id)	撤回消息
set_group_ban(group_id, user_id, duration)	禁言（秒，0=解禁）
set_group_whole_ban(group_id, enable)	全员禁言
set_group_kick(group_id, user_id, reject=False)	踢出群
set_group_card(group_id, user_id, card)	设置群名片
get_group_member_list(group_id, callback)	获取群成员列表
get_group_member_info(group_id, user_id, callback)	获取群成员信息
get_msg(message_id, callback)	获取消息详情

message 参数支持：字符串、单个消息段 dict、消息段 list，三种形式自动适配。

通用 action 调用

调用任意 OneBot v11 / NapCat / Lagrange / go-cqhttp 扩展 API，无需等待 LumenBridge 适配：

# 发送不等待回执
lumen.call_action("group_essence_emoji_like", {"group_id": 123, "message_id": 456})

# 发送并接收回执
def on_resp(data):
    lumen.logger.info(f"收到回执: {data}")
lumen.call_action("get_group_info", {"group_id": 123}, callback=on_resp)

---