QQ群禁言 mingmoe/koishi-plugin-qq-ban

koishi-plugin-qq-ban

Koishi — QQ 官方机器人群成员指令禁言插件。

功能

- ban @某人 <时长> 禁言群成员，时长支持中英文常见写法与多段累加
- unban @某人 解除禁言
- i18n

前置条件

1. 已启用支持群禁言的 QQ 官方机器人适配器（如 koishi-plugin-adapter-qq-crack）。
2. 机器人已被添加为该群的管理员。
3. 已启用 commands 插件。

安装

npm i koishi-plugin-qq-ban

或：

yarn add koishi-plugin-qq-ban

Koishi 配置

plugins:
group:basic:
commands: {}
qq-ban:
minAuthority: 3
maxDuration: 2592000

| 配置项 | 类型 | 默认值 | 说明 |
| minAuthority | number | 3 | 调用指令所需的最低权限等级 |
| maxDuration | number | 2592000 | 允许的最大禁言时长（秒），QQ 官方限制为 30 天；超出按此值处理 |

使用

ban @某人 10分钟 # 时长支持中文 ban @某人 600 # 纯数字按秒 ban @某人 1小时30分 # 多段累加 ban @某人 2h # 英文缩写 ban @某人 1 day # 英文全称 unban @某人 # 解除禁言

时长写法

| 单位 | 可写 | 折算 |
| 年 | 年 y yr year(s) | 365 天 |
| 月 | 月 个月 mo month(s) | 30 天 |
| 周 | 周 星期 礼拜 w week(s) | 7 天 |
| 天 | 天 日 d day(s) | 24 小时 |
| 小时 | 时 小时 个小时 h hr(s) hour(s) | 60 分钟 |
| 分钟 | 分 分钟 m min(s) minute(s) | 60 秒 |
| 秒 | 秒 秒钟 s sec(s) second(s) | 1 秒 |

补充规则：

- 不带单位时按秒处理（600 即 600 秒）
- 多段会累加，可用空格或 ,,/ 分隔：1d2h30m、1小时30分、1 hour and 30 minutes
- 支持中文数字与「半」：五分钟、两小时、半小时、半天
- 大小写不敏感

注意事项

本插件仅封装机器人的群管理能力，使用请遵守所在群规与当地法律法规。