Plugin Dev

架构理解

核心概念

• Plugin — 普通类，非全局单例。实例化时传入 name、layer、scope 等静态参数。
• PluginManager — 全局单例。管理所有插件的注册表（name → Plugin 实例）。注册时检测重名，冲突则失败。
• Session — 由 session_id 区分。同一插件类在不同 session 中复用同一个实例。
• SessionManager — 全局单例。管理所有 Session 实例（session_id → Session 实例）。
• Layer — 依附于 Session，不是全局单例。每个 Session 有自己独立的 Layer 结构，记录该 session 内各插件的激活状态。
• Message — 在 Session 内部流转。按 Layer 顺序传递给各 Plugin，任一 Plugin 返回 False 就中断传递。

插件开发流程

# 1. 实例化插件，传入静态参数
app = Plugin(name="my_plugin", layer=1, scope="group")

# 2. 注册到插件管理器
app.register()  # 重名时注册失败

消息路由流程

MessageRouter.handle_message(bot_id, message)
  → 设置 context.bot_id、context.session_id
  → session_manager.get_or_create_session(session_id)
  → session.handle_message(message)
      → 按 Layer 0→1→2→3 顺序
      → 每层获取 active_plugins
      → 插件返回 False 则中断传递