対応プラットフォーム機能

• 入力：外部システムが callback_path に POST → OneBot12 イベントに変換（json/textセグメントを透過）
• 出力：モジュール Send → outgoing_url に POST（二重ブリッジ）
• API：ブリッジの認証情報と実行状態（最小限の機能）

v5 ファンダメンタルの更新（4.2.0）

• Api DSL 最小集：get_self_info / get_status / get_version / get_supported_actions
• フレームワークのソフト依存：実行時に ErisPulse>=2.7.1 を検出し、警告を表示；起動時にバージョンのログを出力
• インポートパスを Core.Bases に更新

プラットフォームの機能説明 — Webhook 一般的なブリッジアダプター

このドキュメントでは、Webhookアダプターの双方向ブリッジプロトコル、フィールドマッピング、実装の特徴について詳しく説明します。

概要

Webhook アダプタは、プロトコルレベルのブリッジです。特定のプラットフォームに縛られることなく、HTTP経由でメッセージを受け渡します。HTTPリクエストを発行できる任意のシステムを ErisPulse に接続できます。

受信方向                                送信方向
────────                                ────────
外部システム                                ErisPulse モジュール
   │                                       │
   │ POST JSON                             │ Send.Text(...)
   ▼                                       ▼
┌──────────────────────────────────────────────────┐
│              WebhookAdapter                       │
│  ┌──────────────────┐   ┌──────────────────┐    │
│  │ 受信ルート          │   │ 送信転送          │    │
│  │ GET  (健康チェック)   │   │ client.post()    │    │
│  │ POST (イベント受信)   │   │ → outgoing_url   │    │
│  └────────┬─────────┘   └────────▲─────────┘    │
│           │                      │               │
│           ▼                      │               │
│  ┌──────────────────┐   ┌──────────────────┐    │
│  │ WebhookConverter │   │ Send クラス      │    │
│  │ JSON → OneBot12  │   │ メッセージセグメント → JSON │    │
│  └────────┬─────────┘   └────────▲─────────┘    │
└───────────┼──────────────────────┼───────────────┘
            ▼                      │
     adapter.emit(event)    call_api("send_message")
            │                      │
            ▼                      │
       ErisPulse イベントシステム ◄────────┘

複数アカウントモデル

各アカウントは、互いに干渉しない独立したブリッジ設定です。

各アカウントは、起動時に独立してルートを登録し、独立して emit connect を行います。

入站プロトコル

1. ヘルスチェック（GET）

• パス：{callback_path}
• メソッド：GET
• 認証：なし
• レスポンス：

{"status": "ok", "account": "default"}

2. イベントの受信（POST）

• パス：{callback_path}
• メソッド：POST
• Content-Type：application/json
• 認証（secret設定時）：Header X-Webhook-Secret または Query ?secret=

リクエストボディ

{
  "user_id": "u123",
  "user_nickname": "用户名",
  "group_id": "群组ID（仅群组会话）",
  "detail_type": "private",
  "message": [
    {"type": "text", "data": {"text": "消息内容"}}
  ],
  "raw": {}
}

レスポンス

{"status": "ok"}

エラーの際はHTTPステータスコードを返します：

3. フィールドマッピング（入力JSON → OneBot12イベント）

出力プロトコル

1. メッセージ送信

モジュールが Send.To(...).Text(...) などのメソッドを呼び出した場合、アダプターは outgoing_url に POST リクエストを送信します。

• メソッド：POST
• Content-Type：application/json
• 認証用ヘッダー（secret が設定されている場合）：X-Webhook-Secret: {secret}

リクエストボディ

{
  "target_type": "private",
  "target_id": "target_user_id",
  "account": "default",
  "message": [
    {"type": "text", "data": {"text": "メッセージ内容"}}
  ],
  "timestamp": 1700000000
}

2. 応答の標準化

アダプターは出力先が返す応答を ErisPulse の標準応答形式に標準化します。

{
  "status": "ok",
  "retcode": 0,
  "data": {"message_id": "...", ...},
  "message_id": "...",
  "message": "",
  "webhook_raw": {}
}

出力先の JSON 応答から message_id フィールドを抽出してメッセージ ID を取得します。出力先が message_id を返さない場合は、空文字列になります。

リクエストに失敗した場合はエラー応答を返します（status: "failed", retcode: 33001）。

Send メソッド

At / AtAll / Reply 修飾子は、フレームワークの基底クラスによって提供され、_apply_modifiers によってメッセージセグメントにマージされます。

イベント拡張メソッド (WebhookEventMixin)

特性マトリクス

注意事項

1. 単方向出力：outgoing_url が空の場合は、このアカウントは入力のみを受け付け、送信操作はエラーを返します。
2. 秘密鍵の安全性：secret は設定で暗号化された形式（metadata secret）で保存され、通信には HTTPS を使用することを推奨します。
3. パスの一意性：複数のアカウントの callback_path は互いに異なる必要があります。ルーティングの競合を避けるためです。
4. 冪等性：アダプターは入力イベントの重複排除を保証しません。外部システムがリトライ処理を独自に実行する必要があります。
5. タイムアウト：出力リクエストは ErisPulse の組み込み client を使用し、グローバルなタイムアウト設定を継承します。