ErisPulse 1.2.4__tar.gz → 1.2.7__tar.gz

{erispulse-1.2.4 → erispulse-1.2.7}/.github/tools/update-api-docs.py

@@ -26,7 +26,7 @@ def update_reference_docs(module_name, docs, reference_path, module_path):
     with open(reference_path, 'r', encoding='utf-8') as f:
         content = f.read()
     
-    github_base_url = "https://raw.githubusercontent.com/ErisPulse/ErisPulse/refs/heads/main/"
+    github_base_url = "https://raw.githubusercontent.com/ErisPulse/ErisPulse/refs/heads/main/src/"
     github_source_url = github_base_url + module_path.replace('\\', '/')
     
     section_header = f"## {module_name} (source: [{module_path}]({github_source_url}))"

{erispulse-1.2.4 → erispulse-1.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 1.2.4
+Version: 1.2.7
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>, runoneall <runoobsteve@gmail.com>
 License: MIT License
@@ -38,13 +38,15 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
+Requires-Python: >=3.8
 Requires-Dist: aiohttp
-Requires-Dist: importlib>=1.0.4
+Requires-Dist: importlib
 Requires-Dist: pip
 Requires-Dist: watchdog
 Description-Content-Type: text/markdown
@@ -54,7 +56,6 @@ Description-Content-Type: text/markdown
 ![ErisPulse Logo](.github/assets/erispulse_logo.png)
 
 [![FramerOrg](https://img.shields.io/badge/合作伙伴-FramerOrg-blue?style=flat-square)](https://github.com/FramerOrg)
-[![License](https://img.shields.io/github/license/ErisPulse/ErisPulse?style=flat-square)](https://github.com/ErisPulse/ErisPulse/blob/main/LICENSE)
 [![Python Versions](https://img.shields.io/pypi/pyversions/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
 
 > 文档站: 
@@ -203,4 +204,4 @@ epsdk run your_script.py --reload
 
 ---
 
-[加入社区讨论 →](https://github.com/ErisPulse/ErisPulse/discussions)
+[加入社区讨论 →](https://github.com/ErisPulse/ErisPulse/discussions)

{erispulse-1.2.4 → erispulse-1.2.7}/README.md

@@ -3,7 +3,6 @@
 ![ErisPulse Logo](.github/assets/erispulse_logo.png)
 
 [![FramerOrg](https://img.shields.io/badge/合作伙伴-FramerOrg-blue?style=flat-square)](https://github.com/FramerOrg)
-[![License](https://img.shields.io/github/license/ErisPulse/ErisPulse?style=flat-square)](https://github.com/ErisPulse/ErisPulse/blob/main/LICENSE)
 [![Python Versions](https://img.shields.io/pypi/pyversions/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
 
 > 文档站: 
@@ -152,4 +151,4 @@ epsdk run your_script.py --reload
 
 ---
 
-[加入社区讨论 →](https://github.com/ErisPulse/ErisPulse/discussions)
+[加入社区讨论 →](https://github.com/ErisPulse/ErisPulse/discussions)

erispulse-1.2.7/devs/test_adapter.py

@@ -0,0 +1,225 @@
+from ErisPulse import sdk
+import asyncio
+from pathlib import Path
+
+# 测试文件路径
+CURRENT_DIR = Path(__file__).parent / "test_files"
+TEST_IMAGE_PATH = CURRENT_DIR / "test.jpg"
+TEST_VIDEO_PATH = CURRENT_DIR / "test.mp4"
+TEST_DOCUMENT_PATH = CURRENT_DIR / "test.docx"
+
+# 各平台测试配置
+TELEGRAM_USER_ID = "6117725680"
+TELEGRAM_GROUP_ID = "-1001234567890"  # None 表示不发群聊
+
+QQ_USER_ID = "123456789"
+QQ_GROUP_ID = "782199153"  # None 表示不发群聊
+
+YUNHU_USER_ID = "5197892"
+YUNHU_GROUP_ID = "635409929"  # None 表示不发群聊
+
+async def telegram_test(startup: bool):
+    if not hasattr(sdk.adapter, "telegram"):
+        return
+    telegram = sdk.adapter.telegram
+    if startup:
+        await telegram.Send.To("user", TELEGRAM_USER_ID).Text("【启动通知】SDK已启动 - Telegram文本消息")
+        if TEST_IMAGE_PATH.exists():
+            with open(TEST_IMAGE_PATH, "rb") as f:
+                await telegram.Send.To("user", TELEGRAM_USER_ID).Image(f.read())
+        if TEST_VIDEO_PATH.exists():
+            with open(TEST_VIDEO_PATH, "rb") as f:
+                await telegram.Send.To("user", TELEGRAM_USER_ID).Video(f.read())
+        if TEST_DOCUMENT_PATH.exists():
+            with open(TEST_DOCUMENT_PATH, "rb") as f:
+                await telegram.Send.To("user", TELEGRAM_USER_ID).Document(f.read())
+        if TELEGRAM_GROUP_ID:
+            await telegram.Send.To("group", TELEGRAM_GROUP_ID).Text("【启动通知】SDK已启动 - Telegram群聊文本消息")
+            if TEST_IMAGE_PATH.exists():
+                with open(TEST_IMAGE_PATH, "rb") as f:
+                    await telegram.Send.To("group", TELEGRAM_GROUP_ID).Image(f.read())
+            if TEST_VIDEO_PATH.exists():
+                with open(TEST_VIDEO_PATH, "rb") as f:
+                    await telegram.Send.To("group", TELEGRAM_GROUP_ID).Video(f.read())
+            if TEST_DOCUMENT_PATH.exists():
+                with open(TEST_DOCUMENT_PATH, "rb") as f:
+                    await telegram.Send.To("group", TELEGRAM_GROUP_ID).Document(f.read())
+    else:
+        await telegram.Send.To("user", TELEGRAM_USER_ID).Text("【关闭通知】SDK已关闭")
+        if TELEGRAM_GROUP_ID:
+            await telegram.Send.To("group", TELEGRAM_GROUP_ID).Text("【关闭通知】SDK已关闭")
+
+async def qq_test(startup: bool):
+    if not hasattr(sdk.adapter, "QQ"):
+        return
+    qq = sdk.adapter.QQ
+    if startup:
+        await asyncio.sleep(5)
+        await qq.Send.To("user", QQ_USER_ID).Text("【启动通知】SDK已启动 - QQ文本消息")
+        if TEST_IMAGE_PATH.exists():
+            with open(TEST_IMAGE_PATH, "rb") as f:
+                await qq.Send.To("user", QQ_USER_ID).Image(f.read())
+        if TEST_VIDEO_PATH.exists():
+            with open(TEST_VIDEO_PATH, "rb") as f:
+                await qq.Send.To("user", QQ_USER_ID).Video(f.read())
+        if TEST_DOCUMENT_PATH.exists():
+            with open(TEST_DOCUMENT_PATH, "rb") as f:
+                await qq.Send.To("user", QQ_USER_ID).Document(f.read())
+        if QQ_GROUP_ID:
+            await qq.Send.To("group", QQ_GROUP_ID).Text("【启动通知】SDK已启动 - QQ群聊文本消息")
+            if TEST_IMAGE_PATH.exists():
+                with open(TEST_IMAGE_PATH, "rb") as f:
+                    await qq.Send.To("group", QQ_GROUP_ID).Image(f.read())
+            if TEST_VIDEO_PATH.exists():
+                with open(TEST_VIDEO_PATH, "rb") as f:
+                    await qq.Send.To("group", QQ_GROUP_ID).Video(f.read())
+            if TEST_DOCUMENT_PATH.exists():
+                with open(TEST_DOCUMENT_PATH, "rb") as f:
+                    await qq.Send.To("group", QQ_GROUP_ID).Document(f.read())
+    else:
+        await qq.Send.To("user", QQ_USER_ID).Text("【关闭通知】SDK已关闭")
+        if QQ_GROUP_ID:
+            await qq.Send.To("group", QQ_GROUP_ID).Text("【关闭通知】SDK已关闭")
+
+async def yunhu_test(startup: bool):
+    if not hasattr(sdk.adapter, "Yunhu"):
+        return
+    yunhu = sdk.adapter.Yunhu
+    if startup:
+        buttons = [
+            [{"text": "复制", "actionType": 2, "value": "xxxx"}],
+            [{"text": "点击跳转", "actionType": 1, "url": "http://www.baidu.com"}]
+        ]
+
+        # 文本消息 + 按钮
+        response_text = await yunhu.Send.To("user", YUNHU_USER_ID).Text("【启动通知】SDK已启动 - 带按钮文本消息", buttons=buttons)
+        print("文本消息发送返回值:", response_text)
+
+        # HTML 消息
+        response_html = await yunhu.Send.To("user", YUNHU_USER_ID).Html("<b>这是一条HTML消息</b>")
+        print("HTML消息发送返回值:", response_html)
+
+        # Markdown 消息
+        response_md = await yunhu.Send.To("user", YUNHU_USER_ID).Markdown("# 这是一条Markdown消息")
+        print("Markdown消息发送返回值:", response_md)
+
+        # 图片消息
+        if TEST_IMAGE_PATH.exists():
+            with open(TEST_IMAGE_PATH, "rb") as f:
+                image_data = f.read()
+                response_image = await yunhu.Send.To("user", YUNHU_USER_ID).Image(image_data)
+                print("图片消息发送返回值:", response_image)
+
+        # 视频消息
+        if TEST_VIDEO_PATH.exists():
+            with open(TEST_VIDEO_PATH, "rb") as f:
+                video_data = f.read()
+                response_video = await yunhu.Send.To("user", YUNHU_USER_ID).Video(video_data)
+                print("视频消息发送返回值:", response_video)
+
+        # 文件消息
+        if TEST_DOCUMENT_PATH.exists():
+            with open(TEST_DOCUMENT_PATH, "rb") as f:
+                file_data = f.read()
+                response_file = await yunhu.Send.To("user", YUNHU_USER_ID).File(file_data)
+                print("文件消息发送返回值:", response_file)
+
+        # 批量发送测试
+        test_user_ids = [YUNHU_USER_ID, "5197893", "5197894"]  # 模拟多个用户ID
+        
+        # 1. 文本消息批量发送
+        response_batch_text = await yunhu.Send.To("user", test_user_ids).Text("批量文本测试消息")
+        print("批量文本消息发送返回值:", response_batch_text)
+        
+        # 2. HTML消息批量发送
+        response_batch_html = await yunhu.Send.To("user", test_user_ids).Html("<b>批量HTML测试消息</b>")
+        print("批量HTML消息发送返回值:", response_batch_html)
+        
+        # 3. Markdown消息批量发送
+        response_batch_md = await yunhu.Send.To("user", test_user_ids).Markdown("# 批量Markdown测试消息")
+        print("批量Markdown消息发送返回值:", response_batch_md)
+        
+        # 4. 图片批量发送
+        if TEST_IMAGE_PATH.exists():
+            with open(TEST_IMAGE_PATH, "rb") as f:
+                image_data = f.read()
+                response_batch_image = await yunhu.Send.To("user", test_user_ids).Image(image_data)
+                print("批量图片消息发送返回值:", response_batch_image)
+        # 5. 文件批量发送
+        if TEST_DOCUMENT_PATH.exists():
+            with open(TEST_DOCUMENT_PATH, "rb") as f:
+                file_data = f.read()
+                response_batch_file = await yunhu.Send.To("user", test_user_ids).File(file_data)
+                print("批量文件消息发送返回值:", response_batch_file)
+                
+        # 6. 保留原Batch方法测试(已弃用)
+        response_batch_old = await yunhu.Send.To("user", YUNHU_USER_ID).Batch([YUNHU_USER_ID], "旧批量方法测试消息")
+        print("旧批量方法发送返回值:", response_batch_old)
+
+        # 编辑消息（需要 msg_id）
+        if 'response_text' in locals() and 'msgId' in response_text.get('data', {}).get('messageInfo', {}):
+            msg_id = response_text['data']['messageInfo']['msgId']
+            response_edit = await yunhu.Send.To("user", YUNHU_USER_ID).Edit(msg_id, "这是编辑后的消息")
+            print("编辑消息发送返回值:", response_edit)
+
+        # 撤回消息（需要 msg_id）
+        if 'msg_id' in locals():
+            response_recall = await yunhu.Send.To("user", YUNHU_USER_ID).Recall(msg_id)
+            print("撤回消息发送返回值:", response_recall)
+        
+        # 流式消息
+        async def stream_generator():
+            for i in range(3):
+                yield f"流式片段{i}".encode('utf-8')
+                await asyncio.sleep(1)
+
+        response_stream = await yunhu.Send.To("user", YUNHU_USER_ID).Stream("text", stream_generator())
+        print("流式消息发送返回值:", response_stream)
+
+        # 群聊消息
+        if YUNHU_GROUP_ID:
+            response_group_text = await yunhu.Send.To("group", YUNHU_GROUP_ID).Text("【群聊通知】SDK已启动")
+            print("群聊文本消息发送返回值:", response_group_text)
+
+            if TEST_IMAGE_PATH.exists():
+                with open(TEST_IMAGE_PATH, "rb") as f:
+                    image_data = f.read()
+                    response_group_image = await yunhu.Send.To("group", YUNHU_GROUP_ID).Image(image_data)
+                    print("群聊图片消息发送返回值:", response_group_image)
+
+            if TEST_VIDEO_PATH.exists() is None:
+                with open(TEST_VIDEO_PATH, "rb") as f:
+                    video_data = f.read()
+                    response_group_video = await yunhu.Send.To("group", YUNHU_GROUP_ID).Video(video_data)
+                    print("群聊视频消息发送返回值:", response_group_video)
+
+    else:
+        # 关闭时发送关闭通知
+        response_shutdown = await yunhu.Send.To("user", YUNHU_USER_ID).Text("【关闭通知】SDK已关闭")
+        print("关闭通知消息发送返回值:", response_shutdown)
+
+        if YUNHU_GROUP_ID:
+            response_group_shutdown = await yunhu.Send.To("group", YUNHU_GROUP_ID).Text("【关闭通知】SDK已关闭")
+            print("群聊关闭通知消息发送返回值:", response_group_shutdown)
+async def main():
+    sdk.init()
+    try:
+        sdk.logger.set_output_file("test.log")
+        await sdk.adapter.startup()
+        await asyncio.sleep(1)
+        # await telegram_test(True)
+        # await qq_test(True)
+        await yunhu_test(True)
+        while True:
+            await asyncio.sleep(1)
+    except KeyboardInterrupt:
+        sdk.logger.info("收到关闭信号，准备发送关闭通知...")
+        await telegram_test(False)
+        await qq_test(False)
+        await yunhu_test(False)
+    except Exception as e:
+        sdk.logger.error(f"测试过程中发生错误: {str(e)}")
+        raise  # 重新抛出异常以便调试
+
+if __name__ == "__main__":
+    asyncio.run(main())

{erispulse-1.2.4 → erispulse-1.2.7}/docs/ADAPTERS.md

@@ -48,6 +48,10 @@ await yunhu.Send.To("user", user_id).Text("Hello World!")
 - `.Board(board_type: str, content: str, **kwargs)`：发布公告看板。
 - `.Stream(content_type: str, generator: AsyncGenerator)`：发送流式消息。
 
+Borard board_type 支持以下类型：
+- `local`：指定用户看板
+- `global`：全局看板
+
 #### 按钮参数说明
 `buttons` 参数是一个嵌套列表，表示按钮的布局和功能。每个按钮对象包含以下字段：
 
@@ -63,11 +67,44 @@ await yunhu.Send.To("user", user_id).Text("Hello World!")
 buttons = [
     [
         {"text": "复制", "actionType": 2, "value": "xxxx"},
-        {"text": "点击跳转", "actionType": 1, "url": "http://www.baidu.com"}
+        {"text": "点击跳转", "actionType": 1, "url": "http://www.baidu.com"},
+        {"text": "汇报事件", "actionType": 3, "value", "xxxxx"}
     ]
 ]
 await yunhu.Send.To("user", user_id).Text("带按钮的消息", buttons=buttons)
 ```
+> **注意：**
+> - 只有用户点击了**按钮汇报事件**的按钮才会收到推送，**复制***和**跳转URL**均无法收到推送。
+
+#### 主要方法返回值示例(Send.To(Type, ID).)
+1. .Text/.Html/Markdown/.Image/.Video/.File
+```json
+{
+  "code": 1,
+  "data": {
+    "messageInfo": {
+      "msgId": "65a314006db348be97a09eb065985d2d",
+      "recvId": "5197892",
+      "recvType": "user"
+    }
+  },
+  "msg": "success"
+}
+```
+
+2. .Batch
+```json
+{
+    "code": 1,
+    "data": {
+        "successCount": 1,
+        "successList": [
+            {"msgId": "65a314006db348be97a09eb065985d2d", "recvId": "5197892", "recvType": "user"}
+        ]
+    },
+    "msg": "success"
+}
+```
 
 #### env.py 配置示例
 ```python
@@ -101,7 +138,6 @@ sdk.env.set("YunhuAdapter", {
 |bot.unfollowed|机器人取关|
 |bot.shortcut.menu|快捷菜单|
 |button.report.inline|按钮汇报|
-|bot.setting|机器人设置|
 
 每个事件的触发条件以及数据结构如下：
 
@@ -184,14 +220,14 @@ sdk.env.set("YunhuAdapter", {
     }
 }
 ```
-##### 用户加群事件
+##### 用户加群/退群事件
 当用户加入机器人所在的群聊后，将会触发该事件。
 ```json
 {
     "version": "1.0",
     "header": {
         "eventId": "d5429cb5e4654fbcaeee9e4adb244741",
-        "eventType": "group.join",
+        "eventType": "group.join",  // 或 group.leave
         "eventTime": 1749442891943
     },
     "event": {
@@ -204,33 +240,14 @@ sdk.env.set("YunhuAdapter", {
     }
 }
 ```
-##### 用户退群事件
-```json
-{
-    "version": "1.0",
-    "header": {
-        "eventId": "06959e95aaf547078367104ba754c554",
-        "eventType": "group.leave",
-        "eventTime": 1749442644367
-    },
-    "event": {
-        "time": 1749442644343,
-        "chatId": "985140593",
-        "chatType": "group",
-        "userId": "3707697",
-        "nickname": "ShanFishApp",
-        "avatarUrl": "https://chat-storage1.jwznb.com/defalut-avatars/Ma%20Rainey.png?sign=92fdef22a240a05de78b13afdab5ac51&t=68466e64"
-    }
-}
-```
-##### 用户关注机器人事件
+##### 用户关注/取关机器人事件
 当用户在机器人ID或机器人推荐处添加机器人后，将会触发该事件。
 ```json
 {
     "version": "1.0",
     "header": {
         "eventId": "3fe280a400f9460daa03a642d1fad39b",
-        "eventType": "bot.followed",
+        "eventType": "bot.followed", // 或 bot.unfollowed
         "eventTime": 1749443049592
     },
     "event": {
@@ -243,26 +260,6 @@ sdk.env.set("YunhuAdapter", {
     }
 }
 ```
-##### 用户取关机器人事件
-当用户点击删除机器人按钮后，将会触发该事件。
-```json
-{
-    "version": "1.0",
-    "header": {
-        "eventId": "b4f51386d916464b99782052c030c5b7",
-        "eventType": "bot.unfollowed",
-        "eventTime": 1749443036382
-    },
-    "event": {
-        "time": 1749443036373,
-        "chatId": "49871624",
-        "chatType": "bot",
-        "userId": "3707697",
-        "nickname": "ShanFishApp",
-        "avatarUrl": "https://chat-storage1.jwznb.com/defalut-avatars/Ma%20Rainey.png?sign=07cf8e9d6ca0875835f9a4a6811b6b4c&t=68466fec"
-    }
-}
-```
 ##### 按钮汇报事件
 机器人可以发送带按钮的消息。当用户按下按钮actionType为3(汇报类按钮)的按钮时，将会触发该事件。
 ```json
@@ -308,35 +305,7 @@ sdk.env.set("YunhuAdapter", {
 }
 
 ```
-##### 机器人设置事件
-当开发者配置了机器人设置项时，在机器人列表处将会出现"设置"按钮。用户设置完成后，将会触发本事件。
-```json
-{
-    "version": "1.0",
-    "header": {
-        "eventId": "5ad7e23399ef46a685cead1abe2efa19",
-        "eventType": "bot.setting",
-        "eventTime": 1749446299131
-    },
-    "event": {
-        "time": 1749446299128,
-        "chatId": "49871624",
-        "chatType": "bot",
-        "groupId": "985140593",
-        "groupName": "云湖测试群",
-        "avatarUrl": "https://chat-img.jwznb.com/77db590d9cee77de13e7c8cf0887b5ba.jpg",
-        "settingJson": {
-            "wezzrm": {
-                "id": "wezzrm",
-                "type": "switch",
-                "label": "测试",
-                "value": true
-            }
-        }
-    }
-}
 
-```
 
 #### 注意：`chat` 与 `sender` 的误区
 
@@ -344,9 +313,9 @@ sdk.env.set("YunhuAdapter", {
 
 | 字段 | 含义 |
 |------|------|
-| `data.event.chatType` | 当前聊天类型（`user`/`bot` 或 `group`） |
-| `data.event.sender.senderType` | 发送者类型（通常为 `user`） |
-| `data.event.sender.senderId` | 发送者唯一 ID |
+| `data.get("event", {}).get("chat", {}).get("chatType", "")` | 当前聊天类型（`user`/`bot` 或 `group`） |
+| `data.get("event", {}).get("sender", {}).get("senderType", "")` | 发送者类型（通常为 `user`） |
+| `data.get("event", {}).get("sender", {}).get("senderId", "")` | 发送者唯一 ID |
 
 > **注意：**  
 > - 使用 `chatType` 判断消息是私聊还是群聊  
@@ -360,11 +329,11 @@ sdk.env.set("YunhuAdapter", {
 ```python
 @sdk.adapter.Yunhu.on("message")
 async def handle_message(data):
-    if data.event.chatType == "group":
-        targetId = data.event.chat.chatId
+    if data.get("event", {}).get("chat", {}).get("chatType", "") == "group":
+        targetId = data.get("event", {}).get("chat", {}).get("chatId", "")
         targeType = "group"
     else:
-        targetId = data.event.sender.senderId
+        targetId = data.get("event", {}).get("sender", {}).get("senderId", "")
         targeType = "user"
 
     await sdk.adapter.Yunhu.Send.To(targeType, targetId).Text("收到你的消息！")

{erispulse-1.2.4 → erispulse-1.2.7}/docs/CHANGELOG.md

@@ -8,6 +8,24 @@
 > **贡献日志**
 > 如需为新版本添加日志，请在对应版本号下补充内容，并注明日期和主要贡献者。
 
+## [1.2.6]
+> 这是一个兼容性控制版本
+### 新增
+- 新增 sdk.logger.get_logs([ModuleName]) 方法，用于获取底层日志内容
+### 变更
+- 优化部分注解类型以兼容更多Python版本
+- 注解从 py3.10+ 的原生注解改为typings注解 | 已在 py3.8+ 版本中测试通过
+
+---
+
+## [1.2.5]
+### 修复
+- 现在CLI更新模块时会进行依赖检测并自动补全
+### 变更
+- 调整Adapter类引用关系（不影响其他模块）
+
+---
+
 ## [1.2.4]
 ### 修复
 - 恢复 raiserr 的加载以解决兼容性问题

{erispulse-1.2.4 → erispulse-1.2.7}/docs/DEVELOPMENT.md

@@ -80,6 +80,18 @@ sdk.env.set_snapshot_interval(3600)  # 设置自动快照间隔(秒)
 # - 快照适合在重大变更前创建
 ```
 
+须知：
+模块在env.py中的定义的配置项是硬加载的，每次重启都会被重新加载覆盖原来的key值，不会保留之前的配置；所以谨慎使用您的env.py中的配置项进行任何存储行为！
+如，一个屏蔽词模块在env.py中存储着全局屏蔽词列表，如果使用env.py中的配置项存储，那么每次重启都会丢失屏蔽词列表，导致屏蔽词失效！
+这时建议的方法是：使用一个全新的key存储，每次初始化的时候使用类似以下代码获取配置项：
+```python
+a = env.get("模块在env.py中存储的key", "default_value")
+b = env.get("一个用来存储动态屏蔽词的全新的key", "default_value")
+
+# 那么我们使用的屏蔽词列表为：
+self.band_words = a + b
+```
+
 #### 注册自定义错误类型：
 
 ```python