入門ガイド

本ガイドは 5 分鐘で始めるの詳細な補足です。まだ最初のロボットを起動していない場合は、まずクイックスタートを完了してください。

ロボットを起動した後、ここではフレームワークの中心的な概念と一般的な機能を体系的に理解するための内容をご紹介します。

学習パス

以下の順序で読むことを推奨します：

ステップ	テーマ	説明
1	最初のロボットを作成する	コマンドハンドラを書き、実行メカニズムを理解する
2	基本概念	ErisPulse のコアアーキテクチャとモジュール設計を理解する
3	イベント処理の入門	メッセージ、コマンド、通知などのイベントを処理する方法を学ぶ
4	一般的なタスクの例	データの永続化、タイマー、権限制御などの一般的な機能をマスターする
5	IDE補完ガイド	タイプストアムを生成し、プラットフォーム固有のメソッドの IDE 自動補完を有効にする

ErisPulse は以下の2つの開発方法をサポートしています。

方法	適用シーン	説明
埋め込み開発	プロトタイプ作成、プロジェクト内の機能	`main.py` にプロセッサを直接記述し、独立したモジュールを作成する必要はありません。
モジュール開発（推奨）	本番環境、機能の配布	独立した Python パッケージを作成し、`epsdk install` を使用してインストールして使用します。

両方の方法の詳細な比較と例については、最初のロボットを作成するおよびモジュール開発の入門を参照してください。

ErisPulse はイベント駆動アーキテクチャを採用しており、以下の主要なシステムで構成されています。

アダプタシステム — 各プラットフォームとの通信を行い、プラットフォームのイベントを統一された OneBot12 標準形式に変換します。
イベントシステム — メッセージ、コマンド、通知、リクエスト、メタイベントの5種類のイベントを処理します。
モジュールシステム — 独立したモジュールにより機能を拡張でき、依存管理や遅延読み込みをサポートします。
コアモジュール — Storage（ストレージ）、Config（設定）、Logger（ログ）、Router（ルーティング）などの基本的な機能を提供します。

詳細なアーキテクチャ図と初期化の流れについては、アーキテクチャ概要をご参照ください。

準備はできていますか？