功能使用手册
违禁词
按群维护违禁词列表，命中后执行删除、警告、禁言或封禁等策略。
怎么用
操作目标
按群维护违禁词列表，命中后执行删除、警告、禁言或封禁等策略。
- 进入违禁词 发送 /start 打开基础菜单，点击管理入口，再点击「违禁词」。 部分菜单会从垃圾防护或审核入口进入。
- 添加关键词 点击添加，发送需要拦截的词，并确认启用状态。 建议先添加高确定性的词。
- 触发审核 在群里发送包含违禁词的测试消息，确认处理动作。 管理员豁免策略按当前代码逻辑执行。
开始前
前置条件
- 已选择目标群组。
- 需要处罚时机器人具备对应权限。
实际使用
按用户实际体验操作
在 Telegram 私聊机器人发送 /start，先确认当前群组，再点击「违禁词」。
进入后首先看到「违禁词列表」。- 进入违禁词：发送 /start 打开基础菜单，点击管理入口，再点击「违禁词」。
- 添加关键词：点击添加，发送需要拦截的词，并确认启用状态。
- 触发审核：在群里发送包含违禁词的测试消息，确认处理动作。
- 添加违禁词：发送一个词或多行词条 （广告词）
- 已选择目标群组。
- 需要处罚时机器人具备对应权限。
- 格式不符合要求时，Bot 会停留在输入态并提示重新输入。
- 如果页面提示权限、未开启或无效，先回到当前功能页补齐配置，再重新点击同一个按钮。
Telegram 操作流
跟着真实按钮操作
入口：私聊 /start 后点击「违禁词」 页面：6 个 输入：1 处需要填写 群内：需要回到群内验证效果
第 1 / 6 页
@TgGroupRobot
管理员主菜单
发送 /start 后点击管理入口，按按钮选择当前群组。
点击「违禁词」进入配置页。
当前群组：演示群
13:41 第 2 / 6 页
@TgGroupRobot
选择配置群组
私聊配置前先确认目标群组，后续按钮都会写入这个群。
可管理群：演示群、测试群
13:41 第 3 / 6 页
@TgGroupRobot
主菜单
这里展示机器人后台的真实功能入口。
13:41第 4 / 6 页
@TgGroupRobot
违禁词列表
违禁词使用独立 banned_word 回调创建、开关和删除。
当前群组：演示群输入提示：违禁词的输入集中在 「添加违禁词」；按页面示例填写，填错可返回上一步重新输入。异常恢复：配置「违禁词」时如果提示未开启、权限不足、无效或失败，先确认当前群组和机器人权限，再回到「违禁词列表」重新操作。
13:41 第 5 / 6 页
@TgGroupRobot
添加违禁词
请按照 Bot 提示在私聊发送内容。
发送一个词或多行词条
13:41 广告词
清空方式：/clear
- 格式不符合要求时，Bot 会停留在输入态并提示重新输入。
第 6 / 6 页
@TgGroupRobot
违禁词设置结果
保存后列表会重新渲染。运行时命中后按惩罚策略处理。
13:41点击上方 Telegram 按钮开始；手机端按页面顺序往下点即可。
常见问题
常见问题
违禁词按全局还是按群生效？
按群隔离，每个群可维护自己的列表。