功能使用手册
防刷屏
检测短时间内大量消息，并按阈值禁言、删除或封禁。
怎么用
操作目标
检测短时间内大量消息，并按阈值禁言、删除或封禁。
- 进入防刷屏规则 从垃圾防护或管理入口打开防刷屏配置。 该入口在代码中对应 flood 配置页。
- 设置阈值和动作 配置触发条数、时间窗口、处罚动作和清理策略。 活跃群应设置更宽松的阈值。
- 连续发送测试 用测试账号在时间窗口内连续发言，确认是否触发。 管理员豁免会影响测试结果。
开始前
前置条件
- 群消息处理器正常运行。
- 机器人拥有执行处罚动作所需权限。
实际使用
按用户实际体验操作
在 Telegram 私聊机器人发送 /start，先确认当前群组，再点击「防刷屏」。
进入后首先看到「防刷屏」。- 进入防刷屏规则：从垃圾防护或管理入口打开防刷屏配置。
- 设置阈值和动作：配置触发条数、时间窗口、处罚动作和清理策略。
- 连续发送测试：用测试账号在时间窗口内连续发言，确认是否触发。
这个功能主要通过按钮完成，不需要额外输入文本。
- 群消息处理器正常运行。
- 机器人拥有执行处罚动作所需权限。
- 如果页面提示权限、未开启或无效，先回到当前功能页补齐配置，再重新点击同一个按钮。
Telegram 操作流
跟着真实按钮操作
入口：私聊 /start 后点击「防刷屏」 页面：6 个 输入：全程按钮操作 群内：需要回到群内验证效果
第 1 / 6 页
@TgGroupRobot
管理员主菜单
发送 /start 后点击管理入口，按按钮选择当前群组。
点击「防刷屏」进入配置页。
当前群组：演示群
13:41 第 2 / 6 页
@TgGroupRobot
选择配置群组
私聊配置前先确认目标群组，后续按钮都会写入这个群。
可管理群：演示群、测试群
13:41 第 3 / 6 页
@TgGroupRobot
主菜单
这里展示机器人后台的真实功能入口。
13:41第 4 / 6 页
@TgGroupRobot
防刷屏
防刷屏使用同一组 gg 规则回调，按消息数量和时间窗口判断。
规则：短时间多消息、动作策略异常恢复：配置「防刷屏」时如果提示未开启、权限不足、无效或失败，先确认当前群组和机器人权限，再回到「防刷屏」重新操作。
13:41 第 5 / 6 页
@TgGroupRobot
操作结果
操作完成后，Bot 会刷新当前页面或返回上一级。
13:41第 6 / 6 页
@TgGroupRobot
防刷屏规则
调整阈值后，Bot 会回到同一个规则详情页。
13:41点击上方 Telegram 按钮开始；手机端按页面顺序往下点即可。
常见问题
常见问题
防刷屏会删除所有历史消息吗？
不会，只按配置清理触发相关消息和提示。