Metadata-Version: 2.4
Name: nonebot-plugin-mute-cat
Version: 1.0.0
Summary: 极致的禁言猫猫 - 功能强大的QQ群禁言插件
Author-email: binglang <lianbingyu_v2@163.com>
License: MIT
Project-URL: homepage, https://github.com/binglang001/nonebot-plugin-mute-cat
Project-URL: repository, https://github.com/binglang001/nonebot-plugin-mute-cat
Project-URL: documentation, https://github.com/binglang001/nonebot-plugin-mute-cat#readme
Keywords: nonebot,nonebot2,qq,mute,ban,猫娘,禁言
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Topic :: Communications :: Chat
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: <4.0,>=3.9
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: nonebot2>=2.0.0
Requires-Dist: nonebot-adapter-onebot>=2.0.0
Requires-Dist: nonebot-plugin-apscheduler>=0.2.0
Requires-Dist: pytz>=2023.3
Dynamic: license-file

# nonebot-plugin-mute-cat

<div align="center">

# 🐱 极致的禁言猫猫

✨ 功能强大的QQ群禁言插件，带有可爱的猫娘语气 ✨

</div>

## 📖 介绍

这是一个功能完善的QQ群禁言插件，支持多种禁言方式，带有可爱的猫娘语气回复。

### ✨ 特性

- ✅ **禁言成员** - 支持单个或多个成员禁言
- ✅ **取消禁言** - 解除单个或多个成员的禁言
- ✅ **全员禁言** - 支持永久禁言和定时禁言
- ✅ **解禁全员** - 一键解除全员禁言和所有个人禁言
- ✅ **禁我功能** - 随机禁言自己（1/3/5分钟或不禁言）
- ✅ **定时禁言** - 支持多种时间格式
- ✅ **@开关** - 可配置是否需要@才能触发命令
- ✅ **状态查看** - 查看当前谁被禁言、剩余时间
- ✅ **持久化存储** - 重启后保留设置

## 📦 安装

### 使用 nb-cli（推荐）

```bash
nb plugin install nonebot-plugin-mute-cat
```


## ⚙️ 配置

无需额外配置，开箱即用！

## 🎮 使用说明

### @开关（需要@机器人才能设置）

- `@机器人 开启at` - 开启需要@模式
- `@机器人 关闭at` - 关闭需要@模式

### 禁言命令

| 命令 | 说明 |
|------|------|
| `@机器人 禁言 @用户` | 禁言用户5分钟 |
| `@机器人 禁言 @用户 30` | 禁言30分钟 |
| `@机器人 禁言 @用户 1小时` | 禁言1小时 |
| `@机器人 禁言 @用户1 @用户2 5分钟` | 禁言多人 |

### 取消禁言

| 命令 | 说明 |
|------|------|
| `@机器人 取消 @用户` | 取消禁言 |
| `@机器人 解除 @用户` | 同上 |
| `@机器人 解禁 @用户` | 同上 |

### 全员禁言

| 命令 | 说明 |
|------|------|
| `@机器人 全员禁言` | 永久禁言 |
| `@机器人 全员禁言 5分钟` | 定时禁言5分钟 |

### 解禁全员

| 命令 | 说明 |
|------|------|
| `@机器人 解禁全员` | 解除全员禁言+所有个人禁言 |
| `@机器人 取消全员` | 同上 |
| `@机器人 解除所有人` | 同上 |

### 其他功能

| 命令 | 说明 |
|------|------|
| `@机器人 禁我` | 随机禁言自己 |
| `@机器人 查看状态` | 查看当前禁言状态 |
| `@机器人 帮助` | 查看帮助 |

## 📁 数据存储

插件会在 `data/mute_plugin/` 目录下存储以下文件：

- `at_required.json` - 各群的@开关状态
- `group_states.json` - 群禁言状态

## 🔧 依赖

- nonebot2 >= 2.0.0
- nonebot-adapter-onebot >= 2.0.0
- nonebot-plugin-apscheduler >= 0.2.0
- pytz >= 2023.3

## 📄 开源协议

本项目使用 MIT 协议开源。

## 💖 致谢

感谢所有使用和支持本插件的小伙伴们~
