Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

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

License

Notifications You must be signed in to change notification settings

ErisPulse/ErisPulse

Repository files navigation

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()"

项目结构

ErisPulse/
├── src/
│ └── ErisPulse/ # 核心源代码
│ ├── Core/ # 核心模块
│ │ ├── Bases/ # 基础类定义
│ │ ├── Event/ # 事件系统
│ │ └── ... # 其他核心组件
│ └── __init__.py # SDK入口点
├── examples/ # 示例代码
├── devs/ # 开发工具
├── docs/ # 文档
├── tests/ # 测试代码
├── scripts/ # 脚本文件
└── config.toml # 默认配置文件

贡献指南

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

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

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

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

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

加入社区讨论


AltStyle によって変換されたページ (->オリジナル) /