Skip to content

FLY1919/ErisPulse

 
 

ErisPulse - 异步机器人开发框架

ErisPulse Logo

PyPI Python Versions Ruff Socket Badge

文档资源

平台 主站点 备用站点
文档 erisdev.com CloudflareGitHubNetlify
模块市场 erisdev.com CloudflareGitHubNetlify

核心特性

特性 描述
异步架构 完全基于 async/await 的异步设计
模块化系统 灵活的插件和模块管理
热重载 开发时自动重载,无需重启
错误管理 统一的错误处理和报告系统
配置管理 灵活的配置存储和访问

快速开始

一键安装脚本

Windows (PowerShell):

irm https://get.erisdev.com/install.ps1 -OutFile install.ps1; powershell -ExecutionPolicy Bypass -File install.ps1

macOS/Linux:

curl -sSL https://get.erisdev.com/install.sh | tee install.sh >/dev/null && chmod +x install.sh && ./install.sh

开发与测试

1. 克隆项目

git clone -b Develop/v2 https://github.com/ErisPulse/ErisPulse.git
cd ErisPulse

2. 环境搭建

使用 uv 同步项目环境:

uv sync

# 激活虚拟环境
source .venv/bin/activate   # macOS/Linux
# Windows: .venv\Scripts\activate

说明: ErisPulse 使用 Python 3.13 开发,但兼容 Python 3.10+

3. 安装依赖

uv pip install -e .

这将以"开发模式"安装 SDK,所有本地修改都会立即生效。

4. 验证安装

运行以下命令确认 SDK 正常加载:

python -c "from ErisPulse import sdk; sdk.init()"

5. 运行测试

我们提供了一个交互式测试脚本,可以帮助您快速验证SDK功能(于开发中):

uv run devs/test.py

测试功能包括:

  • 日志系统测试
  • 环境配置测试
  • 错误管理测试
  • 工具函数测试
  • 适配器功能测试

贡献指南

我们欢迎各种形式的贡献,包括但不限于:

  1. 报告问题
    GitHub Issues 提交bug报告

  2. 功能请求
    通过 社区讨论 提出新想法

  3. 代码贡献
    提交 Pull Request 前请阅读我们的 代码风格 以及 贡献指南

  4. 文档改进
    帮助完善文档和示例代码

加入社区讨论


About

ErisPulse - 一个 Python 异步优先 的机器人框架,支持插件化扩展、多协议适配

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 92.7%
  • PowerShell 3.5%
  • Shell 2.6%
  • JavaScript 1.2%