feat: use native Matrix Power Level to control check-in immunity and cross-room syncing

1. Added RoomManagerBot for cross-room permission and leave syncing based on native power levels.
3. Added invite() to MatrixSession and added onMemberLeave/onPowerLevel hooks to Dispatcher.
4. Updated README and example configs.
This commit is contained in:
eskima committed 2026-06-08 02:49:08 +08:00
1 parent 440f572834
commit 0a3843630a
16 files changed
+257 -154

No files matched your search

+20 -1
View File
@@ -30,7 +30,7 @@ bots:
adminPowerLevel: 100 # 房间内 power level ≥ 此值视为管理员(100=管理员、50=版主)
admins: [] # 额外管理员白名单(power level 之外的补充,可留空)
# - "@admin:example.com"
whitelist: [] # 永不踢出的用户(Super 等级也永不踢)
whitelist: [] # 额外的免踢白名单(注意:权限分 >= adminPowerLevel 的人已自动免死,无需填在此处。这里只填低权限但免踢的特权用户,比如机器人或老板账号)
# - "@vip:example.com"
# 示例:共享 main 账号的另一个 bot(实现后取消注释并启用)
@@ -38,3 +38,22 @@ bots:
# account: main
# rooms:
# - "!anotherRoom:example.com"
# =======================================================
# 原生权限联动保安 (room-manager)
# =======================================================
# 该机器人不靠命令驱动,而是监听 Matrix 原生权限(Power Level)。
# 管理员在客户端(Element)直接改成员权限,机器人会自动拉/踢人。
- name: room-manager
account: main
rooms:
- "!checkinRoomId:example.com" # 【务必】只填签到/管理房的ID!作为控制中枢。
config:
workRoom1: "!workRoom1Id:example.com" # 工作房 A (核心群)
workRoom2: "!workRoom2Id:example.com" # 工作房 B (普通群)
lostRoom: "!lostRoomId:example.com" # 失联房 (小黑屋)
# 分数映射 (对应 Element 客户端里的权限设定)
levelA: 50 # 最高权限(如版主50):进工作房1 + 进工作房2
levelB: 0 # 中等权限(如默认0) :踢出工作房1 + 保留在工作房2
levelC: -1 # 最低权限(如受限-1):踢出工作房1、2 + 丢进失联房