ErisPulse 2.6.1.dev0__tar.gz → 2.6.2.dev1__tar.gz

{erispulse-2.6.1.dev0 → erispulse-2.6.2.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.6.1.dev0
+Version: 2.6.2.dev1
 Summary: Event-driven modular async bot framework — write once, deploy to any platform | 事件驱动的模块化异步机器人框架，一次编写，多平台部署
 Project-URL: Homepage, https://github.com/ErisPulse/ErisPulse
 Project-URL: Documentation, https://www.erisdev.com#docs
@@ -55,8 +55,10 @@ Requires-Dist: toml>=0.10.2
 Requires-Dist: uvicorn>=0.30.0
 Requires-Dist: websockets>=12.0
 Provides-Extra: dev
+Requires-Dist: basedpyright>=1.20.0; extra == 'dev'
 Requires-Dist: pyclean>=3.6.0; extra == 'dev'
 Requires-Dist: ruff>=0.1.7; extra == 'dev'
+Requires-Dist: typing-extensions>=4.7.0; (python_version < '3.11') and extra == 'dev'
 Provides-Extra: test
 Requires-Dist: httpx>=0.24.0; extra == 'test'
 Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
@@ -73,11 +75,11 @@ Description-Content-Type: text/markdown
 
 # ErisPulse
 
-**Write once, deploy across multiple platforms.**
+**Write once, deploy on multiple platforms.**
 
 An event-driven multi-platform chatbot development framework.
 
-Based on the OneBot12 standard interface, write once and deploy across multiple platforms. Flexible plugin system, hot reload support, and a complete developer toolchain, suitable for various scenarios from simple chatbots to complex automation systems.
+Based on the OneBot12 standard interface, write once and deploy on multiple platforms. With a flexible plugin system, hot reload support, and a complete developer toolchain, it is suitable for various scenarios from simple chatbots to complex automation systems.
 
 <p>
   <a href="https://pypi.org/project/ErisPulse/"><img src="https://img.shields.io/pypi/v/ErisPulse?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"></a>
@@ -113,7 +115,7 @@ Based on the OneBot12 standard interface, write once and deploy across multiple
 
 ### Event-driven Architecture
 
-A clear event model based on the OneBot12 standard, making message handling logic more intuitive and efficient
+A clear event model based on the OneBot12 standard makes message handling logic more intuitive and efficient
 
 </td>
 <td width="33%" align="center" valign="top">
@@ -123,7 +125,7 @@ A clear event model based on the OneBot12 standard, making message handling logi
 
 ### Cross-platform Compatibility
 
-Write a plugin module once and use it across all platforms, without repeating development for different platforms
+Write a plugin module once and use it on all platforms, no need to repeat development for different platforms
 
 </td>
 <td width="33%" align="center" valign="top">
@@ -133,7 +135,7 @@ Write a plugin module once and use it across all platforms, without repeating de
 
 ### Modular Design
 
-A flexible plugin system, easy to extend and integrate, supports hot-swappable module management
+A flexible plugin system, easy to extend and integrate, supports hot-plug module management
 
 </td>
 </tr>
@@ -155,25 +157,25 @@ Reload code without restarting during development
 
 ### AI Assistance
 
-AI-assisted development brings requirements directly to usable modules
+AI-assisted development allows requirements to be directly translated into usable modules
 
 </td>
 <td width="33%" align="center" valign="top">
 <br/>
 
-<img src=".github/assets/icon/icon_lightweight.png" width="50" alt="Lightweight" />
+<img src=".github/assets/icon/icon_lightweight.png" width="50" alt="Simple and Elegant" />
 
-### Lightweight
+### Simple and Elegant
 
-Intuitive API design, making code as light and readable as a feather
+Intuitive API design, making code as light and readable as feathers
 
 </td>
 </tr>
 </table>
 
-### Chained Sending DSL
+### Chainable Send DSL
 
-Complete all sending logic in a single chained call: @user, reply, retry, timeout, callback, etc.:
+A single chain call completes all sending logic such as @, reply, retry, timeout, and callback:
 
 ```python
 yunhu = sdk.adapter.get("yunhu")
@@ -185,7 +187,7 @@ await (yunhu.Send.To("group", "123")
        .Hook(lambda r: print("Send successful!"))
        .Text("Hello"))
 
-# Batch send: send multiple messages in one chain
+# Batch send: send multiple messages in a single chain
 results = await (yunhu.Send.To("user", "123")
                 .Build()
                 .Text("Notification 1")
@@ -194,11 +196,11 @@ results = await (yunhu.Send.To("user", "123")
                 .send_all())
 ```
 
-> Supports Hook (success callback), Retry (failure retry), Timeout (timeout cancellation), OnProgress (progress monitoring), Defer (delayed send), Build (batch construction), and other chained methods. See [SendDSL documentation](docs/en/developer-guide/adapters/send-dsl.md).
+> Supports Hook (success callback), Retry (failure retry), Timeout (timeout cancellation), OnProgress (progress monitoring), Defer (delayed sending), Build (batch construction), and other chainable methods. See [SendDSL documentation](docs/en/developer-guide/adapters/send-dsl.md).
 
 ---
 
-## Same code. Multiple platforms.
+## The Same Code. Multiple Platforms.
 
 *Identical command handlers. Different platforms. No business logic changes required.*
 
@@ -232,7 +234,7 @@ results = await (yunhu.Send.To("user", "123")
 
 ## Ecosystem
 
-ErisPulse is more than just a framework. Install and start immediately, no need to build wheels from scratch.
+ErisPulse is not just a framework. Install and start right away, no need to build from scratch.
 
 <table>
 <tr>
@@ -260,7 +262,7 @@ Plugins · Logs · Configuration
 
 **AI Builder**
 
-Natural language → usable module
+Natural language → usable modules
 
 [Experience now →](https://www.erisdev.com/#builder)
 
@@ -271,7 +273,7 @@ Natural language → usable module
 
 Ready-to-use plugins
 
-[Browse modules →](https://www.erisdev.com/#market)
+[Explore modules →](https://www.erisdev.com/#market)
 
 </td>
 </tr>
@@ -280,7 +282,7 @@ Ready-to-use plugins
 
 **Adapters**
 
-15+ platform integrations
+Support for 15+ platforms
 
 </td>
 <td align="center" width="25%">
@@ -313,17 +315,17 @@ Multi-architecture support
 
 ## Project Origin
 
-ErisPulse was not born to be a framework.
+ErisPulse was not created just to be a framework.
 
-It originated from **Amer** — a project for message interconnection and synchronization across different platforms.
+It originated from **Amer** — a project for message interconnection and synchronization between different platforms.
 
-As the number of integrated platforms increased, we began maintaining the asynchronous version of **ryunhusdk2**, gradually abstracting a unified event model and adapter system.
+As more platforms were integrated, we began maintaining the asynchronous version of **ryunhusdk2**, gradually abstracting a unified event model and adapter system.
 
 These practices eventually evolved into today's ErisPulse.
 
 Its goal has never changed:
 
-**Let developers focus on business, not platform differences.**
+**Let developers focus on business logic, not platform differences.**
 
 ---
 
@@ -377,7 +379,7 @@ If Docker Hub is inaccessible, you can use GitHub Container Registry:
 docker pull ghcr.io/erispulse/erispulse:latest
 ```
 
-When using the ghcr.io image, you need to modify the `docker-compose.yml` file's image:
+When using the ghcr.io image, modify the `docker-compose.yml` file's image:
 ```yaml
 image: ghcr.io/erispulse/erispulse:latest
 ```
@@ -385,7 +387,7 @@ image: ghcr.io/erispulse/erispulse:latest
 </details>
 
 <details>
-<summary>Quick Start</summary>
+<summary>Quick start</summary>
 
 ```bash
 # Download docker-compose.yml
@@ -397,7 +399,7 @@ ERISPULSE_DASHBOARD_TOKEN=your-token docker compose up -d
 
 > The image includes the ErisPulse framework and Dashboard management panel, supporting `linux/amd64` and `linux/arm64` architectures.
 
-After startup, access `http://<host>:<port>/Dashboard` and use the set token as the password to log in to the Dashboard management panel.
+After starting, access `http://<host>:<port>/Dashboard` and use the set token as the password to log in to the Dashboard management panel.
 
 </details>
 
@@ -439,19 +441,19 @@ docker pull erispulse/erispulse:dev
 | `ERISPULSE_PORT` | `8000` | Dashboard port mapping |
 | `TZ` | `Asia/Shanghai` | Container timezone |
 
-> Enabling `ERISPULSE_UPDATE_ON_START=true` ensures that even if the image is outdated, the container will automatically fetch the latest version at startup.
+> Setting `ERISPULSE_UPDATE_ON_START=true` ensures that even if the image is outdated, the container will automatically fetch the latest version at startup.
 
 </details>
 
 #### 1Panel App Store
 
-Install ErisPulse one-click via the [1Panel](https://1panel.cn) app store, see [ErisPulse-1Panel](https://github.com/ErisPulse/ErisPulse-1Panel).
+Install ErisPulse with one click via the [1Panel](https://1panel.cn) app store, see [ErisPulse-1Panel](https://github.com/ErisPulse/ErisPulse-1Panel).
 
 ```bash
 bash <(curl -sL https://get-1panel.erisdev.com/install.sh)
 ```
 
-ErisPulse is available in the 1Panel third-party app store and can be installed using the [okxlin/appstore](https://github.com/okxlin/appstore) third-party repository.
+ErisPulse is available in the 1Panel third-party app store, and can be installed using the [okxlin/appstore](https://github.com/okxlin/appstore) third-party repository.
 
 #### Using pip to install
 
@@ -502,7 +504,7 @@ if __name__ == "__main__":
 </td>
 <td width="50%" valign="top">
 
-**Effect Description**
+**Effect Explanation**
 
 Send `/hello`
 
@@ -534,7 +536,7 @@ For more detailed instructions, see:
 
 #### Multi-turn Conversation Example
 
-ErisPulse includes a powerful multi-turn conversation engine, easily achieving guided operations, information collection, and other interactive scenarios:
+ErisPulse has a powerful built-in multi-turn conversation engine, easily enabling guided operations, information collection, and other interactive scenarios:
 
 ```python
 from ErisPulse.Core.Event import command, request
@@ -565,10 +567,10 @@ async def register_handler(event):
 async def handle_friend_request(event):
     user_name = event.get_user_nickname() or event.get_user_id()
     
-    # Approve request
+    # Approve the request
     result = await event.approve()
     if result.get("status") == "ok":
-        await event.reply(f"Friend request automatically approved, welcome {user_name}")
+        await event.reply(f"Friend request approved automatically, welcome {user_name}")
 ```
 
 <details>
@@ -579,7 +581,7 @@ async def handle_friend_request(event):
 async def quiz_handler(event):
     conv = event.conversation(timeout=30)
     
-    # Multiple choice question
+    # Multiple-choice question
     answer = await conv.choose("Who is the creator of Python?", [
         "Guido van Rossum",
         "James Gosling", 
@@ -597,7 +599,7 @@ async def quiz_handler(event):
 async def menu_handler(event):
     conv = event.conversation(timeout=60)
     
-    # Branching, building complex interactive flows
+    # Branching, building complex interaction flow
     @conv.branch("main")
     async def main_menu():
         await conv.say("=== Main Menu ===\n1. Personal Information\n2. Settings\n3. Exit")
@@ -627,20 +629,20 @@ We welcome contributions to adapters!
 
 | Adapter | Description |
 |--------|------|
-| <img src=".github/assets/adapter_logo/kook.svg" height="20" alt="Kook" /> [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook (KaHeLa) instant messaging platform |
-| <img src=".github/assets/adapter_logo/matrix.svg" height="20" alt="Matrix" /> [Matrix](https://github.com/ErisPulse/ErisPulse-MatrixAdapter) | Decentralized communication protocol Matrix |
-| <img src=".github/assets/adapter_logo/onebot.png" height="20" alt="OneBot" /> [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | OneBot v11 general robot protocol |
+| <img src=".github/assets/adapter_logo/kook.svg" height="20" alt="Kook" /> [Kook](https://github.com/shanfishapp/ErisPulse-KookAdapter) | Kook (Kaihei La) instant messaging platform |
+| <img src=".github/assets/adapter_logo/matrix.svg" height="20" alt="Matrix" /> [Matrix](https://github.com/ErisPulse/ErisPulse-MatrixAdapter) | Matrix decentralized communication protocol |
+| <img src=".github/assets/adapter_logo/onebot.png" height="20" alt="OneBot" /> [OneBot11](https://github.com/ErisPulse/ErisPulse-OneBot11Adapter) | OneBot v11 generic robot protocol |
 | <img src=".github/assets/adapter_logo/onebot.png" height="20" alt="OneBot" /> [OneBot12](https://github.com/ErisPulse/ErisPulse-OneBot12Adapter) | OneBot v12 standard protocol |
 | <img src=".github/assets/adapter_logo/qqbot.svg" height="20" alt="QQ" /> [QQ](https://github.com/ErisPulse/ErisPulse-QQBotAdapter) | Official QQ robot platform |
-| <img src=".github/assets/adapter_logo/sandbox.png" height="20" alt="Sandbox" /> [Sandbox](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | Web-based debugging, no need to connect to real platforms |
+| <img src=".github/assets/adapter_logo/sandbox.png" height="20" alt="Sandbox" /> [Sandbox](https://github.com/ErisPulse/ErisPulse-SandboxAdapter) | Web-based debugging, no real platform integration required |
 | <img src=".github/assets/adapter_logo/telegram.svg" height="20" alt="Telegram" /> [Telegram](https://github.com/ErisPulse/ErisPulse-TelegramAdapter) | Global instant messaging platform |
-| <img src=".github/assets/adapter_logo/email.svg" height="20" alt="Email" /> [Email](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | Email protocol adapter |
+| <img src=".github/assets/adapter_logo/email.svg" height="20" alt="Email" /> [Email](https://github.com/ErisPulse/ErisPulse-EmailAdapter) | Email protocol adapter for sending and receiving |
 | <img src=".github/assets/adapter_logo/yunhu.png" height="20" alt="Yunhu" /> [Yunhu](https://github.com/ErisPulse/ErisPulse-YunhuAdapter) | Enterprise-level instant messaging platform (robot integration) |
-| <img src=".github/assets/adapter_logo/yunhu.png" height="20" alt="Yunhu" /> [Yunhu User](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | Yunhu user protocol-based adapter |
-| [Flower Maple Café](https://github.com/ErisPulse/ErisPulse-Ideaura/) | Allons! \(・ω・) / |
+| <img src=".github/assets/adapter_logo/yunhu.png" height="20" alt="Yunhu" /> [Yunhu User](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | Access adapter based on the Yunhu user protocol |
+| [Hua Feng Coffeehouse](https://github.com/ErisPulse/ErisPulse-Ideaura/) | Allons! \(・ω・) / |
 | <img src=".github/assets/adapter_logo/discord.svg" height="20" alt="Discord" /> [Discord](https://github.com/ErisPulse/ErisPulse-DiscordAdapter) | Global community communication platform, supports servers, channels, and private messages |
 | <img src=".github/assets/adapter_logo/webhook.svg" height="20" alt="Webhook" /> [Webhook](https://github.com/ErisPulse/ErisPulse-WebhookAdapter) | General HTTP bridge adapter, connects to any system |
-| <img src=".github/assets/adapter_logo/wechatmp.svg" height="20" alt="WechatMp" /> [WeChat Official Account](https://github.com/ErisPulse/ErisPulse-WechatMpAdapter) | Official WeChat public account platform |
+| <img src=".github/assets/adapter_logo/wechatmp.svg" height="20" alt="WechatMp" /> [WeChat Official Account](https://github.com/ErisPulse/ErisPulse-WechatMpAdapter) | Official WeChat official account platform |
 
 See [Adapter Details](docs/en/platform-guide/README.md)
 
@@ -652,7 +654,7 @@ See [Adapter Details](docs/en/platform-guide/README.md)
 
 | Multi-platform Bot | Chat Assistant | Automation Tool | Message Forwarding |
 |:---:|:---:|:---:|:---:|
-| Deploy identical functionality bots across multiple platforms | Integrate AI chat modules for entertainment and interaction | Message notifications, task management, data collection | Cross-platform message synchronization and forwarding |
+| Deploy the same functionality bot on multiple platforms | Integrate AI chat module for entertainment and interaction | Message notifications, task management, data collection | Cross-platform message synchronization and forwarding |
 
 </div>
 
@@ -680,39 +682,33 @@ https://t.me/ErisPulse
 
 ---
 
-### Contribution Guidelines
+### Contribution Guide
 
 The health of the ErisPulse project still needs your contribution! We welcome all forms of contributions:
 
 1. **Report Issues** — Submit bug reports on [GitHub Issues](https://github.com/ErisPulse/ErisPulse/issues)
 2. **Feature Requests** — Propose new ideas via [Community Discussions](https://github.com/ErisPulse/ErisPulse/discussions)
-3. **Code Contributions** — Please read the [Code Style](docs/en/styleguide/) and [Contribution Guidelines](CONTRIBUTING.md) before submitting PRs
+3. **Code Contributions** — Read [Code Style](docs/en/styleguide/) and [Contribution Guide](CONTRIBUTING.md) before submitting PRs
 4. **Documentation Improvements** — Help improve documentation and example code
 
 [Join Community Discussions](https://github.com/ErisPulse/ErisPulse/discussions)
 
 ---
 
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=ErisPulse/ErisPulse&type=Date)](https://star-history.com/#ErisPulse/ErisPulse&Date)
-
----
-
 <div align="center">
 
 ### Acknowledgments
 
 <img src=".github/assets/thanks.png" width="200" alt="Thanks" />
 
-Part of this project's code is based on [sdkFrame](https://github.com/runoneall/sdkFrame).
+Some code in this project is based on [sdkFrame](https://github.com/runoneall/sdkFrame).
 
-The core adapter standardization layer references and benefits from the [OneBot12 specification](https://12.onebot.dev/).
+The core adapter standardization layer refers to and benefits from the [OneBot12 specification](https://12.onebot.dev/).
 
 Special thanks to the Yunhu ecosystem and community.
 
-The early exploration and growth of ErisPulse would not have been possible without the support of the Yunhu developer community. Many ideas, adapters, and practical experiences originated here.
+ErisPulse's early exploration and growth would not have been possible without the support of the Yunhu developer community. Many ideas, adapters, and practical experiences originated here.
 
-We also thank all developers and project authors who have contributed to ErisPulse, OneBot ecosystem, and the open-source community.
+We also thank all developers and project authors who have contributed to ErisPulse, OneBot, and the open-source community.
 
-</div>
+</div>