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:
1 parent
440f572834
commit
0a3843630a
16 files changed
+257
-154
No files matched your search
@@ -86,20 +86,16 @@ docker compose logs -f # 看日志
|
||||
|---|---|
|
||||
| `!checkin` 或 直接发「签到」 | 今日签到(全角「!签到」也可) |
|
||||
| `!list <用户ID\|all> [--raw]` | 查询签到状态,`--raw` 输出 JSON |
|
||||
| `!level set <用户ID> <等级>` | 设置等级(等级支持中文「黄金」或英文 `gold`)**🔒 管理员** |
|
||||
| `!level raise <用户ID>` | 提升一级 **🔒 管理员** |
|
||||
| `!level super <用户ID>` | 赋予超级管理(免统计/免踢)**🔒 管理员** |
|
||||
| `!level clear <用户ID>` | 清除等级为青铜 **🔒 管理员** |
|
||||
| `!reset` | 重置所有人当日签到状态 **🔒 管理员** |
|
||||
| `!test daily\|monthly` | 手动触发日报/月报(运维测试用)**🔒 管理员** |
|
||||
| `!echo <文本>` / `!ping` / `!help` | 杂项 |
|
||||
|
||||
等级:超级管理 / 青铜 / 白银 / 黄金 / 铂金 / 钻石(内部存英文 key,仅展示转中文)。
|
||||
签到等级(青铜 / 白银 / 黄金 / 铂金 / 钻石)将根据用户的累计签到次数纯自动升级,仅作趣味展示。
|
||||
|
||||
> **🔒 管理员命令权限**:`level` / `reset` / `test` 仅 **房间内 power level ≥ `adminPowerLevel`(默认 100)**
|
||||
> 或在 `config.admins` 白名单中的用户可调用,其他人发送会被拒绝。这是信任根 —— DB 里的「超级管理」
|
||||
> 等级只表示免统计/免踢,**不等于**命令权限。power level 在 Element 的「房间设置 → 权限」里给成员调整
|
||||
> (100=管理员、50=版主);`admins` 留空即纯按 power level 判定,无需写死名单。
|
||||
> **🔒 管理员权限与免死特权**:
|
||||
> `reset` / `test` 等管理命令仅 **房间内 power level ≥ `adminPowerLevel`(默认 100)** 或在 `config.admins` 白名单中的用户可调用。
|
||||
> 同时,**只要用户的原生权限分达到了管理员级别,就会在每天凌晨的清理逻辑中被自动“免死”**(即使长期不签到也不会被踢)。
|
||||
> 所有权限调整请直接在 Element 客户端的「房间设置 → 权限」里通过原生 UI 操作,无需手动输入命令。
|
||||
|
||||
### 定时任务
|
||||
- **每日 03:00**:生成签到日报(按今日未签到 / ≥7 / ≥14 / ≥30 天 / 从未签到分桶),
|
||||
@@ -117,6 +113,30 @@ docker compose logs -f # 看日志
|
||||
| `adminPowerLevel` | 100 | 房间内 power level ≥ 此值即视为管理员(100=管理员、50=版主) |
|
||||
| `admins` | [] | 额外管理员白名单(power level 之外的补充,可留空) |
|
||||
|
||||
## 权限同步机器人 (Room Manager)
|
||||
|
||||
该机器人不靠命令驱动,而是**监听 Matrix 原生的权限分(Power Level)变化以及人员离开事件**。
|
||||
1. **权限联动**:管理员只需在客户端(如 Element)的签到房间设置里,点开用户头像修改权限等级,机器人就会自动将该用户跨群调配到不同的工作房或小黑屋中。
|
||||
2. **踢出联动**:如果某个用户主动退出了签到房,或者因为长期不打卡被签到机器人踢出了签到房,该机器人也会立即将其视为“失去大本营身份”,自动将其从所有工作房踢出,并丢进失联房。
|
||||
|
||||
| 原生权限分 | 内部级别 | 默认自动执行的操作 |
|
||||
|---|---|---|
|
||||
| `≥ levelA` | 最高权限 (如版主 50) | 邀请进**工作房1**,邀请进**工作房2** |
|
||||
| `== levelB`| 中等权限 (如默认 0) | 从**工作房1**踢出,邀请进**工作房2** |
|
||||
| `≤ levelC` | 最低权限 (如受限 -1) | 从**工作房1、2**踢出,邀请进**失联房** |
|
||||
|
||||
### room-manager 配置项(`config/bots.yaml` 的 `config`)
|
||||
| 字段 | 说明 |
|
||||
|---|---|
|
||||
| `workRoom1` | 高级工作群 ID(最高权限才能进) |
|
||||
| `workRoom2` | 普通工作群 ID(中高权限能进) |
|
||||
| `lostRoom` | 失联小黑屋 ID(最低权限进入) |
|
||||
| `levelA` | 最高权限的分数阈值,默认为 `50` |
|
||||
| `levelB` | 中等权限的分数,默认为 `0` |
|
||||
| `levelC` | 最低权限的分数阈值,默认为 `-1` |
|
||||
|
||||
> **注意**:`room-manager` 机器人的 `rooms` 数组中,应当**只填写**“签到/管理房”的 ID。机器人只会在这个房间里当“保安”监听原生权限变化,然后往外执行踢/拉操作。
|
||||
|
||||
## 新增一个机器人(例:notify)
|
||||
1. 新建 `src/bots/notify/notify.bot.ts`,`implements RoomBot`,类上加 `@RegisterBot()`。
|
||||
2. 新建 `notify.module.ts`,`providers: [NotifyBot]`。
|
||||
|
||||
Reference in new issue
Block a user