ErisPulse 2.5.0.dev1__tar.gz → 2.5.1__tar.gz

erispulse-2.5.1/PKG-INFO

@@ -0,0 +1,692 @@
+Metadata-Version: 2.4
+Name: ErisPulse
+Version: 2.5.1
+Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
+Project-URL: Homepage, https://github.com/ErisPulse/ErisPulse
+Project-URL: Documentation, https://www.erisdev.com#docs
+Project-URL: Repository, https://github.com/ErisPulse/ErisPulse
+Project-URL: Issues, https://github.com/ErisPulse/ErisPulse/issues
+Project-URL: Bug Tracker, https://github.com/ErisPulse/ErisPulse/blob/main/docs/en/bug-tracker.md
+Project-URL: Changelog, https://github.com/ErisPulse/ErisPulse/blob/main/CHANGELOG.md
+Author: ErisDev
+Maintainer-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
+License: MIT License
+        
+        Copyright (c) 2025-2026 ErisPulse
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+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
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: fastapi>=0.116.1
+Requires-Dist: rich>=13.0.0
+Requires-Dist: toml>=0.10.2
+Requires-Dist: uvicorn>=0.30.0
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: pyclean>=3.6.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.7; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: httpx>=0.24.0; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
+Requires-Dist: pytest-benchmark>=4.0.0; extra == 'test'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
+Requires-Dist: pytest-mock>=3.10.0; extra == 'test'
+Requires-Dist: pytest-xdist>=3.0.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+<img src=".github/assets/mascot-hero.png" align="right" width="300" alt="ErisPulse" style="margin-left: 24px; margin-bottom: 16px; border-radius: 12px;" />
+
+**English** | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [Русский](README.ru.md)
+
+# ErisPulse
+
+**Write once, deploy on multiple platforms.**
+
+Event-driven multi-platform chatbot development framework.
+
+Based on the OneBot12 standard interface, write once and deploy on multiple platforms. Flexible plugin system, hot reload support, and a complete developer toolchain, suitable for scenarios ranging 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>
+  <a href="https://pypi.org/project/ErisPulse/"><img src="https://img.shields.io/badge/Python-3.10+-FFD43B?style=for-the-badge&logo=python&logoColor=blue" alt="Python"></a>
+  <a href="https://hub.docker.com/r/erispulse/erispulse"><img src="https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white" alt="Docker"></a>
+  <a href="https://github.com/ErisPulse/ErisPulse/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License"></a>
+  <a href="https://github.com/ErisPulse/ErisPulse"><img src="https://img.shields.io/github/stars/ErisPulse/ErisPulse?style=for-the-badge&logo=github&color=brightgreen" alt="Stars"></a>
+  <a href="https://pepy.tech/project/ErisPulse"><img src="https://img.shields.io/pepy/dt/ErisPulse?style=for-the-badge&color=blue" alt="Downloads"></a>
+  <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=for-the-badge" alt="Ruff"></a>
+  <a href="https://socket.dev/pypi/package/erispulse"><img src="https://img.shields.io/badge/Socket-Secure-2ea043?style=for-the-badge&logo=socket&logoColor=white" alt="Socket"></a>
+  <a href="https://www.erisdev.com"><img src="https://img.shields.io/badge/文档-erisdev.com-FF6B9D?style=for-the-badge&logo=bookstack&logoColor=white" alt="文档"></a>
+  <a href="https://www.erisdev.com/#market"><img src="https://img.shields.io/badge/模块市场-erisdev.com-C724B1?style=for-the-badge&logo=webpack&logoColor=white" alt="模块市场"></a>
+  <a href="https://github.com/ErisPulse/ErisPulse/discussions"><img src="https://img.shields.io/badge/GitHub-Discussions-181717?style=for-the-badge&logo=github" alt="讨论"></a>
+</p>
+
+<br clear="both">
+
+---
+
+<div align="center">
+
+### Core Features
+
+</div>
+
+<table>
+<tr>
+<td width="33%" align="center" valign="top">
+<br/>
+
+<img src=".github/assets/icon/icon_event_driven.png.png" width="50" alt="Event-driven Architecture" />
+
+### Event-driven Architecture
+
+A clear event model based on the OneBot12 standard, making message handling logic more intuitive and efficient
+
+</td>
+<td width="33%" align="center" valign="top">
+<br/>
+
+<img src=".github/assets/icon/icon_cross_platform.png.png" width="50" alt="Cross-platform Compatibility" />
+
+### Cross-platform Compatibility
+
+Write plugins once and use them on all platforms, no need to repeat development for different platforms
+
+</td>
+<td width="33%" align="center" valign="top">
+<br/>
+
+<img src=".github/assets/icon/icon_modular.png" width="50" alt="Modular Design" />
+
+### Modular Design
+
+A flexible plugin system, easy to extend and integrate, supports hot-plug module management
+
+</td>
+</tr>
+<tr>
+<td width="33%" align="center" valign="top">
+<br/>
+
+<img src=".github/assets/icon/icon_hot_reload.png" width="50" alt="Hot Reload" />
+
+### Hot Reload
+
+Reload code without restarting during development
+
+</td>
+<td width="33%" align="center" valign="top">
+<br/>
+
+<img src=".github/assets/icon/icon_ai_assist.png" width="50" alt="AI Assistance" />
+
+### AI Assistance
+
+AI-assisted development brings requirements directly to usable modules
+
+</td>
+<td width="33%" align="center" valign="top">
+<br/>
+
+<img src=".github/assets/icon/icon_lightweight.png" width="50" alt="Concise and Elegant" />
+
+### Concise and Elegant
+
+Intuitive API design, making code as light and readable as feathers
+
+</td>
+</tr>
+</table>
+
+---
+
+## The Same Code. Multiple Platforms.
+
+*Exactly the same command handlers. Different platforms. No business logic changes required.*
+
+<table>
+<tr>
+<td align="center" width="33%">
+
+**Kook**
+
+<img src=".github/assets/demo-kook.png" alt="Kook Demo" />
+
+</td>
+<td align="center" width="33%">
+
+**QQ**
+
+<img src=".github/assets/demo-qq.png" alt="QQ Demo" />
+
+</td>
+<td align="center" width="33%">
+
+**Yunhu**
+
+<img src=".github/assets/demo-yunhu.png" alt="Yunhu Demo" />
+
+</td>
+</tr>
+</table>
+
+---
+
+## Ecosystem
+
+ErisPulse is more than just a framework. Install and start, no need to reinvent the wheel from scratch.
+
+<table>
+<tr>
+<td align="center" width="25%">
+
+**Framework**
+
+Core runtime
+
+Unified event & message model
+
+</td>
+<td align="center" width="25%">
+
+**Dashboard**
+
+Visual management
+
+Plugins · Logs · Configuration
+
+[Online Demo →](https://dashdemo.erisdev.com/)
+
+</td>
+<td align="center" width="25%">
+
+**AI Builder**
+
+Natural language → usable modules
+
+[Experience Now →](https://www.erisdev.com/#builder)
+
+</td>
+<td align="center" width="25%">
+
+**Module Market**
+
+Ready-to-use plugins
+
+[Explore Modules →](https://www.erisdev.com/#market)
+
+</td>
+</tr>
+<tr>
+<td align="center" width="25%">
+
+**Adapters**
+
+Access to 15+ platforms
+
+</td>
+<td align="center" width="25%">
+
+**Documentation**
+
+[erisdev.com](https://www.erisdev.com)
+
+</td>
+<td align="center" width="25%">
+
+**Docker**
+
+Multi-architecture support
+
+`erispulse/erispulse`
+
+</td>
+<td align="center" width="25%">
+
+**CLI**
+
+`epsdk` scaffolding tool
+
+</td>
+</tr>
+</table>
+
+---
+
+## Project Origin
+
+ErisPulse was not born to be a framework.
+
+It originated from **Amer** — a project for message interconnection and synchronization between different platforms.
+
+As the number of connected platforms increased, 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.**
+
+---
+
+### Quick Start
+
+#### One-click Installation Script (Recommended)
+
+The installation script automatically detects your environment (Docker, Python, uv), guides you to choose the most suitable installation method, and supports multiple languages (Chinese/English/日本語/Русский/繁體中文).
+
+Windows (PowerShell):
+```powershell
+irm https://get.erisdev.com/install.ps1 -OutFile install.ps1; powershell -ExecutionPolicy Bypass -File install.ps1
+```
+
+macOS / Linux:
+```bash
+curl -fsSL https://get.erisdev.com/install.sh -o install.sh && chmod +x install.sh && ./install.sh
+```
+
+<table>
+<tr>
+<td align="center" width="50%">
+
+**Docker Installation Demo**
+
+<video src="https://github.com/user-attachments/assets/a367a466-4678-46a9-b101-073a86388ede" controls width="100%"></video>
+
+</td>
+<td align="center" width="50%">
+
+**pip Installation Demo**
+
+<video src="https://github.com/user-attachments/assets/a2df4009-dba6-411e-b79d-4454a168d063" controls width="100%"></video>
+
+</td>
+</tr>
+</table>
+
+#### Using Docker (Recommended)
+
+```bash
+docker pull erispulse/erispulse:latest
+```
+
+<details>
+<summary>Unable to access Docker Hub?</summary>
+
+If Docker Hub is inaccessible, you can use GitHub Container Registry:
+
+```bash
+docker pull ghcr.io/erispulse/erispulse:latest
+```
+
+When using the ghcr.io image, you need to modify the `docker-compose.yml` image:
+```yaml
+image: ghcr.io/erispulse/erispulse:latest
+```
+
+</details>
+
+<details>
+<summary>Quick Start</summary>
+
+```bash
+# Download docker-compose.yml
+curl -O https://raw.githubusercontent.com/ErisPulse/ErisPulse/main/docker-compose.yml
+
+# Set Dashboard login token and start
+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 starting, visit `http://<host>:<port>/Dashboard` and use the set token as the password to log in to the Dashboard management panel.
+
+</details>
+
+<details>
+<summary>Using Pre-release Version (Dev)</summary>
+
+Set `ERISPULSE_CHANNEL=dev` to use the pre-release version:
+
+```bash
+# Method 1: Using environment variables (recommended)
+ERISPULSE_CHANNEL=dev ERISPULSE_DASHBOARD_TOKEN=your-token docker compose up -d
+
+# Method 2: Building dev image
+ERISPULSE_BUILD_TARGET=dev docker compose up -d --build
+```
+
+To ensure automatic update to the latest version at startup (regardless of stable or dev), explicitly set `ERISPULSE_UPDATE_ON_START=true`:
+
+```bash
+ERISPULSE_CHANNEL=dev ERISPULSE_UPDATE_ON_START=true docker compose up -d
+```
+
+You can also pull the pre-built dev image:
+
+```bash
+docker pull erispulse/erispulse:dev
+```
+
+</details>
+
+<details>
+<summary>Docker Environment Variables</summary>
+
+| Variable | Default | Description |
+|------|--------|------|
+| `ERISPULSE_CHANNEL` | `stable` | Version channel: `stable` (stable) or `dev` (pre-release) |
+| `ERISPULSE_UPDATE_ON_START` | `false` | Whether to automatically update to the latest version when the container starts (must be explicitly enabled) |
+| `ERISPULSE_DASHBOARD_TOKEN` | empty | Dashboard login token |
+| `ERISPULSE_PORT` | `8000` | Dashboard port mapping |
+| `TZ` | `Asia/Shanghai` | Container timezone |
+
+> Setting `ERISPULSE_UPDATE_ON_START=true` ensures that even if the image is old, the container will automatically fetch the latest version at startup.
+
+</details>
+
+#### 1Panel App Store
+
+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.
+
+#### Install Using pip
+
+```bash
+pip install ErisPulse
+```
+
+> You can also use the one-click installation script above, which automatically detects the environment and guides configuration.
+
+#### Initialize Project
+
+```bash
+# Interactive initialization
+epsdk init
+
+# Quick initialization (specify project name)
+epsdk init -q -n my_bot
+```
+
+#### Create Your First Bot
+
+Create a `main.py` file:
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+**Command Handlers**
+
+```python
+from ErisPulse import sdk
+from ErisPulse.Core.Event import command
+
+@command("hello", help="Send a greeting message")
+async def hello_handler(event):
+    user_name = event.get_user_nickname() or "friend"
+    await event.reply(f"Hello, {user_name}!")
+
+@command("ping", help="Test if the bot is online")
+async def ping_handler(event):
+    await event.reply("Pong! The bot is running normally.")
+
+if __name__ == "__main__":
+    import asyncio
+    asyncio.run(sdk.run(keep_running=True))
+```
+
+</td>
+<td width="50%" valign="top">
+
+**Effect Explanation**
+
+Send `/hello`
+
+Bot replies: `Hello, {username}!`
+
+---
+
+Send `/ping`
+
+Bot replies: `Pong! The bot is running normally.`
+
+---
+
+**Running Method**
+
+```bash
+epsdk run main.py
+# or development mode
+epsdk run main.py --reload
+```
+
+</td>
+</tr>
+</table>
+
+For more detailed instructions, see:
+- [Quick Start Guide](docs/en/quick-start.md)
+- [Getting Started Guide](docs/en/getting-started/)
+
+#### Multi-turn Conversation Example
+
+ErisPulse includes a powerful multi-turn conversation engine, easily enabling guided operations, information collection, and other interactive scenarios:
+
+```python
+from ErisPulse.Core.Event import command, request
+
+@command("register")
+async def register_handler(event):
+    conv = event.conversation(timeout=60)
+    
+    await conv.say("Welcome to register!")
+    
+    # Multi-step collection of user information, with automatic validation
+    data = await conv.collect([
+        {"key": "name", "prompt": "Please enter your name"},
+        {"key": "age", "prompt": "Please enter your age",
+         "validator": lambda e: e.get_text().strip().isdigit(),
+         "retry_prompt": "Age must be a number, please re-enter"},
+    ])
+    
+    if data and await conv.confirm(f"Confirm registration? Name: {data['name']}, Age: {data['age']}"):
+        # Push notifications using SendDSL
+        await sdk.adapter.get(event.get_platform()).Send.To(
+            "user", event.get_user_id()
+        ).Text(f"Registration successful! Welcome {data['name']}")
+        # Or await event.reply("Registration successful!")
+
+# Automatically handle friend requests
+@request.on_friend_request()
+async def handle_friend_request(event):
+    user_name = event.get_user_nickname() or event.get_user_id()
+    
+    # Approve the request
+    result = await event.approve()
+    if result.get("status") == "ok":
+        await event.reply(f"Friend request automatically approved, welcome {user_name}")
+```
+
+<details>
+<summary>See More Conversation API (Branching / Selection / Persistence)</summary>
+
+```python
+@command("quiz")
+async def quiz_handler(event):
+    conv = event.conversation(timeout=30)
+    
+    # Multiple choice question
+    answer = await conv.choose("Who is the creator of Python?", [
+        "Guido van Rossum",
+        "James Gosling", 
+        "Dennis Ritchie",
+    ])
+    
+    if answer == 0:
+        await conv.say("Correct!")
+    elif answer is None:
+        await conv.say("Timed out, try again next time!")
+    else:
+        await conv.say("Incorrect, the correct answer is Guido van Rossum")
+
+@command("menu")
+async def menu_handler(event):
+    conv = event.conversation(timeout=60)
+    
+    # Branching, building complex interaction flows
+    @conv.branch("main")
+    async def main_menu():
+        await conv.say("=== Main Menu ===\n1. Personal Info\n2. Settings\n3. Exit")
+        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("Name: Alice\n0. Return")
+        resp = await conv.wait()
+        if resp and resp.get_text().strip() == "0":
+            await conv.goto("main")
+    
+    await conv.start()
+```
+
+See [Conversation Multi-turn Dialogue](docs/en/advanced/conversation.md)
+
+</details>
+
+---
+
+## Supported Platforms
+
+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 (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 general 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 bot 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/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 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 access) |
+| <img src=".github/assets/adapter_logo/yunhu.png" height="20" alt="Yunhu" /> [Yunhu User](https://github.com/wsu2059q/ErisPulse-YunhuUserAdapter) | Access adapter based on Yunhu user protocol |
+| [Flower Maple Cafe](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 Official Account platform |
+
+See [Adapter Details](docs/en/platform-guide/README.md)
+
+---
+
+### Use Cases
+
+<div align="center">
+
+| Multi-platform Bot | Chat Assistant | Automation Tool | Message Forwarding |
+|:---:|:---:|:---:|:---:|
+| Deploy identical bots on multiple platforms | Integrate AI chat modules for entertainment and interaction | Message notification, task management, data collection | Cross-platform message synchronization and forwarding |
+
+</div>
+
+---
+
+## Community
+
+Join the ErisPulse community to exchange and build the ecosystem with developers.
+
+### Yunhu
+
+Group ID: `635409929`
+
+Join the group chat:
+
+https://yhfx.jwznb.com/share?key=VWJL4fTWXepa&ts=1781889199
+
+### QQ Group
+
+https://qm.qq.com/q/TOwnCmypcy
+
+### Telegram
+
+https://t.me/ErisPulse
+
+---
+
+### Contribution Guidelines
+
+The health of the ErisPulse project still needs your contribution! We welcome all forms of contributions:
+
+1. **Report Issues** — Submit bug reports in [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 a PR
+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" />
+
+This project is partially based on code from [sdkFrame](https://github.com/runoneall/sdkFrame).
+
+The core adapter standardization layer references 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, where many ideas, adapters, and practical experiences originated.
+
+We also thank all developers and project authors who have contributed to ErisPulse, OneBot, and the open-source community.
+
+</div>