AstrBot 完全禁用插件
通过黑名单或白名单模式完全禁止某个群聊或用户使用机器人的 AstrBot 插件。
功能特性
- 黑名单模式：名单内的用户/群聊无法使用机器人
- 白名单模式：只有名单内的用户/群聊可以使用机器人
- 管理员绕过：可选择是否让管理员绕过禁用限制
- 禁用消息控制：可选择是否向被禁用的用户/群聊发送提示消息
- 简化管理：统一的禁用名单，简化命令操作
- 实时过滤：自动拦截被禁用用户/群聊的消息
配置说明
插件在 WebUI 管理面板中提供可视化配置，包含以下选项：
- 禁用模式选择：blacklist（黑名单）或 whitelist（白名单）
- 禁用名单：根据模式不同，作用不同的统一名单
- 管理员是否绕过禁用限制：true 或 false
- 是否启用禁用提示消息：true 或 false
- 禁用时返回的消息：被禁用时机器人返回的提示消息
使用说明
管理命令
所有管理命令都需要管理员权限才能使用。
基础命令
/disable- 显示插件帮助信息和当前配置/disable help- 显示此帮助信息/disable list- 显示当前配置
名单管理
/disable add <用户ID/群聊ID>- 添加到禁用名单/disable remove <用户ID/群聊ID>- 从禁用名单移除
配置管理
/disable mode <blacklist|whitelist>- 切换禁用模式/disable bypass <true|false>- 设置管理员绕过/disable msg <true|false>- 设置是否显示禁用提示
使用示例
设置黑名单模式：
/disable mode blacklist添加用户到禁用名单：
/disable add 123456789添加群聊到禁用名单：
/disable add 987654321关闭禁用提示消息：
/disable msg false查看当前配置：
/disable list
工作原理
黑名单模式
- 当用户或群聊在禁用名单中时，机器人将不会响应其消息
- 可选择是否向被禁用的用户发送提示消息
- 管理员可选择绕过此限制
- 适用于需要屏蔽特定用户或群聊的场景
白名单模式
- 只有在禁用名单中的用户或群聊才能使用机器人
- 可选择是否向未授权的用户发送提示消息
- 管理员可选择绕过此限制
- 适用于需要限制机器人只对特定用户或群聊开放的场景
安装方法
- 将插件文件夹放入 AstrBot 的
data/plugins目录 - 在 AstrBot WebUI 的插件管理页面启用本插件
- 根据需要配置禁用模式和相关名单
注意事项
- 管理员命令需要管理员权限才能执行
- 配置更改后立即生效，无需重启
- 建议先在测试环境中验证配置效果
- 在白名单模式下，未在名单中的用户/群聊将无法使用机器人的任何功能
- 关闭禁用提示消息后，被禁用的用户/群聊将不会收到任何反馈
更新日志
v1.0.1
- 合并黑白名单为统一的禁用名单，简化配置
- 简化管理命令，减少命令数量
- 添加禁用消息开关，可选择是否发送提示
- 优化禁用逻辑，确保正确拦截消息
v1.0.0
- 初始版本发布
- 支持黑名单和白名单模式
- 提供完整的管理命令系统
支持
如有问题或建议，请通过以下方式获取帮助：