> 规范网页：https://docs.tensuu.com/功能模块详解/14_黑白名单.html ｜ Markdown：/功能模块详解/14_黑白名单.md ｜ 文档修订：2026.10.26

# 群组黑白名单

这篇帮你做什么：维护**单个群**的黑白名单。页面用法与 [全局黑白名单](06_全局黑白名单.md) 完全一致，区别只在作用范围：这里的名单只对顶部选中的群生效。入口：**群设置 → 群组黑白名单**（先在页面顶部选择群）。

## 开始前确认

- **先确认目标群再操作**：核对页面顶部的群名和群号，不要把页面自动选中的群当成你要修改的群。没有可用群或群已失效时，先回群列表确认目标，再进入本页。
- **白名单**：该用户在本群获得权限等级 6（受保护），机器人不在本群对其实施踢出、禁言等处罚；其他群不受影响。
- **黑名单**：该用户在本群进群时被机器人移出并拒绝再次加入；其他群不受影响。
- 黑名单在**进群那一刻**生效，已在群里的黑名单用户不会被自动移出。
- 名单只约束机器人自己的动作，QQ 群管理员的手动操作不受影响。

## 添加名单用户

1. 页面顶部选择目标群。
2. 切换 **黑名单** 或 **白名单** 标签。
3. 点 **添加黑名单用户**（或白名单），填写 **号码** 和 **理由**（都必填），确认。
4. **怎样判断成功**：提示添加成功，列表出现该行。

## 管理名单

与全局页相同的操作：行内 **编辑 / 删除**、勾选后 **批量删除**、CSV **导入 / 导出**、按号码 **搜索**、每页 20 条分页。CSV 使用 UTF-8 编码，按本页导出的完整表头和列序编辑；不要自行缩成"号码 + 理由"两列。导入后按号码查实际名单行，不只看成功提示。

换一个群时重新在顶部选群，名单按群各自独立。

## 名单怎么生效

- **全局与本群名单叠加**：进群检查时全局黑名单和本群黑名单都会拦截；白名单则在任一层存在即给保护。只想约束个别群用本页；全站都不要的人用[全局黑白名单](06_全局黑白名单.md)。
- **同一人既在白名单又在黑名单时，保护优先**：白名单（全局或本群）让成员获得等级 6 保护，机器人进群核查保护后再决定是否移出，命中保护就不会移出。
- 白名单用户与群主、群管理员、代管一样属于"受保护用户"，机器人的处罚动作会跳过他们。等级模型见[权限管理](../高级功能/权限管理.md)。
- 黑名单用户进群时，机器人先做保护核查再移出；若核查结果不完整（无法确认状态），按保守处理、不踢出。
- 群里的管理指令（如群指令加黑/加白）维护的也是这份名单；指令谁能用见[权限管理](../高级功能/权限管理.md)。

以上是本页配置的预期行为；实际执行情况可在 [日志中心](17_应用日志.md) 查看机器人的动作记录。

## 没成功先检查什么

- 提示选择群或被带回群列表：先确认目标群仍在列表中，再进入本页选择正确的群。
- 黑名单用户进群没被踢：是否同时在白名单或管理员名单里（保护优先）；或机器人没收到进群事件（检查连接）。
- 名单在别的群也生效了：确认加的是本页"群组"名单，不是[全局黑白名单](06_全局黑白名单.md)。
- 导入报错或提示成功却没有新增：确认 UTF-8 编码，使用本页导出的完整 CSV 表头和列序，并按号码核对结果。

## 关闭或改回

- 取消某人：在对应标签下 **删除** 该行。
- 整批调整：先 **导出** 备份，再批量删除；需要时重新导入。

## 和其他页面的关系

- 全站生效的名单在[全局黑白名单](06_全局黑白名单.md)，两者叠加生效。
- 踢出并拉黑的成员会出现在黑名单中；处罚来源见[踢人禁言](13_踢人禁言.md)。