ErisPulse 2.1.15__tar.gz → 2.2.0__tar.gz

{erispulse-2.1.15 → erispulse-2.2.0}/.github/workflows/auto-tag-release.yml

@@ -5,7 +5,7 @@ permissions:
 
 on:
   push:
-    branches: [main]
+    branches: [main, Pre-Release/v2]
 
 jobs:
   auto-tag-and-release:
@@ -126,4 +126,4 @@ jobs:
               --prerelease=$is_dev
             echo "✨ 已发布新的魔法版本 $tag_name"
           fi
-          
+          

erispulse-2.2.0/CONTRIBUTING.md

@@ -0,0 +1,43 @@
+# 项目贡献指南
+
+## 分支管理规范
+
+### 分支结构
+- **main**: 主分支，存放稳定可发布的代码
+- **Develop/v2**: 开发主分支，所有功能分支最终合并至此
+- **Pre-Release/v2**: 预发布分支，用于版本发布前的测试
+- **feature/***: 功能开发分支，按功能命名
+- **Archive/v1**: 归档分支，存放旧版本代码
+
+## 贡献流程
+
+1. **Fork仓库**
+   - 首先fork主仓库到您的个人账户
+
+2. **创建个人分支**
+   - 从`Develop/v2`创建您的功能分支，命名规范：
+     - `feature/描述性名称` (如`feature/wsu2059q`) -> 可为长期的功能开发/修复分支
+
+3. **开发工作**
+   - 在您的功能分支上进行开发
+   - 保持提交信息清晰明确
+   - 提交前确保已经在ChangeLog中添加描述
+   - 定期从`Develop/v2`拉取更新以避免冲突
+
+4. **提交Pull Request**
+   - 开发完成后，向`Develop/v2`分支提交PR
+   - 在PR的模板中勾选对应选项 或 添加一些详情信息
+
+5. **合并到Develop/v2**
+   - 审查通过后，代码将被合并到`Develop/v2`
+
+6. **发布流程**
+   - 版本更新， `Develop/v2` 会随更新合并到 `Pre-Release/v2` 发布并进行测试
+   - 测试通过后，代码将最终发布到`main`分支
+
+## 注意事项
+
+- 请勿直接向`main`或`Pre-Release/v2`分支提交代码
+- 如有疑问，请联系 `support@erisdev.com` 或者 添加我们的社交讨论群: 云湖群ID -> 635409929
+
+感谢您的贡献！

{erispulse-2.1.15 → erispulse-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.1.15
+Version: 2.2.0
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
 License: MIT License

erispulse-2.2.0/devs/test_cmd.py

@@ -0,0 +1,242 @@
+import asyncio
+import json
+from ErisPulse import sdk
+from ErisPulse.Core.Event import command, message, notice, request, meta
+
+# 全局状态变量
+echo_status = False
+admin_users = ["5197892", "admin2"]  # 示例管理员用户ID
+
+@command("test", help="测试命令", usage="/test [参数]")
+async def test_command(event):
+    platform = event["platform"]
+    
+    if event.get("detail_type") == "group":
+        type = "group"
+        id = event["group_id"]
+    else:
+        type = "user"
+        id = event["user_id"]
+    
+    adapter = getattr(sdk.adapter, platform)
+    await adapter.Send.To(type, id).Text("收到测试命令")
+    sdk.logger.info(f"处理测试命令: {event}")
+
+@command("help", help="帮助命令", usage="/help")
+async def help_command(event):
+    platform = event["platform"]
+    
+    if event.get("detail_type") == "group":
+        type = "group"
+        id = event["group_id"]
+    else:
+        type = "user"
+        id = event["user_id"]
+
+    adapter = getattr(sdk.adapter, platform)
+    await adapter.Send.To(type, id).Text(command.help())
+
+@command("echo", help="控制事件回显", usage="/echo <on|off>")
+async def echo_control_command(event):
+    platform = event["platform"]
+    
+    if event.get("detail_type") == "group":
+        type = "group"
+        id = event["group_id"]
+    else:
+        type = "user"
+        id = event["user_id"]
+    
+    adapter = getattr(sdk.adapter, platform)
+    
+    alt_message = event["alt_message"].strip()
+    args = alt_message.split()[1:]
+    
+    global echo_status
+    
+    if not args:
+        status_text = "开启" if echo_status else "关闭"
+        await adapter.Send.To(type, id).Text(f"Echo当前状态: {status_text}")
+        return
+    
+    subcommand = args[0].lower()
+    
+    if subcommand == "on":
+        echo_status = True
+        await adapter.Send.To(type, id).Text("Echo已开启")
+    elif subcommand == "off":
+        echo_status = False
+        await adapter.Send.To(type, id).Text("Echo已关闭")
+    else:
+        await adapter.Send.To(type, id).Text("无效参数，请使用 'on' 或 'off'")
+
+@command(["alias", "别名"], aliases=["a"], help="别名命令测试", usage="/alias 或 /a")
+async def alias_command(event):
+    platform = event["platform"]
+    
+    if event.get("detail_type") == "group":
+        type = "group"
+        id = event["group_id"]
+    else:
+        type = "user"
+        id = event["user_id"]
+    
+    adapter = getattr(sdk.adapter, platform)
+    used_name = event["command"]["name"]
+    await adapter.Send.To(type, id).Text(f"通过别名 '{used_name}' 调用了命令")
+
+@command("admin", group="admin", help="管理员命令组测试", usage="/admin")
+async def admin_command(event):
+    platform = event["platform"]
+    
+    if event.get("detail_type") == "group":
+        type = "group"
+        id = event["group_id"]
+    else:
+        type = "user"
+        id = event["user_id"]
+    
+    adapter = getattr(sdk.adapter, platform)
+    await adapter.Send.To(type, id).Text("管理员命令执行成功")
+
+@command("hidden", hidden=True, help="隐藏命令", usage="/hidden")
+async def hidden_command(event):
+    platform = event["platform"]
+    
+    if event.get("detail_type") == "group":
+        type = "group"
+        id = event["group_id"]
+    else:
+        type = "user"
+        id = event["user_id"]
+    
+    adapter = getattr(sdk.adapter, platform)
+    await adapter.Send.To(type, id).Text("这是一个隐藏命令")
+
+@command("permission", help="权限检查测试", usage="/permission")
+def check_permission(event):
+    user_id = event.get("user_id")
+    return user_id in admin_users
+
+@command("permission", permission=check_permission, help="需要权限的命令", usage="/permission")
+async def permission_command(event):
+    platform = event["platform"]
+    
+    if event.get("detail_type") == "group":
+        type = "group"
+        id = event["group_id"]
+    else:
+        type = "user"
+        id = event["user_id"]
+    
+    adapter = getattr(sdk.adapter, platform)
+    await adapter.Send.To(type, id).Text("权限检查通过，命令执行成功")
+
+@command("args", help="参数测试命令", usage="/args <参数1> [参数2] ...")
+async def args_command(event):
+    platform = event["platform"]
+    
+    if event.get("detail_type") == "group":
+        type = "group"
+        id = event["group_id"]
+    else:
+        type = "user"
+        id = event["user_id"]
+    
+    adapter = getattr(sdk.adapter, platform)
+    
+    args = event["command"]["args"]
+    if not args:
+        await adapter.Send.To(type, id).Text("未提供参数")
+    else:
+        args_str = ", ".join(args)
+        await adapter.Send.To(type, id).Text(f"接收到参数: {args_str}")
+
+@sdk.adapter.on("message")
+async def echo_message(event):
+    global echo_status
+    platform = event["platform"]
+
+    if echo_status:
+        try:
+            adapter = getattr(sdk.adapter, platform)
+            
+            if event.get("detail_type") == "group":
+                target_type = "group"
+                target_id = event["group_id"]
+            else:
+                target_type = "user"
+                target_id = event["user_id"]
+            
+            event_copy = event.copy()
+            platform_raw_key = f"{platform}_raw"
+            if platform_raw_key in event_copy:
+                del event_copy[platform_raw_key]
+            
+            event_str = json.dumps(event_copy, ensure_ascii=False, indent=2)
+            if len(event_str) > 1000:
+                event_str = event_str[:1000] + "... (内容过长已截断)"
+            
+            await adapter.Send.To(target_type, target_id).Text(f"Event内容:\n{event_str}")
+        except Exception as e:
+            sdk.logger.error(f"Echo回显失败: {e}")
+
+    return event
+
+# 消息事件处理测试
+@message.on_message(priority=10)
+async def message_handler(event):
+    sdk.logger.info(f"消息处理器收到事件: {event.get('alt_message')}")
+
+@message.on_private_message()
+async def private_message_handler(event):
+    sdk.logger.info(f"收到私聊消息，来自用户: {event.get('user_id')}")
+
+@message.on_group_message()
+async def group_message_handler(event):
+    sdk.logger.info(f"收到群消息，群: {event.get('group_id')}，用户: {event.get('user_id')}")
+
+# 通知事件处理测试
+@notice.on_friend_add()
+async def friend_add_handler(event):
+    sdk.logger.info(f"新好友添加: {event.get('user_id')}")
+
+@notice.on_group_increase()
+async def group_increase_handler(event):
+    sdk.logger.info(f"新成员加入群: {event.get('group_id')}，用户: {event.get('user_id')}")
+
+# 请求事件处理测试
+@request.on_friend_request()
+async def friend_request_handler(event):
+    sdk.logger.info(f"收到好友请求，来自用户: {event.get('user_id')}")
+
+# 元事件处理测试
+@meta.on_connect()
+async def connect_handler(event):
+    sdk.logger.info(f"平台 {event.get('platform')} 连接成功")
+
+@meta.on_disconnect()
+async def disconnect_handler(event):
+    sdk.logger.info(f"平台 {event.get('platform')} 断开连接")
+
+async def main():
+    try:
+        isInit = await sdk.init_task()
+        
+        if not isInit:
+            sdk.logger.error("ErisPulse 初始化失败，请检查日志")
+            return
+        
+        await sdk.adapter.startup()
+        
+        # 保持程序运行(不建议修改)
+        await asyncio.Event().wait()
+    except Exception as e:
+        sdk.logger.error(e)
+    except KeyboardInterrupt:
+        sdk.logger.info("正在停止程序")
+    finally:
+        await sdk.adapter.shutdown()
+
+if __name__ == "__main__":
+    asyncio.run(main())

erispulse-2.2.0/devs/test_event.py

@@ -0,0 +1,100 @@
+import asyncio
+import time
+from ErisPulse import sdk
+from ErisPulse.Core.Event import command, message, notice, request, meta
+
+# 测试命令处理
+@command("test", help="测试命令", usage="/test [参数]")
+async def test_command(event):
+    platform = event["platform"]
+    user_id = event["user_id"]
+    
+    reply = "收到测试命令，无参数"
+    
+    adapter = getattr(sdk.adapter, platform)
+    await adapter.Send.To("user", user_id).Text(reply)
+    sdk.logger.info(f"处理测试命令: {event}")
+
+# 测试消息事件处理
+@message.on_message()
+async def handle_all_messages(event):
+    sdk.logger.info(f"收到消息事件: {event['alt_message']}")
+
+@message.on_private_message()
+async def handle_private_messages(event):
+    sdk.logger.info(f"收到私聊消息，来自用户: {event['user_id']}")
+
+@message.on_group_message()
+async def handle_group_messages(event):
+    sdk.logger.info(f"收到群消息，群: {event['group_id']}，用户: {event['user_id']}")
+
+# 测试通知事件处理
+@notice.on_friend_add()
+async def handle_friend_add(event):
+    sdk.logger.info(f"新好友添加: {event['user_id']}")
+    
+    platform = event["platform"]
+    user_id = event["user_id"]
+    adapter = getattr(sdk.adapter, platform)
+    await adapter.Send.To("user", user_id).Text("感谢添加我为好友！")
+
+@notice.on_group_increase()
+async def handle_group_increase(event):
+    sdk.logger.info(f"新成员加入群: {event['group_id']}，用户: {event['user_id']}")
+
+# 测试元事件处理
+@meta.on_connect()
+async def handle_connect(event):
+    sdk.logger.info(f"平台 {event['platform']} 连接成功")
+
+@meta.on_disconnect()
+async def handle_disconnect(event):
+    sdk.logger.info(f"平台 {event['platform']} 断开连接")
+
+# 测试中间件
+@message.handler.middleware
+async def message_middleware(event):
+    sdk.logger.info(f"消息中间件处理: {event['message_id']}")
+    return event
+
+@command.handler.middleware
+async def command_middleware(event):
+    sdk.logger.info(f"命令中间件处理: {event}")
+    return event
+
+async def main():
+    try:
+        isInit = await sdk.init_task()
+        
+        if not isInit:
+            sdk.logger.error("ErisPulse 初始化失败，请检查日志")
+            return
+        
+        await sdk.adapter.startup()
+        
+        # 模拟发送测试事件
+        test_event = {
+            "id": "test_event_123",
+            "time": int(time.time()),
+            "type": "message",
+            "detail_type": "private",
+            "platform": "yunhu",
+            "self": {"platform": "yunhu", "user_id": "bot_123"},
+            "message_id": "test_msg_456",
+            "message": [{"type": "text", "data": {"text": "/test 测试参数"}}],
+            "alt_message": "/test 测试参数",
+            "user_id": "user_789"
+        }
+        await sdk.adapter.emit(test_event)
+        
+        # 保持程序运行
+        await asyncio.Event().wait()
+    except Exception as e:
+        sdk.logger.error(f"测试程序出错: {e}")
+    except KeyboardInterrupt:
+        sdk.logger.info("正在停止测试程序")
+    finally:
+        await sdk.adapter.shutdown()
+
+if __name__ == "__main__":
+    asyncio.run(main())