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