优化开箱次数判断

utils/message_builder.py

@@ -13,10 +13,10 @@ def image(
         b64: str = None,
 ) -> Union[MessageSegment, str]:
     """
-    说明：
+    说明:
         生成一个 MessageSegment.image 消息
         生成顺序：绝对路径(abspath) > base64(b64) > img_name
-    参数：
+    参数:
         :param file: 图片文件名称，默认在 resource/img 目录下
         :param path: 图片所在路径，默认在 resource/img 目录下
         :param b64: 图片base64
@@ -42,11 +42,11 @@ def image(
             return ""
 
 
-def at(qq: int) -> MessageSegment:
+def at(qq: Union[int, str]) -> MessageSegment:
     """
-    说明：
+    说明:
         生成一个 MessageSegment.at 消息
-    参数：
+    参数:
         :param qq: qq号
     """
     return MessageSegment.at(qq)
@@ -54,9 +54,9 @@ def at(qq: int) -> MessageSegment:
 
 def record(voice_name: str, path: str = None) -> MessageSegment or str:
     """
-    说明：
+    说明:
         生成一个 MessageSegment.record 消息
-    参数：
+    参数:
         :param voice_name: 音频文件名称，默认在 resource/voice 目录下
         :param path: 音频文件路径，默认在 resource/voice 目录下
     """
@@ -79,9 +79,9 @@ def record(voice_name: str, path: str = None) -> MessageSegment or str:
 
 def text(msg: str) -> MessageSegment:
     """
-    说明：
+    说明:
         生成一个 MessageSegment.text 消息
-    参数：
+    参数:
         :param msg: 消息文本
     """
     return MessageSegment.text(msg)
@@ -89,9 +89,9 @@ def text(msg: str) -> MessageSegment:
 
 def contact_user(qq: int) -> MessageSegment:
     """
-    说明：
+    说明:
         生成一个 MessageSegment.contact_user 消息
-    参数：
+    参数:
         :param qq: qq号
     """
     return MessageSegment.contact_user(qq)
@@ -101,9 +101,9 @@ def share(
         url: str, title: str, content: str = None, image_url: str = None
 ) -> MessageSegment:
     """
-    说明：
+    说明:
         生成一个 MessageSegment.share 消息
-    参数：
+    参数:
         :param url: 自定义分享的链接
         :param title: 自定义分享的包体
         :param content: 自定义分享的内容
@@ -114,9 +114,9 @@ def share(
 
 def xml(data: str) -> MessageSegment:
     """
-    说明：
+    说明:
         生成一个 MessageSegment.xml 消息
-    参数：
+    参数:
         :param data: 数据文本
     """
     return MessageSegment.xml(data)
@@ -124,9 +124,9 @@ def xml(data: str) -> MessageSegment:
 
 def json(data: str) -> MessageSegment:
     """
-    说明：
+    说明:
         生成一个 MessageSegment.json 消息
-    参数：
+    参数:
         :param data: 消息数据
     """
     return MessageSegment.json(data)
@@ -134,9 +134,9 @@ def json(data: str) -> MessageSegment:
 
 def face(id_: int) -> MessageSegment:
     """
-    说明：
+    说明:
         生成一个 MessageSegment.face 消息
-    参数：
+    参数:
         :param id_: 表情id
     """
     return MessageSegment.face(id_)
@@ -144,9 +144,9 @@ def face(id_: int) -> MessageSegment:
 
 def poke(qq: int) -> MessageSegment:
     """
-    说明：
+    说明:
         生成一个 MessageSegment.poke 消息
-    参数：
+    参数:
         :param qq: qq号
     """
     return MessageSegment("poke", {"qq": qq})
@@ -160,10 +160,12 @@ def custom_forward_msg(
         msg_list: List[Union[str, Message]], uin: Union[int, str], name: str = f"这里是{NICKNAME}"
 ) -> List[dict]:
     """
-    生成自定义合并消息
-    :param msg_list: 消息列表
-    :param uin: 发送者 QQ
-    :param name: 自定义名称
+    说明:
+        生成自定义合并消息
+    参数:
+        :param msg_list: 消息列表
+        :param uin: 发送者 QQ
+        :param name: 自定义名称
     """
     uin = int(uin)
     mes_list = []