环境变量池 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")遍历。
