ErisPulse 2.4.6.dev5__tar.gz → 2.4.7__tar.gz

{erispulse-2.4.6.dev5 → erispulse-2.4.7}/.gitignore

@@ -9,6 +9,13 @@ logs/
 config.db*
 .website
 
+# 敏感配置和数据文件
+config/config.toml
+config/config.db
+config/config.db-journal
+config/config.db-wal
+config/config.db-shm
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]

{erispulse-2.4.6.dev5 → erispulse-2.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.4.6.dev5
+Version: 2.4.7
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: ErisDev <erisdev@88.com>
 Maintainer-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
@@ -26,7 +26,7 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
 License-File: LICENSE
-Keywords: async,asyncio,bot,extensible,framework,modular,onebot,robot,sdk,telegram
+Keywords: async,asyncio,bot,bot-framework,chatbot,email,extensible,framework,instant-messaging,kook,matrix,modular,multi-platform,onebot,onebot12,qq,robot,sdk,telegram,yunhu
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: AsyncIO
 Classifier: Intended Audience :: Developers
@@ -79,7 +79,7 @@ Description-Content-Type: text/markdown
 </td>
 <td valign="middle">
 
-[English](README.en.md) | **简体中文** | [繁體中文](README.zh-TW.md)
+[English](README.en.md) | **简体中文** | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [Русский](README.ru.md)
 
 # ErisPulse
 
@@ -292,6 +292,10 @@ pip install ErisPulse
 
 ##### 仪表盘：
 
+[![在线演示](https://img.shields.io/badge/在线演示-Dashboard-FF6B9D?style=for-the-badge&logo=github&logoColor=white)](https://dashdemo.erisdev.com/)
+
+> 💡 在线体验演示仪表盘：[DashDemo](https://dashdemo.erisdev.com/)
+
 <table>
 <tr>
 <td width="50%">
@@ -407,6 +411,93 @@ epsdk run main.py --reload
 - [快速开始指南](docs/zh-CN/quick-start.md)
 - [入门指南](docs/zh-CN/getting-started/)
 
+#### 多轮对话示例
+
+ErisPulse 内置了强大的多轮对话引擎，轻松实现引导式操作、信息收集等交互场景：
+
+```python
+from ErisPulse.Core.Event import command, request
+
+@command("register")
+async def register_handler(event):
+    conv = event.conversation(timeout=60)
+    
+    await conv.say("欢迎注册！")
+    
+    # 多步骤收集用户信息，自动验证
+    data = await conv.collect([
+        {"key": "name", "prompt": "请输入姓名"},
+        {"key": "age", "prompt": "请输入年龄",
+         "validator": lambda e: e.get_text().strip().isdigit(),
+         "retry_prompt": "年龄必须是数字，请重新输入"},
+    ])
+    
+    if data and await conv.confirm(f"确认注册？姓名: {data['name']}, 年龄: {data['age']}"):
+        # 通过 SendDSL 主动推送通知
+        await sdk.adapter.get(event.get_platform()).Send.To(
+            "user", event.get_user_id()
+        ).Text(f"注册成功！欢迎 {data['name']}")
+        # 或 await event.reply("注册成功！")
+
+# 自动处理好友请求
+@request.on_friend_request()
+async def handle_friend_request(event):
+    user_name = event.get_user_nickname() or event.get_user_id()
+    
+    # 同意请求
+    result = await event.approve()
+    if result.get("status") == "ok":
+        await event.reply(f"已自动通过好友请求，欢迎 {user_name}")
+```
+
+<details>
+<summary>查看更多 Conversation API（分支跳转 / 选择 / 持久化）</summary>
+
+```python
+@command("quiz")
+async def quiz_handler(event):
+    conv = event.conversation(timeout=30)
+    
+    # 选项式问答
+    answer = await conv.choose("Python 的创造者是谁？", [
+        "Guido van Rossum",
+        "James Gosling", 
+        "Dennis Ritchie",
+    ])
+    
+    if answer == 0:
+        await conv.say("正确！")
+    elif answer is None:
+        await conv.say("超时了，下次再来吧！")
+    else:
+        await conv.say("错误了，正确答案是 Guido van Rossum")
+
+@command("menu")
+async def menu_handler(event):
+    conv = event.conversation(timeout=60)
+    
+    # 分支跳转，构建复杂交互流程
+    @conv.branch("main")
+    async def main_menu():
+        await conv.say("=== 主菜单 ===\n1. 个人信息\n2. 设置\n3. 退出")
+        resp = await conv.wait()
+        if resp and resp.get_text().strip() == "1":
+            await conv.goto("profile")
+    
+    @conv.branch("profile")
+    async def profile():
+        await conv.say("姓名: Alice\n0. 返回")
+        resp = await conv.wait()
+        if resp and resp.get_text().strip() == "0":
+            await conv.goto("main")
+    
+    await conv.start()
+```
+
+详见 [Conversation 多轮对话](docs/zh-CN/advanced/conversation.md)
+
+</details>
+
 ---
 
 ### 支持的适配器

{erispulse-2.4.6.dev5 → erispulse-2.4.7}/README.md

@@ -7,7 +7,7 @@
 </td>
 <td valign="middle">
 
-[English](README.en.md) | **简体中文** | [繁體中文](README.zh-TW.md)
+[English](README.en.md) | **简体中文** | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [Русский](README.ru.md)
 
 # ErisPulse
 
@@ -220,6 +220,10 @@ pip install ErisPulse
 
 ##### 仪表盘：
 
+[![在线演示](https://img.shields.io/badge/在线演示-Dashboard-FF6B9D?style=for-the-badge&logo=github&logoColor=white)](https://dashdemo.erisdev.com/)
+
+> 💡 在线体验演示仪表盘：[DashDemo](https://dashdemo.erisdev.com/)
+
 <table>
 <tr>
 <td width="50%">
@@ -335,6 +339,93 @@ epsdk run main.py --reload
 - [快速开始指南](docs/zh-CN/quick-start.md)
 - [入门指南](docs/zh-CN/getting-started/)
 
+#### 多轮对话示例
+
+ErisPulse 内置了强大的多轮对话引擎，轻松实现引导式操作、信息收集等交互场景：
+
+```python
+from ErisPulse.Core.Event import command, request
+
+@command("register")
+async def register_handler(event):
+    conv = event.conversation(timeout=60)
+    
+    await conv.say("欢迎注册！")
+    
+    # 多步骤收集用户信息，自动验证
+    data = await conv.collect([
+        {"key": "name", "prompt": "请输入姓名"},
+        {"key": "age", "prompt": "请输入年龄",
+         "validator": lambda e: e.get_text().strip().isdigit(),
+         "retry_prompt": "年龄必须是数字，请重新输入"},
+    ])
+    
+    if data and await conv.confirm(f"确认注册？姓名: {data['name']}, 年龄: {data['age']}"):
+        # 通过 SendDSL 主动推送通知
+        await sdk.adapter.get(event.get_platform()).Send.To(
+            "user", event.get_user_id()
+        ).Text(f"注册成功！欢迎 {data['name']}")
+        # 或 await event.reply("注册成功！")
+
+# 自动处理好友请求
+@request.on_friend_request()
+async def handle_friend_request(event):
+    user_name = event.get_user_nickname() or event.get_user_id()
+    
+    # 同意请求
+    result = await event.approve()
+    if result.get("status") == "ok":
+        await event.reply(f"已自动通过好友请求，欢迎 {user_name}")
+```
+
+<details>
+<summary>查看更多 Conversation API（分支跳转 / 选择 / 持久化）</summary>
+
+```python
+@command("quiz")
+async def quiz_handler(event):
+    conv = event.conversation(timeout=30)
+    
+    # 选项式问答
+    answer = await conv.choose("Python 的创造者是谁？", [
+        "Guido van Rossum",
+        "James Gosling", 
+        "Dennis Ritchie",
+    ])
+    
+    if answer == 0:
+        await conv.say("正确！")
+    elif answer is None:
+        await conv.say("超时了，下次再来吧！")
+    else:
+        await conv.say("错误了，正确答案是 Guido van Rossum")
+
+@command("menu")
+async def menu_handler(event):
+    conv = event.conversation(timeout=60)
+    
+    # 分支跳转，构建复杂交互流程
+    @conv.branch("main")
+    async def main_menu():
+        await conv.say("=== 主菜单 ===\n1. 个人信息\n2. 设置\n3. 退出")
+        resp = await conv.wait()
+        if resp and resp.get_text().strip() == "1":
+            await conv.goto("profile")
+    
+    @conv.branch("profile")
+    async def profile():
+        await conv.say("姓名: Alice\n0. 返回")
+        resp = await conv.wait()
+        if resp and resp.get_text().strip() == "0":
+            await conv.goto("main")
+    
+    await conv.start()
+```
+
+详见 [Conversation 多轮对话](docs/zh-CN/advanced/conversation.md)
+
+</details>
+
 ---
 
 ### 支持的适配器

{erispulse-2.4.6.dev5 → erispulse-2.4.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.4.6-dev.5"
+version = "2.4.7"
 description = "ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -24,11 +24,21 @@ keywords = [
     "sdk",
     "framework",
     "robot",
+    "chatbot",
+    "bot-framework",
     "onebot",
+    "onebot12",
     "telegram",
+    "qq",
+    "multi-platform",
     "extensible",
     "modular",
-    "asyncio"
+    "asyncio",
+    "instant-messaging",
+    "kook",
+    "yunhu",
+    "matrix",
+    "email",
 ]
 
 classifiers = [