ErisPulse-EmailAdapter 4.0.0__tar.gz → 4.0.2__tar.gz

{erispulse_emailadapter-4.0.0 → erispulse_emailadapter-4.0.2}/EmailAdapter/Core.py

@@ -30,56 +30,56 @@ class EmailGlobalConfig(AdapterConfig):
     imap_server: str = field(
         default="imap.example.com",
         metadata={
-            "description": "默认 IMAP 服务器地址",
+            "description": "Default IMAP server address",
             "webui": {"widget": "text", "group": "imap", "order": 1},
         },
     )
     imap_port: int = field(
         default=993,
         metadata={
-            "description": "默认 IMAP 端口",
+            "description": "Default IMAP port",
             "webui": {"widget": "number", "group": "imap", "order": 2},
         },
     )
     smtp_server: str = field(
         default="smtp.example.com",
         metadata={
-            "description": "默认 SMTP 服务器地址",
+            "description": "Default SMTP server address",
             "webui": {"widget": "text", "group": "smtp", "order": 3},
         },
     )
     smtp_port: int = field(
         default=465,
         metadata={
-            "description": "默认 SMTP 端口",
+            "description": "Default SMTP port",
             "webui": {"widget": "number", "group": "smtp", "order": 4},
         },
     )
     ssl: bool = field(
         default=True,
         metadata={
-            "description": "默认是否启用 SSL",
+            "description": "Whether to enable SSL by default",
             "webui": {"widget": "switch", "group": "basic", "order": 5},
         },
     )
     timeout: int = field(
         default=30,
         metadata={
-            "description": "默认连接超时时间（秒）",
+            "description": "Default connection timeout (seconds)",
             "webui": {"widget": "number", "group": "basic", "order": 6},
         },
     )
     poll_interval: int = field(
         default=60,
         metadata={
-            "description": "IMAP 轮询间隔（秒）",
+            "description": "IMAP polling interval (seconds)",
             "webui": {"widget": "number", "group": "polling", "order": 7},
         },
     )
     max_retries: int = field(
         default=3,
         metadata={
-            "description": "连接失败最大重试次数",
+            "description": "Max retries for failed connections",
             "webui": {"widget": "number", "group": "polling", "order": 8},
         },
     )
@@ -92,7 +92,7 @@ class EmailAccountConfig(BotAccountConfig):
     email: str = field(
         default="",
         metadata={
-            "description": "邮箱地址",
+            "description": "Email address",
             "required": True,
             "secret": True,
             "webui": {"widget": "text", "group": "basic", "order": 1},
@@ -101,7 +101,7 @@ class EmailAccountConfig(BotAccountConfig):
     password: str = field(
         default="",
         metadata={
-            "description": "邮箱密码/授权码",
+            "description": "Email password / authorization code",
             "required": True,
             "secret": True,
             "webui": {"widget": "password", "group": "basic", "order": 2},
@@ -110,42 +110,42 @@ class EmailAccountConfig(BotAccountConfig):
     imap_server: Optional[str] = field(
         default=None,
         metadata={
-            "description": "IMAP 服务器地址（留空则使用全局默认）",
+            "description": "IMAP server address (leave empty to use global default)",
             "webui": {"widget": "text", "group": "imap", "order": 3},
         },
     )
     imap_port: Optional[int] = field(
         default=None,
         metadata={
-            "description": "IMAP 端口（留空则使用全局默认）",
+            "description": "IMAP port (leave empty to use global default)",
             "webui": {"widget": "number", "group": "imap", "order": 4},
         },
     )
     smtp_server: Optional[str] = field(
         default=None,
         metadata={
-            "description": "SMTP 服务器地址（留空则使用全局默认）",
+            "description": "SMTP server address (leave empty to use global default)",
             "webui": {"widget": "text", "group": "smtp", "order": 5},
         },
     )
     smtp_port: Optional[int] = field(
         default=None,
         metadata={
-            "description": "SMTP 端口（留空则使用全局默认）",
+            "description": "SMTP port (leave empty to use global default)",
             "webui": {"widget": "number", "group": "smtp", "order": 6},
         },
     )
     ssl: bool = field(
         default=True,
         metadata={
-            "description": "是否启用 SSL",
+            "description": "Enable SSL",
             "webui": {"widget": "switch", "group": "basic", "order": 7},
         },
     )
     timeout: int = field(
         default=30,
         metadata={
-            "description": "连接超时时间（秒）",
+            "description": "Connection timeout (seconds)",
             "webui": {"widget": "number", "group": "basic", "order": 8},
         },
     )

{erispulse_emailadapter-4.0.0 → erispulse_emailadapter-4.0.2/ErisPulse_EmailAdapter.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse-EmailAdapter
-Version: 4.0.0
+Version: 4.0.2
 Summary: ErisPulse邮箱适配器，支持多账号管理、HTML内容和附件发送
 Author-email: wsu2059q <wsu2059@qq.com>
 License: MIT
@@ -22,7 +22,124 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-# ErisPulse 邮箱适配器
+# ErisPulse Email Adapter
+
+[English](#english) | [中文](#中文)
+
+---
+
+<a id="english"></a>
+
+## English
+
+A powerful email adapter for the ErisPulse framework, enabling you to send and receive email messages as events within the ErisPulse ecosystem.
+
+### Features
+
+- **Multi-Account Support**: Configure multiple mailbox accounts, each with independent SMTP/IMAP settings
+- **Global Configuration**: Define global SMTP and IMAP settings that all accounts can inherit
+- **Email Polling**: Automatically checks mailbox accounts for new messages (unread emails) and converts them into standard ErisPulse events
+- **DSL Sending**: Send emails easily using the standard ErisPulse `Send` DSL
+- **Attachment Support**: Supports both sending and receiving email attachments
+- **HTML and Plain Text**: Supports both HTML and plain text email content
+
+### Installation
+
+Install this adapter like any other ErisPulse module or adapter:
+
+```bash
+epsdk install Email
+```
+
+If it is installed in the same Python environment as ErisPulse, it will be discovered automatically.
+
+### Configuration
+
+After the first run, the adapter generates a default configuration block in your `config.toml` file. You need to update it with your real mailbox account credentials.
+
+#### Configuration Example
+
+```toml
+[EmailAdapter.global]
+imap_server = "imap.example.com"  # Global IMAP server
+imap_port = 993                   # IMAP port
+smtp_server = "smtp.example.com"  # Global SMTP server
+smtp_port = 465                   # SMTP port
+ssl = true                        # Use SSL/TLS encryption
+timeout = 30                      # Connection timeout (seconds)
+poll_interval = 10                # Email polling interval (seconds)
+max_retries = 3                   # Maximum retries for failed connections
+
+[EmailAdapter.accounts."support@example.com"]
+email = "support@example.com"     # Account email address
+password = "yourpassword"         # Account password
+
+[EmailAdapter.accounts."user@example.com"]
+email = "user@example.com"
+password = "anotherpassword"
+```
+
+### Usage
+
+#### Sending Email
+
+Send emails using the standard ErisPulse `Send` DSL. The recipient should be the target email address.
+
+```python
+from ErisPulse import sdk
+
+# Send from the default account
+await sdk.adapter.mail.Send.To("recipient@example.com").Text("Greetings from ErisPulse!")
+
+# Send an email with a subject from a specific account
+await sdk.adapter.mail.Send.Using("support@example.com").To("client@company.com") \
+    .Subject("Important Update") \
+    .Attachment("document.pdf") \
+    .Text("Please review the document in the attachment.")
+
+# Send an HTML email
+html_content = """
+<h1>Welcome!</h1>
+<p>Thank you for using our service.</p>
+"""
+await sdk.adapter.mail.Send.To("user@example.com") \
+    .Subject("HTML Email").Html(html_content)
+```
+
+#### Receiving Email
+
+Received emails are automatically converted into standard `message` events. You can listen for them just like any other message.
+
+```python
+from ErisPulse import sdk, adapter
+
+@adapter.on("message")
+async def handle_email_messages(data: dict):
+    # Check whether the message comes from the email adapter
+    if data.get("platform") == "mail":
+        sender = data.get("user_id")
+        subject = data["email_raw"]["subject"]
+        content = data["email_raw"]["text_content"]
+
+        print(f"New email from: {sender}")
+        print(f"Subject: {subject}")
+        print(f"Content:\n{content}")
+
+        # Check attachments
+        if data.get("attachments"):
+            print(f"Attachments: {[a['filename'] for a in data['attachments']]}")
+
+        # Auto-reply example
+        await sdk.adapter.mail.Send.To(sender) \
+            .Subject(f"Re: {subject}") \
+            .Text("Your email has been received. We will reply as soon as possible.")
+```
+
+---
+
+<a id="中文"></a>
+
+## 中文
 
 一个为 ErisPulse 框架设计的强大邮箱适配器，支持在 ErisPulse 生态系统中以事件形式收发电子邮件。
 

{erispulse_emailadapter-4.0.0 → erispulse_emailadapter-4.0.2}/ErisPulse_EmailAdapter.egg-info/entry_points.txt

@@ -1,3 +1,2 @@
 [erispulse.adapter]
 email = EmailAdapter:EmailAdapter
-mail = EmailAdapter:EmailAdapter

{erispulse_emailadapter-4.0.0/ErisPulse_EmailAdapter.egg-info → erispulse_emailadapter-4.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse-EmailAdapter
-Version: 4.0.0
+Version: 4.0.2
 Summary: ErisPulse邮箱适配器，支持多账号管理、HTML内容和附件发送
 Author-email: wsu2059q <wsu2059@qq.com>
 License: MIT
@@ -22,7 +22,124 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-# ErisPulse 邮箱适配器
+# ErisPulse Email Adapter
+
+[English](#english) | [中文](#中文)
+
+---
+
+<a id="english"></a>
+
+## English
+
+A powerful email adapter for the ErisPulse framework, enabling you to send and receive email messages as events within the ErisPulse ecosystem.
+
+### Features
+
+- **Multi-Account Support**: Configure multiple mailbox accounts, each with independent SMTP/IMAP settings
+- **Global Configuration**: Define global SMTP and IMAP settings that all accounts can inherit
+- **Email Polling**: Automatically checks mailbox accounts for new messages (unread emails) and converts them into standard ErisPulse events
+- **DSL Sending**: Send emails easily using the standard ErisPulse `Send` DSL
+- **Attachment Support**: Supports both sending and receiving email attachments
+- **HTML and Plain Text**: Supports both HTML and plain text email content
+
+### Installation
+
+Install this adapter like any other ErisPulse module or adapter:
+
+```bash
+epsdk install Email
+```
+
+If it is installed in the same Python environment as ErisPulse, it will be discovered automatically.
+
+### Configuration
+
+After the first run, the adapter generates a default configuration block in your `config.toml` file. You need to update it with your real mailbox account credentials.
+
+#### Configuration Example
+
+```toml
+[EmailAdapter.global]
+imap_server = "imap.example.com"  # Global IMAP server
+imap_port = 993                   # IMAP port
+smtp_server = "smtp.example.com"  # Global SMTP server
+smtp_port = 465                   # SMTP port
+ssl = true                        # Use SSL/TLS encryption
+timeout = 30                      # Connection timeout (seconds)
+poll_interval = 10                # Email polling interval (seconds)
+max_retries = 3                   # Maximum retries for failed connections
+
+[EmailAdapter.accounts."support@example.com"]
+email = "support@example.com"     # Account email address
+password = "yourpassword"         # Account password
+
+[EmailAdapter.accounts."user@example.com"]
+email = "user@example.com"
+password = "anotherpassword"
+```
+
+### Usage
+
+#### Sending Email
+
+Send emails using the standard ErisPulse `Send` DSL. The recipient should be the target email address.
+
+```python
+from ErisPulse import sdk
+
+# Send from the default account
+await sdk.adapter.mail.Send.To("recipient@example.com").Text("Greetings from ErisPulse!")
+
+# Send an email with a subject from a specific account
+await sdk.adapter.mail.Send.Using("support@example.com").To("client@company.com") \
+    .Subject("Important Update") \
+    .Attachment("document.pdf") \
+    .Text("Please review the document in the attachment.")
+
+# Send an HTML email
+html_content = """
+<h1>Welcome!</h1>
+<p>Thank you for using our service.</p>
+"""
+await sdk.adapter.mail.Send.To("user@example.com") \
+    .Subject("HTML Email").Html(html_content)
+```
+
+#### Receiving Email
+
+Received emails are automatically converted into standard `message` events. You can listen for them just like any other message.
+
+```python
+from ErisPulse import sdk, adapter
+
+@adapter.on("message")
+async def handle_email_messages(data: dict):
+    # Check whether the message comes from the email adapter
+    if data.get("platform") == "mail":
+        sender = data.get("user_id")
+        subject = data["email_raw"]["subject"]
+        content = data["email_raw"]["text_content"]
+
+        print(f"New email from: {sender}")
+        print(f"Subject: {subject}")
+        print(f"Content:\n{content}")
+
+        # Check attachments
+        if data.get("attachments"):
+            print(f"Attachments: {[a['filename'] for a in data['attachments']]}")
+
+        # Auto-reply example
+        await sdk.adapter.mail.Send.To(sender) \
+            .Subject(f"Re: {subject}") \
+            .Text("Your email has been received. We will reply as soon as possible.")
+```
+
+---
+
+<a id="中文"></a>
+
+## 中文
 
 一个为 ErisPulse 框架设计的强大邮箱适配器，支持在 ErisPulse 生态系统中以事件形式收发电子邮件。
 

erispulse_emailadapter-4.0.2/README.md

@@ -0,0 +1,222 @@
+# ErisPulse Email Adapter
+
+[English](#english) | [中文](#中文)
+
+---
+
+<a id="english"></a>
+
+## English
+
+A powerful email adapter for the ErisPulse framework, enabling you to send and receive email messages as events within the ErisPulse ecosystem.
+
+### Features
+
+- **Multi-Account Support**: Configure multiple mailbox accounts, each with independent SMTP/IMAP settings
+- **Global Configuration**: Define global SMTP and IMAP settings that all accounts can inherit
+- **Email Polling**: Automatically checks mailbox accounts for new messages (unread emails) and converts them into standard ErisPulse events
+- **DSL Sending**: Send emails easily using the standard ErisPulse `Send` DSL
+- **Attachment Support**: Supports both sending and receiving email attachments
+- **HTML and Plain Text**: Supports both HTML and plain text email content
+
+### Installation
+
+Install this adapter like any other ErisPulse module or adapter:
+
+```bash
+epsdk install Email
+```
+
+If it is installed in the same Python environment as ErisPulse, it will be discovered automatically.
+
+### Configuration
+
+After the first run, the adapter generates a default configuration block in your `config.toml` file. You need to update it with your real mailbox account credentials.
+
+#### Configuration Example
+
+```toml
+[EmailAdapter.global]
+imap_server = "imap.example.com"  # Global IMAP server
+imap_port = 993                   # IMAP port
+smtp_server = "smtp.example.com"  # Global SMTP server
+smtp_port = 465                   # SMTP port
+ssl = true                        # Use SSL/TLS encryption
+timeout = 30                      # Connection timeout (seconds)
+poll_interval = 10                # Email polling interval (seconds)
+max_retries = 3                   # Maximum retries for failed connections
+
+[EmailAdapter.accounts."support@example.com"]
+email = "support@example.com"     # Account email address
+password = "yourpassword"         # Account password
+
+[EmailAdapter.accounts."user@example.com"]
+email = "user@example.com"
+password = "anotherpassword"
+```
+
+### Usage
+
+#### Sending Email
+
+Send emails using the standard ErisPulse `Send` DSL. The recipient should be the target email address.
+
+```python
+from ErisPulse import sdk
+
+# Send from the default account
+await sdk.adapter.mail.Send.To("recipient@example.com").Text("Greetings from ErisPulse!")
+
+# Send an email with a subject from a specific account
+await sdk.adapter.mail.Send.Using("support@example.com").To("client@company.com") \
+    .Subject("Important Update") \
+    .Attachment("document.pdf") \
+    .Text("Please review the document in the attachment.")
+
+# Send an HTML email
+html_content = """
+<h1>Welcome!</h1>
+<p>Thank you for using our service.</p>
+"""
+await sdk.adapter.mail.Send.To("user@example.com") \
+    .Subject("HTML Email").Html(html_content)
+```
+
+#### Receiving Email
+
+Received emails are automatically converted into standard `message` events. You can listen for them just like any other message.
+
+```python
+from ErisPulse import sdk, adapter
+
+@adapter.on("message")
+async def handle_email_messages(data: dict):
+    # Check whether the message comes from the email adapter
+    if data.get("platform") == "mail":
+        sender = data.get("user_id")
+        subject = data["email_raw"]["subject"]
+        content = data["email_raw"]["text_content"]
+
+        print(f"New email from: {sender}")
+        print(f"Subject: {subject}")
+        print(f"Content:\n{content}")
+
+        # Check attachments
+        if data.get("attachments"):
+            print(f"Attachments: {[a['filename'] for a in data['attachments']]}")
+
+        # Auto-reply example
+        await sdk.adapter.mail.Send.To(sender) \
+            .Subject(f"Re: {subject}") \
+            .Text("Your email has been received. We will reply as soon as possible.")
+```
+
+---
+
+<a id="中文"></a>
+
+## 中文
+
+一个为 ErisPulse 框架设计的强大邮箱适配器，支持在 ErisPulse 生态系统中以事件形式收发电子邮件。
+
+## 功能特性
+
+- **多账户支持**：可配置多个邮箱账户，每个账户可设置独立的SMTP/IMAP参数
+- **全局配置**：可定义全局SMTP和IMAP设置，所有账户均可继承
+- **邮件轮询**：自动检查邮箱账户中的新邮件(未读邮件)，并将其转换为标准ErisPulse事件
+- **DSL发送**：使用标准ErisPulse `Send` DSL轻松发送邮件
+- **附件支持**：支持发送和接收邮件附件
+- **HTML与纯文本**：同时支持HTML和纯文本邮件内容
+
+## 安装
+
+像安装其他ErisPulse模块或适配器一样安装本适配器：
+
+```bash
+epsdk install Email
+```
+
+如果与ErisPulse安装在同一个Python环境中，它将被自动发现。
+
+## 配置
+
+首次运行后，适配器会在您的`config.toml`文件中生成默认配置块。您需要用真实的邮箱账户信息更新它。
+
+### 配置示例
+
+```toml
+[EmailAdapter.global]
+imap_server = "imap.example.com"  # 全局IMAP服务器
+imap_port = 993                   # IMAP端口
+smtp_server = "smtp.example.com"  # 全局SMTP服务器
+smtp_port = 465                   # SMTP端口
+ssl = true                        # 使用SSL/TLS加密
+timeout = 30                      # 连接超时时间(秒)
+poll_interval = 10                # 邮件轮询间隔(秒)
+max_retries = 3                   # 失败连接的最大重试次数
+
+[EmailAdapter.accounts."support@example.com"]
+email = "support@example.com"     # 账户邮箱地址
+password = "yourpassword"         # 账户密码
+
+[EmailAdapter.accounts."user@example.com"]
+email = "user@example.com"
+password = "anotherpassword"
+```
+
+## 使用方法
+
+### 发送邮件
+
+使用标准ErisPulse `Send` DSL发送邮件。接收者应为目标邮箱地址。
+
+```python
+from ErisPulse import sdk
+
+# 从默认账户发送
+await sdk.adapter.mail.Send.To("recipient@example.com").Text("来自ErisPulse的问候！")
+
+# 从特定账户发送带主题的邮件
+await sdk.adapter.mail.Send.Using("support@example.com").To("client@company.com") \
+    .Subject("重要更新"). \
+    .Attachment("document.pdf").
+    Text("请查看附件中的文档。") \
+
+
+# 发送HTML邮件
+html_content = """
+<h1>欢迎！</h1>
+<p>感谢使用我们的服务。</p>
+"""
+await sdk.adapter.mail.Send.To("user@example.com") \
+    .Subject("HTML邮件").Html(html_content)
+```
+
+### 接收邮件
+
+收到的邮件会自动转换为标准`message`事件。您可以像监听其他消息一样监听它们。
+
+```python
+from ErisPulse import sdk, adapter
+
+@adapter.on("message")
+async def handle_email_messages(data: dict):
+    # 检查消息是否来自邮箱适配器
+    if data.get("platform") == "mail":
+        sender = data.get("user_id")
+        subject = data["email_raw"]["subject"]
+        content = data["email_raw"]["text_content"]
+        
+        print(f"新邮件来自: {sender}")
+        print(f"主题: {subject}")
+        print(f"内容:\n{content}")
+        
+        # 检查附件
+        if data.get("attachments"):
+            print(f"附件: {[a['filename'] for a in data['attachments']]}")
+
+        # 自动回复示例
+        await sdk.adapter.mail.Send.To(sender) \
+            .Subject(f"回复: {subject}") \
+            .Text("已收到您的邮件，我们将尽快回复。")
+```

{erispulse_emailadapter-4.0.0 → erispulse_emailadapter-4.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ErisPulse-EmailAdapter"
-version = "4.0.0"
+version = "4.0.2"
 description = "ErisPulse邮箱适配器，支持多账号管理、HTML内容和附件发送"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -32,4 +32,3 @@ homepage = "https://github.com/ErisPulse/ErisPulse-EmailAdapter"
 
 [project.entry-points."erispulse.adapter"]
 "email" = "EmailAdapter:EmailAdapter"
-"mail" = "EmailAdapter:EmailAdapter"

erispulse_emailadapter-4.0.0/README.md

@@ -1,105 +0,0 @@
-# ErisPulse 邮箱适配器
-
-一个为 ErisPulse 框架设计的强大邮箱适配器，支持在 ErisPulse 生态系统中以事件形式收发电子邮件。
-
-## 功能特性
-
-- **多账户支持**：可配置多个邮箱账户，每个账户可设置独立的SMTP/IMAP参数
-- **全局配置**：可定义全局SMTP和IMAP设置，所有账户均可继承
-- **邮件轮询**：自动检查邮箱账户中的新邮件(未读邮件)，并将其转换为标准ErisPulse事件
-- **DSL发送**：使用标准ErisPulse `Send` DSL轻松发送邮件
-- **附件支持**：支持发送和接收邮件附件
-- **HTML与纯文本**：同时支持HTML和纯文本邮件内容
-
-## 安装
-
-像安装其他ErisPulse模块或适配器一样安装本适配器：
-
-```bash
-epsdk install Email
-```
-
-如果与ErisPulse安装在同一个Python环境中，它将被自动发现。
-
-## 配置
-
-首次运行后，适配器会在您的`config.toml`文件中生成默认配置块。您需要用真实的邮箱账户信息更新它。
-
-### 配置示例
-
-```toml
-[EmailAdapter.global]
-imap_server = "imap.example.com"  # 全局IMAP服务器
-imap_port = 993                   # IMAP端口
-smtp_server = "smtp.example.com"  # 全局SMTP服务器
-smtp_port = 465                   # SMTP端口
-ssl = true                        # 使用SSL/TLS加密
-timeout = 30                      # 连接超时时间(秒)
-poll_interval = 10                # 邮件轮询间隔(秒)
-max_retries = 3                   # 失败连接的最大重试次数
-
-[EmailAdapter.accounts."support@example.com"]
-email = "support@example.com"     # 账户邮箱地址
-password = "yourpassword"         # 账户密码
-
-[EmailAdapter.accounts."user@example.com"]
-email = "user@example.com"
-password = "anotherpassword"
-```
-
-## 使用方法
-
-### 发送邮件
-
-使用标准ErisPulse `Send` DSL发送邮件。接收者应为目标邮箱地址。
-
-```python
-from ErisPulse import sdk
-
-# 从默认账户发送
-await sdk.adapter.mail.Send.To("recipient@example.com").Text("来自ErisPulse的问候！")
-
-# 从特定账户发送带主题的邮件
-await sdk.adapter.mail.Send.Using("support@example.com").To("client@company.com") \
-    .Subject("重要更新"). \
-    .Attachment("document.pdf").
-    Text("请查看附件中的文档。") \
-
-
-# 发送HTML邮件
-html_content = """
-<h1>欢迎！</h1>
-<p>感谢使用我们的服务。</p>
-"""
-await sdk.adapter.mail.Send.To("user@example.com") \
-    .Subject("HTML邮件").Html(html_content)
-```
-
-### 接收邮件
-
-收到的邮件会自动转换为标准`message`事件。您可以像监听其他消息一样监听它们。
-
-```python
-from ErisPulse import sdk, adapter
-
-@adapter.on("message")
-async def handle_email_messages(data: dict):
-    # 检查消息是否来自邮箱适配器
-    if data.get("platform") == "mail":
-        sender = data.get("user_id")
-        subject = data["email_raw"]["subject"]
-        content = data["email_raw"]["text_content"]
-        
-        print(f"新邮件来自: {sender}")
-        print(f"主题: {subject}")
-        print(f"内容:\n{content}")
-        
-        # 检查附件
-        if data.get("attachments"):
-            print(f"附件: {[a['filename'] for a in data['attachments']]}")
-
-        # 自动回复示例
-        await sdk.adapter.mail.Send.To(sender) \
-            .Subject(f"回复: {subject}") \
-            .Text("已收到您的邮件，我们将尽快回复。")
-```