介绍
ReNeBan 是一个为 astrbot 设计的简易黑名单插件，允许bot管理员在会话或全局范围较为灵活地禁用指定用户。
ReNeBan 允许为禁用/解禁设置时限和理由，并自动整理记录。
ReNeBan 的指令优先级策略为：会话 > 全局，pass > ban。
命令
| 命令 | 语法 | 说明 | 示例 |
|---|---|---|---|
/ban |
/ban <@用户|UID（QQ号）> [时间（默认无期限）] [理由（默认无理由）] [UMO] | 在指定会话范围内禁用一名指定用户 | /ban @AAA高价收游戏账号 0 打广告 |
/pass |
/pass <@用户|UID（QQ号）> [时间（默认无期限）] [理由（默认无理由）] [UMO] | 在指定会话范围内解除禁用一名指定用户 | /pass @yfseh218 0 None |
/ban-all |
/ban-all <@用户|UID（QQ号）> [时间（默认无期限）] [理由（默认无理由）] | 在全局范围内禁用一名指定用户 | /ban-all 2110453981 1d30m 试图让bot输出敏感内容 |
/pass-all |
/pass-all <@用户|UID（QQ号）> [时间（默认无期限）] [理由（默认无理由）] | 在全局范围内解除禁用一名指定用户 | /pass-all @我想不出来啥名了 0 误封 |
/ban-enable |
/ban-enable | 启用禁用功能，重启后失效 | /ban-enable |
/ban-disable |
/ban-disable | 禁用禁用功能，重启后失效 | /ban-disable |
/banlist |
/banlist | 输出在当前会话与全局范围下的禁用/解禁情况（包括UID/剩余时长/理由） | /banlist |
/ban-help |
/ban-help | 输出简易帮助信息 | /ban-help |
/dec-ban |
/dec-ban <@用户|UID（QQ号）> [时间（默认无期限）] [理由（默认无理由）] [UMO] | 删除在指定会话范围内对一名指定用户的禁用记录 | /dec-ban @UserA 0 表现良好 |
/dec-pass |
/dec-pass <@用户|UID（QQ号）> [时间（默认无期限）] [理由（默认无理由）] [UMO] | 删除在指定会话范围内对一名指定用户的解禁记录 | /dec-pass @UserB 0 None |
/dec-ban-all |
/dec-ban-all <@用户|UID（QQ号）> [时间（默认无期限）] [理由（默认无理由）] | 删除在全局范围内对一名指定用户的禁用记录 | /dec-ban-all 3869541370 1d30m 表现良好 |
/dec-pass-all |
/dec-pass-all <@用户|UID（QQ号）> [时间（默认无期限）] [理由（默认无理由）] | 删除在全局范围内对一名指定用户的解禁记录 | /dec-pass-all @XYZ 0 NULL |
/ban-reset |
/ban-reset <@用户|UID（QQ号）> | 删除一名指定用户的所有记录 | /ban-reset @NekoiMeiov |
时间字段支持如下格式：
- `1d` → 1 天
- `2h` → 2 小时
- `30m` → 30 分钟
- `10s`，`10` → 10 秒
- `0` → 永久（默认，且不支持与以上单位复用）
输入时需按单位大小填写！不允许如20m1h的时间表达式！
以下理由将会被判定为无理由：
"无理由""None""NULL"
安装
- 从插件市场安装
在 插件管理 - 插件市场 搜索 ReNeBan
- 从链接安装
在 插件管理 - 安装 - 从链接安装 输入以下链接
https://github.com/NekoiMeiov/astrbot_plugin_reneban
- 从源码安装
在终端中输入以下命令（若为手动安装，请将 /AstrBot 修改为手动安装的路径）
# 克隆仓库到插件目录
cd /AstrBot/data/plugins
git clone https://github.com/NekoiMeiov/astrbot_plugin_reneban
# 控制台重启AstrBot
贡献指南
- 给...给这个Repo点个Star（不...不给也可以......）
- 提交 Issue 报告问题/提出建议
- 提交 Pull Request 改进