nonebot-plugin-word-censor

✨ 基于 NoneBot2 的词汇与正则消息审查拦截插件 ✨

📖 介绍

nonebot-plugin-word-censor 是一个用于审查 NoneBot2 机器人发送内容的插件。

它可以防止机器人因为意外触发某些关键词或匹配到特定正则表达式而发送不当消息。支持通过指令实时动态管理黑名单的功能。

💿 安装

使用 nb-cli 安装（推荐）

nb plugin install nonebot-plugin-word-censor

使用 pip 安装

pip install nonebot-plugin-word-censor

⚙️ 配置

插件使用 nonebot-plugin-localstore 管理数据文件。 文件存储位置会根据操作系统不同而变化，您可以通过以下方式查看：

1. 查看插件启动日志。
2. 发送指令 word blacklist list 查看当前文件路径。

在 NoneBot2 项目的 .env 文件中添加以下配置（可选）：

SUPERUSERS = ["2428451170"]    # 管理员
SEND_WORD_PRIORITY = 100    # 优先级，没啥用

🎮 使用方法

⚠️ 注意：以下指令仅 SUPERUSER (超级用户) 可用。

1. 基础指令 (普通词汇)

| 指令 | 格式 | 说明 | | 添加词汇 | word blacklist add <内容> | 将指定内容加入黑名单 | | 删除词汇 | word blacklist del <内容> | 将指定内容移出黑名单 |

2. 高级指令 (正则表达式)

支持 Python re 模块的语法。

| 指令 | 格式 | 示例 | | 添加正则 | word blacklist add regex <表达式> | ... add regex \d{11} (拦截手机号) | | 删除正则 | word blacklist del regex <表达式> | ... del regex \d{11} |

3. 其他指令

• 查看列表：word blacklist list
  • 查看当前生效的所有规则（普通词汇会脱敏显示）。
• 刷新配置：word blacklist refresh
  • 如果你手动修改了 JSON 文件，可使用此指令热重载。
• 帮助：word blacklist help

---

本项目使用 MIT 许可证 开源