feat(bot): 实现 BotManager 并完善机器人注销逻辑

添加全局 BotManager 单例用于统一管理所有 Bot 实例
在 WS 关闭和 ReverseWSManager 清理时调用注销逻辑
修改广播插件使用 BotManager 获取所有活跃 Bot 实例
移除 echo 插件的权限限制并更新文档配置

core/managers/bot_manager.py

@@ -0,0 +1,57 @@
+from typing import Dict, List, Optional, TYPE_CHECKING
+import threading
+from ..utils.logger import ModuleLogger
+
+if TYPE_CHECKING:
+    from ..bot import Bot
+
+class BotManager:
+    """
+    Bot 实例管理器
+    
+    负责统一管理所有活跃的 Bot 实例（包括正向 WS 和反向 WS 连接的 Bot）。
+    提供注册、注销和获取 Bot 实例的方法。
+    """
+    def __init__(self):
+        self._bots: Dict[str, "Bot"] = {}  # type: ignore[assignment]  # key: bot_id (str), value: Bot instance
+        self._lock = threading.RLock()
+        self.logger = ModuleLogger("BotManager")
+
+    def register_bot(self, bot: "Bot") -> None:
+        """
+        注册一个 Bot 实例
+        """
+        if not bot or not bot.self_id:
+            self.logger.warning("尝试注册无效的 Bot 实例")
+            return
+            
+        bot_id = str(bot.self_id)
+        with self._lock:
+            self._bots[bot_id] = bot
+            self.logger.info(f"Bot 实例已注册: {bot_id}")
+
+    def unregister_bot(self, bot_id: str) -> None:
+        """
+        注销一个 Bot 实例
+        """
+        with self._lock:
+            if bot_id in self._bots:
+                del self._bots[bot_id]
+                self.logger.info(f"Bot 实例已注销: {bot_id}")
+
+    def get_bot(self, bot_id: str) -> Optional["Bot"]:
+        """
+        根据 ID 获取 Bot 实例
+        """
+        with self._lock:
+            return self._bots.get(str(bot_id))
+
+    def get_all_bots(self) -> List["Bot"]:
+        """
+        获取所有活跃的 Bot 实例
+        """
+        with self._lock:
+            return list(self._bots.values())
+
+# 全局单例实例
+bot_manager = BotManager()

core/managers/reverse_ws_manager.py

@@ -255,6 +255,10 @@ class ReverseWSManager:
                 del self._client_health[client_id]
         with self._bots_lock:
             if client_id in self.bots:
+                # 从 BotManager 注销
+                from .bot_manager import bot_manager
+                if self.bots[client_id].self_id:
+                    bot_manager.unregister_bot(str(self.bots[client_id].self_id))
                 del self.bots[client_id]
             
         # 清理该客户端的防重复数据

core/ws.py

@@ -232,6 +232,11 @@ class WS:
         """
         self.logger.info("正在关闭 WebSocket 客户端...")
         
+        # 从 BotManager 注销
+        if self.bot and self.self_id:
+            from .managers.bot_manager import bot_manager
+            bot_manager.unregister_bot(str(self.self_id))
+        
         if self.ws:
             await self.ws.close()