🏷️ 改群名 · Group Rename

面向 PJSK、BanG Dream! 等使用五位房间号的固车、冲榜群的 NoneBot 插件

适用范围 · 主要功能 · 快速开始 · 指令与效果 · 配置

本项目参考了 luban652 的 AstrBot 群名前缀插件的功能需求

🎯 适用范围

适合 PJSK、BanG Dream! 等使用五位数字房间号的固车、冲榜群。 群管理员开启后，在群内发送房间号，Bot 会移除群名中的旧号码，并把新号码放在群名开头； 发送 清空 可移除号码。插件依据群消息中的数字工作，不区分具体游戏。

✨ 主要功能

🚀 快速开始

环境要求：

• Python >= 3.10
• NoneBot >= 2.4.4
• OneBot V11 适配器
• 机器人账号具备修改目标群名称的权限

将仓库放到 Bot 设备上，在该 Bot 的 Python 环境中运行：

pip install -e /path/to/nonebot-plugin-group-rename

上架 NoneBot 商店后，可在 Bot 项目中使用 NB-CLI 安装：

nb plugin install nonebot-plugin-group-rename

如果手动管理插件加载，请在 NoneBot 初始化后加载：

nonebot.load_plugin("nonebot_plugin_group_rename")

确认 Bot 已加载 OneBot V11 适配器，并在 COMMAND_START 中包含 /。随后由群管理员、群主或 SUPERUSER 在目标群发送 /group_rename on 或 /改群名 on。首次安装时所有群均关闭。

⌨️ 指令与效果

群开关

改名前后举例

发送 @某人 12345、[回复]12345 或 12345[图片] 仍可触发。12[图片]345、123456、文字 12345 和同一条消息里的两段非空文本不会触发。被 group_rename_ignore_patterns 忽略的数字也不会触发。

⚙️ 配置

不写配置文件即可使用默认参数，群开关仍默认关闭。 配置文件由 nonebot-plugin-localstore 管理。

例如，在 config.json 中只填写需要覆盖的参数：

{
  "group_rename_admin_only": true,
  "group_rename_ignore_patterns": ["12345", "99999"]
}

群开关状态另存在 nonebot-plugin-localstore 管理的数据目录下的 groups.json，不与参数配置混用；换设备时复制该状态文件，或在目标群重新执行 /group_rename on。

📋 版本记录

0.1.0

• 支持 OneBot V11 群内发送连续五位数字更新群名，发送“清空”移除旧号码；@、图片和回复可与号码同条发送。
• 群开关默认关闭，由群管理员及以上在目标群管理；开关状态单独保存。
• 同群改名串行处理，默认冷却 1 秒；号码与原群名之间保留空格，清空后群名为空时保留原名。
• 使用独立 JSON 文件配置插件参数。

本项目代码采用 MIT License。