联盟

联盟」是一组共享黑名单的群。在联盟内任一群发 /fban,被封禁的用户会立刻 在联盟里所有成员群被封禁,之后也无法再加入联盟内任何群。

联盟由 admin 创建(/fedcreate),创建群成为「联盟主群」。其他 群通过 /fedbind 申请加入,由联盟主群审批。

联盟结构

联盟(Federation)
├── 联盟主群(owner_group)  ← /fedcreate 时创建该联盟的群
│    └── 拥有审批入盟申请、解绑成员、配置日志频道的权限
└── 成员群 × N             ← /fedbind 加入

一个群同一时刻最多属于一个联盟。换联盟需要先 /fedunbind

/fedcreate <联盟名称>

字段
权限admin
场景群内(当前群必须未绑定联盟)
参数联盟名称(≤ 255 字符,全局唯一)

创建一个新联盟,当前群自动成为联盟主群

/fedcreate 半夏联盟

/fedbind <联盟ID 或 名称>

字段
权限admin
场景群内
参数联盟的 UUID 或名称

申请把当前群加入指定联盟。不是立即生效——申请被推送到联盟主群,由该群的 admin 审批同意后才真正绑定。

/fedunbind

字段
权限admin
场景群内
参数

主动退出当前群所在的联盟。退出后 /fban 在本群不再生效。

/fedkick <群 ID>

字段
权限联盟主群 admin
场景联盟主群内
参数要解绑的成员群 group_id

把某成员群从联盟踢出。被踢的群保留 Bot 但不再共享联盟黑名单。

/fedrequests

字段
权限联盟主群 admin
场景联盟主群内
参数

查看当前联盟的「待审批入盟申请」列表,每条带「同意 / 拒绝」按钮。

/fedmembers

字段
权限admin
场景群内(群已加入联盟)
参数

列出当前联盟的全部成员群(含主群)。

/fedinfo

字段
权限admin
场景群内
参数

查看当前群的联盟状态:未绑定 / 已绑定到某联盟 / 是某联盟的主群。

/fedlog [chat_id|off]

字段
权限联盟主群 admin
场景联盟主群内
参数目标频道 chat_id,或 off

获取频道 chat_id 方式: 复制频道内消息链接,例如复制得到 https://t.me/c/3906530141/5 其中 3906530141 就是我们需要的,此时我们需要补全,数字前补充 -100,得到的 -1003906530141 就是我们需要的 chat_id

为联盟绑定 / 解绑一个日志频道——/fban、成员变更、入盟审批结果等事件会同步推送到该频道,作为联盟级审计留痕。

用法说明
/fedlog查看当前绑定状态
/fedlog <频道chat_id>绑定 / 改绑日志频道
/fedlog off解绑

绑定前先把 Bot 拉进目标频道并赋予权限,否则日志推送会静默失败。