全局黑白名单
这篇帮你做什么：维护对所有群生效的两份用户名单。白名单用户是受保护用户（权限等级 6），机器人不会对其实施踢出、禁言等处罚；黑名单用户在进群时会被机器人移出。入口：应用设置 → 全局黑白名单。
选择依据：想保护或拉黑的人跨所有群一致时用本页；只针对某一个群用 群组黑白名单。两份名单叠加生效——同一个人只要出现在任一 whitelist 里就受保护；黑名单按"先查全局、再查本群"的顺序检查，命中任一即拦截。机器人检查名单查询失败时按保守处理（不当作"未命中"），所以数据库异常期间可能暂时不踢黑名单用户，恢复后正常。
开始前确认
- 白名单是强力豁免：加入后此人在所有群都不会被机器人的处罚动作处理。加错人等于给TA"免罚金牌"，添加前想清楚。
- 黑名单在成员进群那一刻生效：已经在群里的黑名单用户不会被自动移出，等TA下次进群时才会被踢。
- 名单只约束机器人自己的动作；QQ 群管理员手动踢人、禁言不受名单影响。
- 控制台目前没有登录体系，能打开页面就能修改；本页操作在"操作人"列显示为系统记录。
- CSV 导入请用 UTF-8 编码，先从本页导出文件，再按原格式编辑。保留 ID、号码、理由、操作人、创建时间的表头和列顺序，不要简化成“号码 + 理由”两列；两列文件可能提示“导入成功”却没有新增记录。
添加名单用户
- 顶部切换 黑名单 或 白名单 标签。
- 点 添加黑名单用户（或白名单）。
- 填写 号码（用户 ID）和 理由（两项都必填），确认。
- 怎样判断成功：提示"黑名单/白名单用户添加成功"，列表出现该行。
管理名单
- 编辑：行内 编辑 可改号码和理由。
- 删除：行内 删除 移除单条。
- 批量删除：勾选多行 → 批量删除 → 确认。
- 导入 / 导出：CSV 格式，用于备份或迁移；导出包含 ID、号码、理由、操作人、创建时间。
- 搜索：右上角按号码搜索，回车执行；列表每页 20 条，可翻页。
名单怎么生效
- 白名单：用户获得权限等级 6，和群主（9）、群管理员（8）、代管（7）一样属于"受保护用户"，机器人的踢出、禁言等动作会跳过他们。等级模型见权限管理。
- 黑名单：机器人检测到黑名单用户进群时，将其移出并拒绝再次加入，同时不发送入群欢迎。移出前会再做一次保护核查——如果对方恰好也在保护名单里（比如白名单），以保守为准、不踢出。
设置项与生效参考：
| 项目 | 取值与规则 | 生效方式 |
|---|---|---|
| 号码 | 必填，用户 ID，不含多余空格 | 添加/删除/导入后即时生效 |
| 理由 | 必填，自由文本 | 仅作记录展示，不参与匹配 |
| 作用范围 | 全部群、全部机器人 | 与群级名单叠加（见上文） |
| CSV 导入 | UTF-8；列：ID、号码、理由、操作人、创建时间，保留表头与列顺序 | 导入后按号码搜索核对实际名单行 |
以上是本页配置的预期行为。先在 日志中心 → 审计日志 查动作是否受理和失败原因；平台是否真正执行，再按群聊监控触发记录中的"动作终态"及实际成员状态核对。应用日志页记录的是程序运行日志，不能替代动作审计。
没成功先检查什么
- 添加/删除失败：确认号码没有多余空格；群级页面还需先在顶部选群（全局页不用）。
- 黑名单用户进群没被踢：TA 是否也在白名单/管理员名单里（保护优先）；或该次进群事件未被机器人收到（检查连接）。
- 白名单用户仍被处罚：确认处罚由机器人发起而非 QQ 群管理员手动操作；确认加的是"全局"而非"群组"名单（反之亦然）。
- 导入报错或提示成功却没有新增记录：确认文件是 UTF-8 编码，使用本页导出的完整 CSV 格式。导入后按号码搜索并核对实际名单行，不只看成功提示。
关闭或改回
名单没有总开关，逐条操作即生效：
- 取消保护/拉黑某用户：在对应标签下 删除 该行。
- 整批调整：先 导出 备份，再批量删除；需要时重新导入。