Skip to content

环境变量池 env

lumen.env 是全局共享变量池,所有子插件和核心模块共享:

python
# 读取(含内置动态变量)
group = lumen.env.get("main_group")    # 当前主群号(多群配置时返回第一个)
admins = lumen.env.get("admin_qq")     # 管理员 QQ 集合
custom = lumen.env.get("my_key", "default_value")

# 写入(自动触发 env.update.<key> 和 env.update 事件)
lumen.env.set("my_key", "my_value")

内置变量

变量名说明
main_group当前事件来源群号(多群自适应);非事件上下文返回首个主群
main_groups全部主群列表(list[int]),广播场景使用
admin_qq管理员 QQ 集合

多群适配main_group 在 OneBot 事件回调中会自动返回当前消息来源群(由事件分发器注入线程上下文),因此旧子插件 if gid == env.get("main_group") 风格的过滤代码无需修改即可在所有主群生效。需要向全部主群广播时(如定时通知),请用 env.get("main_groups") 遍历。


基于 MIT 许可协议发布