Metadata-Version: 2.4
Name: nonebot-plugin-word-censor
Version: 0.2.1
Summary: 一个用于拦截 Bot 发送包含敏感词或正则匹配内容的消息审查插件
License: MIT
License-File: LICENSE
Keywords: nonebot,nonebot2,plugin,censor,filter
Author: 叶绿素Teio
Author-email: chlorophyimo@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: nonebot-plugin-localstore (>=0.7.1,<0.8.0)
Requires-Dist: nonebot2 (>=2.3.0,<3.0.0)
Requires-Dist: pydantic (>=1.10.0,<3.0.0)
Project-URL: Homepage, https://github.com/ChlorophyTeio/nonebot-plugin-word-censor
Project-URL: Repository, https://github.com/ChlorophyTeio/nonebot-plugin-word-censor
Description-Content-Type: text/markdown

<!-- markdownlint-disable MD033 MD036 MD041 -->

<p align="center">
  <a href="https://v2.nonebot.dev/"><img src="https://v2.nonebot.dev/logo.png" width="200" height="200" alt="nonebot"></a>
</p>

<div align="center">

# nonebot-plugin-word-censor

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

<a href="https://raw.githubusercontent.com/ChlorophyTeio/nonebot-plugin-word-censor/refs/heads/main/LICENSE">
    <img src="https://img.shields.io/github/license/he0119/nonebot-plugin-treehelp.svg" alt="license">
</a>
<a href="https://pypi.python.org/pypi/nonebot-plugin-word-censor">
    <img src="https://img.shields.io/pypi/v/nonebot-plugin-word-censor.svg" alt="pypi">
</a>
<img src="https://img.shields.io/badge/python-3.8+-blue.svg" alt="python">

</div>

## 📖 介绍

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

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

## 💿 安装

<details open>
<summary>使用 nb-cli 安装（推荐）</summary>
<pre><code>nb plugin install nonebot-plugin-word-censor</code></pre>
</details>

<details>
<summary>使用 pip 安装</summary>
<pre><code>pip install nonebot-plugin-word-censor</code></pre>
</details>

## ⚙️ 配置

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

```dev
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`

---

<div align="center">
  <p>本项目使用 <a href="./LICENSE">MIT 许可证</a> 开源</p>
</div>

