黑白名单配置使用教程
一、功能主界面总览
页面顶部为功能操作栏与自动开关，下方为名单数据列表，展示所有已录入的黑白名单账号。
1. 顶部操作按钮
- + 添加：蓝色按钮，打开添加弹窗，批量新增黑名单/白名单账号
- 清空：橙色按钮，一键清空所有名单数据，操作不可逆，需谨慎使用
- 导出：黄色按钮，将当前所有名单导出为文件，用于数据备份与批量迁移
- 搜索：输入QQ账号，快速查找对应名单记录，适合数据量较大时使用
2. 自动加黑开关
- 踢出加黑：开启后，成员被管理员踢出群聊时，系统会自动将其QQ加入黑名单
- 退群加黑：开启后，成员主动退群时，系统会自动将其QQ加入黑名单，防止反复退群加群骚扰
3. 列表字段说明
- ID：系统自动生成的名单唯一编号
- QQ账号：对应管控的QQ号码
- 黑/白：标记该账号属于黑名单还是白名单
- 备注：自定义备注信息，方便标注账号加入原因
- 添加时间：该账号被加入名单的时间
- 操作：可对单条记录执行编辑、删除操作
二、新增黑白名单
点击顶部蓝色「+ 添加」按钮，弹出添加名单弹窗，按以下步骤配置：
-
选择添加类型
下拉选择名单类型，可选「黑名单」或「白名单」：- 黑名单：账号无法申请入群，入群自动拒绝，群内触发规则直接处罚
- 白名单：账号豁免各类违规检测，入群直接自动通过
-
填写添加备注
输入自定义备注，例如“广告号”“核心管理”“恶意刷屏”，方便后续识别账号加入原因。 -
输入添加账号
在文本框内填写QQ账号，一行一个账号，支持批量录入多个号码，一次性添加多条名单。 -
确认信息无误后，点击「添加名单」按钮，数据将保存至列表中并立即生效；点击「关闭」则放弃添加并返回主界面。
三、名单日常管理操作
1. 编辑与删除
- 编辑：点击列表操作列的编辑按钮，可修改账号的名单类型、备注信息，账号本身不可修改
- 删除：点击删除按钮，二次确认后移除该条名单，账号恢复普通用户权限
2. 搜索查找
点击顶部「搜索」按钮，输入完整QQ号，可快速定位对应账号的名单记录，适合账号数量较多时使用。
3. 导出备份
点击「导出」按钮，可将全量黑白名单数据导出为文件，建议定期导出备份，防止数据意外丢失。
4. 一键清空
点击「清空」按钮可删除全部名单数据，操作不可逆，清空后所有账号恢复普通权限，执行前请务必备份数据。
四、生效规则与联动说明
- 优先级规则：白名单优先级高于黑名单，同时存在时白名单规则优先生效，账号不会被拦截。
- 入群审核联动：黑名单账号申请入群直接自动拒绝；白名单账号直接自动通过，无需人工审核。
- 违规检测联动：白名单账号豁免广告检测、名片违规检测等规则，不会触发自动处罚。
- 全局生效：名单为全局通用规则，在系统管理的所有社群中均生效，无需逐群配置。
五、注意事项
- 批量添加账号时请确保QQ号准确，一行一个，不要夹带空格、特殊符号，避免录入失败。
- 开启「踢出加黑」「退群加黑」前请确认群内定位，正常交流群不建议开启退群加黑，避免误封正常用户。
- 清空、删除操作不可逆，重要名单数据建议提前导出备份。
- 白名单权限较高，仅添加可信账号，避免广告号混入白名单后绕过检测。