入門指南
本指南是 5 分鐘快速開始 的深入補充。如果你還沒有成功啟動第一個機器人，請先完成快速開始。
機器人啟動後，這裡將帶你系統地理解框架的核心概念和常用功能。
學習路徑
建議按以下順序閱讀：
| 步驟 | 主題 | 說明 |
|---|---|---|
| 1 | 建立第一個機器人 | 編寫命令處理器，理解運行機制 |
| 2 | 基礎概念 | 理解 ErisPulse 的核心架構和模組設計 |
| 3 | 事件處理入門 | 學習如何處理訊息、命令、通知等各類事件 |
| 4 | 常見任務範例 | 掌握資料持久化、定時任務、權限控制等常用功能 |
| 5 | IDE 補全指南 | 產生類型存根，啟用平台特有方法的 IDE 自動補全 |
開發方式選擇
ErisPulse 支援兩種開發方式：
| 方式 | 適用場景 | 說明 |
|---|---|---|
| 嵌入式開發 | 快速原型、專案內部功能 | 直接在 main.py 中編寫處理器，無需建立獨立模組 |
| 模組開發（推薦） | 生產環境、功能分發 | 建立獨立的 Python 套件，透過 epsdk install 安裝使用 |
架構概覽
ErisPulse 採用事件驅動架構，核心由以下系統組成：
- 適配器系統 — 與各平台通信，將平台事件轉換為統一的 OneBot12 標準格式
- 事件系統 — 處理訊息、命令、通知、請求、元事件五大類事件
- 模組系統 — 透過獨立模組擴展功能，支援依賴管理和懶加載
- 核心模組 — 提供 Storage（儲存）、Config（設定）、Logger（日誌）、Router（路由）等基礎能力
詳細的架構圖和初始化流程請參考 架構概覽。
開始學習
準備好開始了嗎？
- 建立第一個機器人 — 5 分鐘上手