Files
matrix-bot/config/bots.example.yaml
T
eskima 0a3843630a 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.
2026-06-08 02:49:08 +08:00

60 lines
3.1 KiB
YAML

# 账号:每个唯一账号只会登录一次并复用一个 client。
# 多个 bot 引用同一 account ⇒ 共享账号;引用不同 account ⇒ 独立身份。
#
# homeServer 填账号域名即可(如 https://matrix.org),程序会自动通过
# /.well-known/matrix/client 发现真实 API 地址。
# 也可直接填真实 API 地址跳过发现。
#
# 密码用 env(VAR_NAME) 引用环境变量,避免明文密码入版本库。
# 在 .env 文件中设置对应的环境变量(参见 .env.example)。
accounts:
main:
homeServer: "https://matrix.example.com"
userId: "@mybot:example.com"
password: "env(MAIN_PW)"
checkin:
homeServer: "https://matrix.example.com"
userId: "@checkin:example.com"
password: "env(CHECKIN_PW)"
# 每个 bot 是一个独立功能模块,声明用哪个账号、管哪些房间、私有配置。
bots:
- name: checkin
account: checkin
rooms:
- "!yourRoomId:example.com" # 替换为真实 Matrix 房间 ID(以 ! 开头)
config:
mainRoom: "!yourRoomId:example.com" # 日报/月报发送的目标房间(默认取 rooms[0])
kickDays: 30 # 未签到超过多少天触发自动踢人
autoKick: false # true 时每日日报后自动踢出长期未签到用户
adminPowerLevel: 100 # 房间内 power level ≥ 此值视为管理员(100=管理员、50=版主)
admins: [] # 额外管理员白名单(power level 之外的补充,可留空)
# - "@admin:example.com"
whitelist: [] # 额外的免踢白名单(注意:权限分 >= adminPowerLevel 的人已自动免死,无需填在此处。这里只填低权限但免踢的特权用户,比如机器人或老板账号)
# - "@vip:example.com"
# 示例:共享 main 账号的另一个 bot(实现后取消注释并启用)
# - name: notify
# 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 + 丢进失联房