nonebot-plugin-group-rename 0.1.0__tar.gz

nonebot_plugin_group_rename-0.1.0/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Felis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+\n

nonebot_plugin_group_rename-0.1.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-group-rename
+Version: 0.1.0
+Summary: 适用于 PJSK、BanG Dream! 等五位房间号固车群的 NoneBot2 改群名插件，按群启用后通过群消息自动更新或清空群名车牌
+Author-email: Felis <3397152010@qq.com>
+Maintainer-email: Felis <3397152010@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Felis2026/nonebot-plugin-group-rename
+Project-URL: Maintainer, https://github.com/Felis2026
+Keywords: nonebot2,onebot,group-rename,group-name
+Classifier: Framework :: AsyncIO
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: nonebot2<3.0.0,>=2.4.4
+Requires-Dist: nonebot-adapter-onebot<3.0.0,>=2.4.0
+Requires-Dist: nonebot-plugin-localstore<1.0.0,>=0.7.4
+Requires-Dist: pydantic<3.0,>=2.0
+Dynamic: license-file
+
+<div align="center">
+
+  <img src="assets/group-rename-cover.jpg" width="180" alt="改群名插件头图">
+
+  <h1>🏷️ 改群名 · Group Rename</h1>
+
+  <p><strong>面向 PJSK、BanG Dream! 等使用五位房间号的固车、冲榜群的 NoneBot 插件</strong></p>
+
+  <p>
+    <img src="https://img.shields.io/badge/Python-3.10%2B-blue" alt="Python >= 3.10">
+    <img src="https://img.shields.io/badge/NoneBot-2.4.4%2B-black" alt="NoneBot >= 2.4.4">
+    <img src="https://img.shields.io/badge/Adapter-OneBot%20V11-orange" alt="OneBot V11">
+    <img src="https://img.shields.io/badge/Version-0.1.0-ff69b4" alt="Version 0.1.0">
+    <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green" alt="MIT License"></a>
+  </p>
+
+  <p>
+    <a href="#-适用范围">适用范围</a> ·
+    <a href="#-主要功能">主要功能</a> ·
+    <a href="#-快速开始">快速开始</a> ·
+    <a href="#️-指令与效果">指令与效果</a> ·
+    <a href="#️-配置">配置</a>
+  </p>
+</div>
+
+> 本项目参考了 [luban652 的 AstrBot 群名前缀插件](https://github.com/luban652/astrbot_plugin_group_prefix_manager)的功能需求
+
+## 🎯 适用范围
+
+适合 **PJSK**、**BanG Dream!** 等使用**五位数字房间号**的固车、冲榜群。
+群管理员开启后，在群内发送房间号，Bot 会移除群名中的旧号码，并把新号码放在群名开头；
+发送 `清空` 可移除号码。插件依据群消息中的数字工作，不区分具体游戏。
+
+## ✨ 主要功能
+
+| 功能 | 行为 |
+| --- | --- |
+| 车牌改名 | 群内发送独立的连续五位数字（车牌），将其放在群名开头 |
+| 清空车牌 | 发送 `清空`，移除群名中的连续五位及以上数字 |
+| 按群开关 | 默认关闭，由**群管理员及以上**在目标群内开启或关闭 |
+| 混合消息 | 数字或“清空”可与 @、图片、回复同条发送；数字不能被非文本消息段隔开 |
+| 防止覆盖 | 同一群的改名串行处理，并有默认 1 秒操作冷却 |
+
+---
+
+## 🚀 快速开始
+
+环境要求：
+
+- Python `>= 3.10`
+- NoneBot `>= 2.4.4`
+- OneBot V11 适配器
+- 机器人账号具备修改目标群名称的权限
+
+将仓库放到 Bot 设备上，在该 Bot 的 Python 环境中运行：
+
+```bash
+pip install -e /path/to/nonebot-plugin-group-rename
+```
+
+上架 NoneBot 商店后，可在 Bot 项目中使用 NB-CLI 安装：
+
+```bash
+nb plugin install nonebot-plugin-group-rename
+```
+
+
+如果手动管理插件加载，请在 NoneBot 初始化后加载：
+
+```python
+nonebot.load_plugin("nonebot_plugin_group_rename")
+```
+
+确认 Bot 已加载 OneBot V11 适配器，并在 `COMMAND_START` 中包含 `/`。随后由群管理员、群主或 SUPERUSER 在目标群发送 `/group_rename on` 或 `/改群名 on`。首次安装时所有群均关闭。
+
+---
+
+## ⌨️ 指令与效果
+
+### 群开关
+
+| 指令 | 权限 | 作用 |
+| --- | --- | --- |
+| `/group_rename on` 或 `/改群名 on` | 群管理员、群主或 SUPERUSER | 开启当前群 |
+| `/group_rename off` 或 `/改群名 off` | 群管理员、群主或 SUPERUSER | 关闭当前群 |
+| `/group_rename status` 或 `/改群名 status` | 群管理员、群主或 SUPERUSER | 查看当前群状态 |
+| `12345` | 默认群成员；开启管理员限制后仅上述管理员 | 将 `12345` 设置为群名车牌 |
+| `清空` | 默认群成员；开启管理员限制后仅上述管理员 | 从群名移除旧车牌 |
+
+### 改名前后举例
+
+| 原群名 | 群消息 | 修改后 | 原因 |
+| --- | --- | --- | --- |
+| `冲榜群` | `12345` | `12345 冲榜群` | 新增车牌 |
+| `12345 冲榜群` | `67890` | `67890 冲榜群` | 替换旧车牌 |
+| `1234567冲榜群` | `67890` | `67890 冲榜群` | 连续五位及以上数字整体移除 |
+| `12345 冲榜群` | `清空` | `冲榜群` | 清除车牌 |
+| `12345` | `67890` | `67890` | 原群名只剩车牌时仅替换 |
+| `12345` | `清空` | `12345` | 清空会得到空群名，因此保留原名并提示先手动设置群名 |
+
+发送 `@某人 12345`、`[回复]12345` 或 `12345[图片]` 仍可触发。`12[图片]345`、`123456`、`文字 12345` 和同一条消息里的两段非空文本不会触发。被 `group_rename_ignore_patterns` 忽略的数字也不会触发。
+
+
+---
+
+## ⚙️ 配置
+
+不写配置文件即可使用默认参数，群开关仍默认关闭。
+配置文件由 `nonebot-plugin-localstore` 管理。
+
+| JSON 参数 | 默认值 | 说明 |
+| --- | --- | --- |
+| `group_rename_max_length` | `30` | 目标群名的最长字符数，最小为 `5` |
+| `group_rename_enable_notify` | `true` | 冷却、读取或修改群名失败、仅剩车牌无法清空时发送提示 |
+| `group_rename_admin_only` | `false` | 开启后仅允许群管理员、群主或 SUPERUSER 通过车牌消息触发改名 |
+| `group_rename_ignore_patterns` | `[]` | 忽略的五位数字，使用 JSON 数组 |
+| `group_rename_cooldown_seconds` | `1` | 每群改名尝试的冷却秒数 |
+
+例如，在 `config.json` 中只填写需要覆盖的参数：
+
+```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](LICENSE)。

nonebot_plugin_group_rename-0.1.0/README.md

@@ -0,0 +1,141 @@
+<div align="center">
+
+  <img src="assets/group-rename-cover.jpg" width="180" alt="改群名插件头图">
+
+  <h1>🏷️ 改群名 · Group Rename</h1>
+
+  <p><strong>面向 PJSK、BanG Dream! 等使用五位房间号的固车、冲榜群的 NoneBot 插件</strong></p>
+
+  <p>
+    <img src="https://img.shields.io/badge/Python-3.10%2B-blue" alt="Python >= 3.10">
+    <img src="https://img.shields.io/badge/NoneBot-2.4.4%2B-black" alt="NoneBot >= 2.4.4">
+    <img src="https://img.shields.io/badge/Adapter-OneBot%20V11-orange" alt="OneBot V11">
+    <img src="https://img.shields.io/badge/Version-0.1.0-ff69b4" alt="Version 0.1.0">
+    <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green" alt="MIT License"></a>
+  </p>
+
+  <p>
+    <a href="#-适用范围">适用范围</a> ·
+    <a href="#-主要功能">主要功能</a> ·
+    <a href="#-快速开始">快速开始</a> ·
+    <a href="#️-指令与效果">指令与效果</a> ·
+    <a href="#️-配置">配置</a>
+  </p>
+</div>
+
+> 本项目参考了 [luban652 的 AstrBot 群名前缀插件](https://github.com/luban652/astrbot_plugin_group_prefix_manager)的功能需求
+
+## 🎯 适用范围
+
+适合 **PJSK**、**BanG Dream!** 等使用**五位数字房间号**的固车、冲榜群。
+群管理员开启后，在群内发送房间号，Bot 会移除群名中的旧号码，并把新号码放在群名开头；
+发送 `清空` 可移除号码。插件依据群消息中的数字工作，不区分具体游戏。
+
+## ✨ 主要功能
+
+| 功能 | 行为 |
+| --- | --- |
+| 车牌改名 | 群内发送独立的连续五位数字（车牌），将其放在群名开头 |
+| 清空车牌 | 发送 `清空`，移除群名中的连续五位及以上数字 |
+| 按群开关 | 默认关闭，由**群管理员及以上**在目标群内开启或关闭 |
+| 混合消息 | 数字或“清空”可与 @、图片、回复同条发送；数字不能被非文本消息段隔开 |
+| 防止覆盖 | 同一群的改名串行处理，并有默认 1 秒操作冷却 |
+
+---
+
+## 🚀 快速开始
+
+环境要求：
+
+- Python `>= 3.10`
+- NoneBot `>= 2.4.4`
+- OneBot V11 适配器
+- 机器人账号具备修改目标群名称的权限
+
+将仓库放到 Bot 设备上，在该 Bot 的 Python 环境中运行：
+
+```bash
+pip install -e /path/to/nonebot-plugin-group-rename
+```
+
+上架 NoneBot 商店后，可在 Bot 项目中使用 NB-CLI 安装：
+
+```bash
+nb plugin install nonebot-plugin-group-rename
+```
+
+
+如果手动管理插件加载，请在 NoneBot 初始化后加载：
+
+```python
+nonebot.load_plugin("nonebot_plugin_group_rename")
+```
+
+确认 Bot 已加载 OneBot V11 适配器，并在 `COMMAND_START` 中包含 `/`。随后由群管理员、群主或 SUPERUSER 在目标群发送 `/group_rename on` 或 `/改群名 on`。首次安装时所有群均关闭。
+
+---
+
+## ⌨️ 指令与效果
+
+### 群开关
+
+| 指令 | 权限 | 作用 |
+| --- | --- | --- |
+| `/group_rename on` 或 `/改群名 on` | 群管理员、群主或 SUPERUSER | 开启当前群 |
+| `/group_rename off` 或 `/改群名 off` | 群管理员、群主或 SUPERUSER | 关闭当前群 |
+| `/group_rename status` 或 `/改群名 status` | 群管理员、群主或 SUPERUSER | 查看当前群状态 |
+| `12345` | 默认群成员；开启管理员限制后仅上述管理员 | 将 `12345` 设置为群名车牌 |
+| `清空` | 默认群成员；开启管理员限制后仅上述管理员 | 从群名移除旧车牌 |
+
+### 改名前后举例
+
+| 原群名 | 群消息 | 修改后 | 原因 |
+| --- | --- | --- | --- |
+| `冲榜群` | `12345` | `12345 冲榜群` | 新增车牌 |
+| `12345 冲榜群` | `67890` | `67890 冲榜群` | 替换旧车牌 |
+| `1234567冲榜群` | `67890` | `67890 冲榜群` | 连续五位及以上数字整体移除 |
+| `12345 冲榜群` | `清空` | `冲榜群` | 清除车牌 |
+| `12345` | `67890` | `67890` | 原群名只剩车牌时仅替换 |
+| `12345` | `清空` | `12345` | 清空会得到空群名，因此保留原名并提示先手动设置群名 |
+
+发送 `@某人 12345`、`[回复]12345` 或 `12345[图片]` 仍可触发。`12[图片]345`、`123456`、`文字 12345` 和同一条消息里的两段非空文本不会触发。被 `group_rename_ignore_patterns` 忽略的数字也不会触发。
+
+
+---
+
+## ⚙️ 配置
+
+不写配置文件即可使用默认参数，群开关仍默认关闭。
+配置文件由 `nonebot-plugin-localstore` 管理。
+
+| JSON 参数 | 默认值 | 说明 |
+| --- | --- | --- |
+| `group_rename_max_length` | `30` | 目标群名的最长字符数，最小为 `5` |
+| `group_rename_enable_notify` | `true` | 冷却、读取或修改群名失败、仅剩车牌无法清空时发送提示 |
+| `group_rename_admin_only` | `false` | 开启后仅允许群管理员、群主或 SUPERUSER 通过车牌消息触发改名 |
+| `group_rename_ignore_patterns` | `[]` | 忽略的五位数字，使用 JSON 数组 |
+| `group_rename_cooldown_seconds` | `1` | 每群改名尝试的冷却秒数 |
+
+例如，在 `config.json` 中只填写需要覆盖的参数：
+
+```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](LICENSE)。

nonebot_plugin_group_rename-0.1.0/nonebot_plugin_group_rename/__init__.py

@@ -0,0 +1,202 @@
+"""通过 OneBot V11 群消息中的车牌改群名。"""
+
+from __future__ import annotations
+
+import asyncio
+from collections.abc import Mapping
+
+from nonebot import get_driver, logger, on_command, on_message, require
+from nonebot.adapters import Event
+from nonebot.adapters.onebot.v11 import ActionFailed, Bot, GroupMessageEvent
+from nonebot.params import CommandArg
+from nonebot.permission import Permission
+from nonebot.plugin import PluginMetadata
+
+# 持久化目录由 localstore 决定，避免依赖 Bot 的启动工作目录。
+require("nonebot_plugin_localstore")
+import nonebot_plugin_localstore as localstore
+
+from .config import Config, load_config
+from .logic import GroupCooldown, build_group_name, message_trigger
+from .state import GroupState
+
+
+__plugin_meta__ = PluginMetadata(
+    name="改群名",
+    description="适用于 PJSK、BanG Dream! 等使用五位房间号固车、冲榜群的改群名插件。按群启用后，发送独立的连续五位数字可更新群名开头的车牌，发送“清空”可移除旧车牌。",
+    usage="群管理员、群主或 SUPERUSER 在目标群发送 /group_rename on 或 /改群名 on 开启；使用 off 关闭、status 查看状态。开启后，在群内发送五位房间号或“清空”即可操作群名。",
+    type="application",
+    homepage="https://github.com/Felis2026/nonebot-plugin-group-rename",
+    config=Config,
+    supported_adapters={"~onebot.v11"},
+)
+
+config = load_config(localstore.get_config_file("nonebot_plugin_group_rename", "config.json"))
+# 显式指定插件名，使数据目录不依赖当前模块的调用上下文。
+state = GroupState(localstore.get_data_file("nonebot_plugin_group_rename", "groups.json"))
+cooldown = GroupCooldown(config.group_rename_cooldown_seconds)
+group_locks: dict[str, asyncio.Lock] = {}
+
+
+def _group_lock(group_id: str) -> asyncio.Lock:
+    """按群复用锁，让改名和群开关操作按到达顺序执行。"""
+    # 同一事件循环内创建锁的过程不含 await，不会为同群创建两把锁。
+    if group_id not in group_locks:
+        group_locks[group_id] = asyncio.Lock()
+    return group_locks[group_id]
+
+
+def _is_group_admin_or_superuser(event: Event) -> bool:
+    """允许当前群管理员、群主及 NoneBot 超级用户管理本群。"""
+    if not isinstance(event, GroupMessageEvent):
+        return False
+    # OneBot V11 的群内角色只有 owner/admin/member；缺失角色时不放行。
+    return (
+        event.sender.role in {"admin", "owner"}
+        or event.get_user_id() in get_driver().config.superusers
+    )
+
+
+def _message_trigger(event: GroupMessageEvent) -> str | None:
+    """从 OneBot 消息段读取车牌，不跨 @、图片或回复拼接数字。"""
+    segments = (
+        (segment.type, str(segment.data.get("text", "")))
+        for segment in event.get_message()
+    )
+    return message_trigger(segments, config.group_rename_ignore_patterns)
+
+
+def _is_rename_message(event: Event) -> bool:
+    """只让已启用群的有效车牌消息进入改名处理。"""
+    if not isinstance(event, GroupMessageEvent):
+        return False
+    if not state.is_enabled(str(event.group_id)):
+        return False
+    if config.group_rename_admin_only and not _is_group_admin_or_superuser(event):
+        return False
+    return _message_trigger(event) is not None
+
+
+def _is_permission_failure(exc: ActionFailed) -> bool:
+    """只根据 OneBot 返回的权限字样识别权限失败，不猜测 retcode 的平台含义。"""
+    # 不同 OneBot 实现的错误码并不统一，文字字段更适合做保守识别。
+    details = " ".join(str(exc.info.get(key, "")) for key in ("wording", "message", "msg"))
+    details = details.casefold()
+    return any(
+        marker in details
+        for marker in ("权限", "管理员", "无权", "permission", "not admin", "forbidden")
+    )
+
+
+# ================================ 群开关命令 ================================ #
+
+group_rename_command = on_command(
+    "group_rename",
+    aliases={"改群名"},
+    permission=Permission(_is_group_admin_or_superuser),
+    priority=1,
+    block=False,
+)
+
+
+@group_rename_command.handle()
+async def handle_group_rename_command(event: GroupMessageEvent, args=CommandArg()) -> None:
+    """群管理员、群主或超级用户管理当前群的插件开关。"""
+    action = args.extract_plain_text().strip().lower()
+    group_id = str(event.group_id)
+    if action == "status":
+        enabled = state.is_enabled(group_id)
+        await group_rename_command.send("改群名：已开启" if enabled else "改群名：已关闭")
+        return
+    if action not in {"on", "off"}:
+        await group_rename_command.send("用法：/group_rename 或 /改群名，后接 on|off|status")
+        return
+
+    # 关闭须等待当前群已开始的改名完成；排队中的改名随后会重新检查开关。
+    async with _group_lock(group_id):
+        try:
+            changed = await state.set_enabled(group_id, action == "on")
+        except OSError as exc:
+            logger.error(f"保存群 {group_id} 的改群名开关失败: {exc}")
+            await group_rename_command.send("改群名开关保存失败")
+            return
+    status = "已开启" if action == "on" else "已关闭"
+    await group_rename_command.send(f"改群名：{status}" if changed else f"改群名：已经{status[1:]}")
+
+
+# ================================ 群名修改 ================================ #
+
+rename_matcher = on_message(rule=_is_rename_message, priority=1, block=False)
+
+
+@rename_matcher.handle()
+async def handle_rename(bot: Bot, event: GroupMessageEvent) -> None:
+    """按群串行读取当前群名，在冷却许可时提交改名。"""
+    trigger = _message_trigger(event)
+    if trigger is None:
+        return
+
+    group_id = str(event.group_id)
+    async with _group_lock(group_id):
+        # 匹配到执行之间可能关闭群开关或改动权限，必须再次检查。
+        if not state.is_enabled(group_id):
+            return
+        if config.group_rename_admin_only and not _is_group_admin_or_superuser(event):
+            return
+        if not cooldown.allow(group_id):
+            if config.group_rename_enable_notify:
+                await rename_matcher.send("⏳改名太频繁，请稍后再试")
+            return
+
+        # ================================ 读取当前群名 ================================ #
+        # 禁用适配器缓存，连续改名以服务端当前群名为准。
+        try:
+            info = await bot.get_group_info(group_id=event.group_id, no_cache=True)
+        except ActionFailed as exc:
+            logger.error(f"读取群 {group_id} 名称被 OneBot 拒绝: {exc!r}")
+            if config.group_rename_enable_notify:
+                await rename_matcher.send("❌读取群名失败：OneBot 接口返回错误")
+            return
+        except Exception as exc:
+            logger.error(f"读取群 {group_id} 名称异常: {exc!r}")
+            if config.group_rename_enable_notify:
+                await rename_matcher.send("❌读取群名失败：请求异常，请稍后重试")
+            return
+
+        if not isinstance(info, Mapping) or not isinstance(info.get("group_name"), str):
+            logger.error(f"群 {group_id} 的信息缺少可用群名")
+            if config.group_rename_enable_notify:
+                await rename_matcher.send("❌读取群名失败：接口未返回有效群名")
+            return
+
+        # ================================ 构造并提交群名 ================================ #
+        current_name = info["group_name"]
+        try:
+            target_name = build_group_name(
+                current_name,
+                None if trigger == "clear" else trigger,
+                config.group_rename_max_length,
+            )
+            # OneBot 的 set_group_name 不能提交空群名；仅有车牌时保留原名并提示。
+            if not target_name:
+                cooldown.cancel_noop(group_id)
+                if config.group_rename_enable_notify:
+                    await rename_matcher.send("群名只剩车牌，无法清空；请先手动设置群名")
+                return
+            if target_name == current_name:
+                cooldown.cancel_noop(group_id)
+                return
+            await bot.set_group_name(group_id=event.group_id, group_name=target_name)
+        except ActionFailed as exc:
+            logger.error(f"修改群 {group_id} 名称被 OneBot 拒绝: {exc!r}")
+            if config.group_rename_enable_notify:
+                message = (
+                    "❌改群名失败：Bot 缺少修改群名的权限"
+                    if _is_permission_failure(exc)
+                    else "❌改群名失败：OneBot 拒绝了改名请求，请检查 Bot 权限或服务端日志"
+                )
+                await rename_matcher.send(message)
+        except Exception as exc:
+            logger.error(f"修改群 {group_id} 名称异常: {exc!r}")
+            if config.group_rename_enable_notify:
+                await rename_matcher.send("❌改群名失败：请求异常，请稍后重试")

nonebot_plugin_group_rename-0.1.0/nonebot_plugin_group_rename/config.py

@@ -0,0 +1,37 @@
+"""独立插件的 JSON 配置项与加载逻辑。"""
+
+from pathlib import Path
+
+from nonebot import logger
+from pydantic import BaseModel, ConfigDict, Field, ValidationError
+
+
+class Config(BaseModel):
+    """校验改群名参数；使用独立文件，避免依赖宿主 Bot 的配置格式。"""
+
+    model_config = ConfigDict(extra="forbid")
+
+    # 至少容纳完整五位车牌，防止长度配置把有效车牌截断成无效群名前缀。
+    group_rename_max_length: int = Field(default=30, ge=5)
+    group_rename_enable_notify: bool = True
+    group_rename_admin_only: bool = False
+    group_rename_ignore_patterns: list[str] = Field(default_factory=list)
+    group_rename_cooldown_seconds: float = Field(default=1, ge=0)
+
+
+# ================================ JSON 配置加载 ================================ #
+
+
+def load_config(path: Path) -> Config:
+    """从 localstore 配置文件加载参数；无文件时使用默认值，有错时阻止插件加载。"""
+    if not path.exists():
+        logger.info(f"改群名使用默认配置；可在 {path} 创建 JSON 文件自定义参数")
+        return Config()
+
+    try:
+        config = Config.model_validate_json(path.read_text(encoding="utf-8"))
+    except (OSError, ValidationError) as exc:
+        raise RuntimeError(f"读取改群名配置文件 {path} 失败: {exc}") from exc
+
+    logger.info(f"改群名已读取配置文件: {path}")
+    return config

nonebot_plugin_group_rename-0.1.0/nonebot_plugin_group_rename/logic.py

@@ -0,0 +1,73 @@
+"""消息识别、群名构造和按群冷却。"""
+
+from __future__ import annotations
+
+import re
+import time
+from collections.abc import Iterable
+
+
+# 车牌必须是连续五位；旧群名中的五位及以上数字按整段删除。
+DIGIT_PATTERN = re.compile(r"^\d{5}$")
+OLD_NUMBER_PATTERN = re.compile(r"\d{5,}")
+
+
+# ================================ 消息识别 ================================ #
+
+
+def classify_message(message: str, ignored: list[str]) -> str | None:
+    """返回五位车牌或清空标记；其他文本不触发改名。"""
+    message = message.strip()
+    if message == "清空":
+        return "clear"
+    if DIGIT_PATTERN.fullmatch(message) and message not in ignored:
+        return message
+    return None
+
+
+def message_trigger(segments: Iterable[tuple[str, str]], ignored: list[str]) -> str | None:
+    """仅识别单段连续文本，允许前后存在 @、图片或回复。"""
+    runs: list[str] = []
+    current: list[str] = []
+    for segment_type, content in segments:
+        if segment_type == "text":
+            current.append(content)
+        elif current:
+            runs.append("".join(current).strip())
+            current.clear()
+    if current:
+        runs.append("".join(current).strip())
+
+    # 非文本段夹在两段数字中间时，不能跨段拼成车牌。
+    nonempty_runs = [run for run in runs if run]
+    return classify_message(nonempty_runs[0], ignored) if len(nonempty_runs) == 1 else None
+
+
+# ================================ 群名构造 ================================ #
+
+
+def build_group_name(current_name: str, prefix: str | None, max_length: int) -> str:
+    """清理旧数字，新增车牌时与原群名之间留一个空格。"""
+    pure_name = OLD_NUMBER_PATTERN.sub("", current_name).strip()
+    target = pure_name if prefix is None else f"{prefix} {pure_name}" if pure_name else prefix
+    return target[:max_length].rstrip() if len(target) > max_length else target
+
+
+class GroupCooldown:
+    """按群记录操作尝试；失败请求也进入冷却。"""
+
+    def __init__(self, seconds: float = 1):
+        self.seconds = seconds
+        self.last_by_group: dict[str, float] = {}
+
+    def allow(self, group_id: str) -> bool:
+        """检查冷却并登记本次操作；由调用者在同群锁内调用。"""
+        now = time.monotonic()
+        if now - self.last_by_group.get(group_id, float("-inf")) < self.seconds:
+            return False
+        self.last_by_group[group_id] = now
+        return True
+
+    def cancel_noop(self, group_id: str) -> None:
+        """当前群无需提交改名时撤销本次登记；调用者须持有同群锁。"""
+        self.last_by_group.pop(group_id, None)