feat(admin): 增加封禁用户理由并优化相关逻辑 (#1992)

* feat(admin): 增加封禁用户理由并优化相关逻辑

- 在 ban 命令中添加了 -r 或 --reason 选项，用于指定封禁理由
- 优化了 ban 命令的参数解析和处理逻辑
- 更新了数据库模型，增加了 ban_reason 字段用于存储封禁理由
- 修复了部分逻辑错误，如永久封禁的处理方式

* 🚨 auto fix by pre-commit hooks

* refactor(ban): 优化 ban 命令和相关功能

- 修复 ban 命令中的 reason 参数可选标记
- 完善恶意触发检测和用户昵称违规的禁言信息
- 统一禁言操作的参数顺序，提高代码可读性

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

zhenxun/builtin_plugins/admin/ban/_data_source.py

@@ -9,13 +9,13 @@ from zhenxun.services.log import logger
 from zhenxun.utils.image_utils import BuildImage, ImageTemplate
 
 
-async def call_ban(user_id: str, duration: int = 1):
+async def call_ban(user_id: str, reason: str | None = None, duration: int = 1):
     """调用ban
 
     参数:
         user_id: 用户id
     """
-    await BanConsole.ban(user_id, None, 9, duration * 60)
+    await BanConsole.ban(user_id, None, 9, reason, duration * 60)
     logger.info("被讨厌了，已将用户加入黑名单...", "ban", session=user_id)
 
 
@@ -55,20 +55,23 @@ class BanManage:
             "用户ID",
             "群组ID",
             "BAN LEVEL",
+            "封禁原因",
             "剩余时长(分钟)",
             "操作员ID",
         ]
         row_data = []
         for data in data_list:
-            duration = int((data.ban_time + data.duration - time.time()) / 60)
-            if data.duration < 0:
+            if data.duration == -1:
                 duration = "∞"
+            else:
+                duration = int((data.ban_time + data.duration - time.time()) / 60)
             row_data.append(
                 [
                     data.id,
                     data.user_id,
                     data.group_id,
                     data.ban_level,
+                    data.ban_reason,
                     duration,
                     data.operator,
                 ]
@@ -120,10 +123,15 @@ class BanManage:
             if ban_data.ban_level > user_level:
                 return False, "unBan权限等级不足捏..."
             await ban_data.delete()
-            return True, str(ban_data.user_id or ban_data.group_id)
+            return (
+                True,
+                f"用户 {ban_data.user_id}"
+                if ban_data.user_id
+                else f"群组 {ban_data.group_id}",
+            )
         elif await BanConsole.check_ban_level(user_id, group_id, user_level):
             await BanConsole.unban(user_id, group_id)
-            return True, str(group_id)
+            return True, f"群组 {group_id}"
         return False, "该用户/群组不在黑名单中不足捏..."
 
     @classmethod
@@ -131,6 +139,7 @@ class BanManage:
         cls,
         user_id: str | None,
         group_id: str | None,
+        reason: str | None,
         duration: int,
         session: EventSession,
         is_superuser: bool,
@@ -140,6 +149,7 @@ class BanManage:
         参数:
             user_id: 用户id
             group_id: 群组id
+            reason: 理由
             duration: 时长，秒
             session: Session
             is_superuser: 是否为超级用户操作
@@ -147,4 +157,4 @@ class BanManage:
         level = 9999
         if not is_superuser and user_id and session.id1:
             level = await LevelUser.get_user_level(session.id1, group_id)
-        await BanConsole.ban(user_id, group_id, level, duration, session.id1)
+        await BanConsole.ban(user_id, group_id, level, reason, duration, session.id1)