feat(commands): support background initialization

app/chain/command.py

@@ -12,9 +12,11 @@ from app.core.config import settings
 from app.core.event import Event as ManagerEvent, eventmanager, Event
 from app.core.plugin import PluginManager
 from app.helper.message import MessageHelper
+from app.helper.thread import ThreadHelper
 from app.log import logger
 from app.scheduler import Scheduler
 from app.schemas import Notification
+from app.schemas.event import CommandRegisterEventData
 from app.schemas.types import EventType, MessageChannel, ChainEventType
 from app.utils.object import ObjectUtils
 from app.utils.singleton import Singleton
@@ -154,32 +156,48 @@ class CommandChain(ChainBase, metaclass=Singleton):
             logger.debug("Development mode active. Skipping command initialization.")
             return
 
-        with self._rlock:
-            logger.debug("Acquired lock for initializing commands.")
-            self._plugin_commands = self.__build_plugin_commands()
-            self._commands = {
-                **self._preset_commands,
-                **self._plugin_commands,
-                **self._other_commands
-            }
+        # 使用线程池提交后台任务，避免引起阻塞
+        ThreadHelper().submit(self.__init_commands_background, pid)
 
-            # 触发事件允许可以拦截和调整命令
-            event, initial_commands = self.__trigger_register_commands_event()
+    def __init_commands_background(self, pid: Optional[str] = None) -> None:
+        """
+        后台初始化菜单命令
+        """
+        try:
+            with self._rlock:
+                logger.debug("Acquired lock for initializing commands in background.")
+                self._plugin_commands = self.__build_plugin_commands(pid)
+                self._commands = {
+                    **self._preset_commands,
+                    **self._plugin_commands,
+                    **self._other_commands
+                }
 
-            # 如果事件返回有效的 event_data，使用事件中调整后的命令
-            if event and event.event_data:
-                initial_commands = event.event_data.get("commands") or {}
-                logger.debug(f"Registering command count from event: {len(initial_commands)}")
-            else:
-                logger.debug(f"Registering initial command count: {len(initial_commands)}")
+                # 触发事件允许可以拦截和调整命令
+                event, initial_commands = self.__trigger_register_commands_event()
+
+                # 如果事件返回有效的 event_data，使用事件中调整后的命令
+                if event and event.event_data:
+                    event_data: CommandRegisterEventData = event.event_data
+                    initial_commands = event_data.commands or {}
+                    logger.debug(f"Registering command count from event: {len(initial_commands)}")
+                else:
+                    logger.debug(f"Registering initial command count: {len(initial_commands)}")
+
+                # initial_commands 必须是 self._commands 的子集
+                filtered_initial_commands = {
+                    cmd: details for cmd, details in initial_commands.items() if cmd in self._commands
+                }
 
                 # 对比调整后的命令与当前命令
-                if initial_commands == self._registered_commands:
+                if filtered_initial_commands == self._registered_commands:
                     logger.debug("Command set unchanged, skipping broadcast registration.")
                 else:
                     logger.debug("Command set has changed, Updating and broadcasting new commands.")
-                    self._registered_commands = initial_commands
-                    super().register_commands(commands=initial_commands)
+                    self._registered_commands = filtered_initial_commands
+                    super().register_commands(commands=filtered_initial_commands)
+        except Exception as e:
+            logger.error(f"Error occurred during command initialization in background: {e}", exc_info=True)
 
     def __trigger_register_commands_event(self) -> (Optional[Event], dict):
         """
@@ -207,15 +225,14 @@ class CommandChain(ChainBase, metaclass=Singleton):
         add_commands(self._preset_commands, "preset")
         add_commands(self._plugin_commands, "plugin")
         add_commands(self._other_commands, "other")
-        event_data = {
-            "commands": commands
-        }
+        event_data = CommandRegisterEventData(commands=commands, origin="CommandChain", service=None)
         return eventmanager.send_event(ChainEventType.CommandRegister, event_data), commands
 
-    def __build_plugin_commands(self) -> Dict[str, dict]:
+    def __build_plugin_commands(self, pid: Optional[str] = None) -> Dict[str, dict]:
         """
         构建插件命令
         """
+        # 为了保证命令顺序的一致性，目前这里没有直接使用 pid 获取单一插件命令，后续如果存在性能问题，可以考虑优化这里的逻辑
         plugin_commands = {}
         for command in self.pluginmanager.get_plugin_commands():
             cmd = command.get("cmd")

app/schemas/event.py

@@ -1,4 +1,4 @@
-from typing import Optional
+from typing import Optional, Dict
 
 from pydantic import BaseModel, Field, root_validator
 
@@ -66,7 +66,7 @@ class AuthCredentials(ChainEventData):
 
 class AuthInterceptCredentials(ChainEventData):
     """
-    AuthPassedIntercept 事件的数据模型
+    AuthIntercept 事件的数据模型
 
     Attributes:
         # 输入参数
@@ -90,3 +90,27 @@ class AuthInterceptCredentials(ChainEventData):
     # 输出参数
     source: str = Field("未知拦截源", description="拦截源")
     cancel: bool = Field(False, description="是否取消认证")
+
+
+class CommandRegisterEventData(ChainEventData):
+    """
+    CommandRegister 事件的数据模型
+
+    Attributes:
+        # 输入参数
+        commands (dict): 菜单命令
+        origin (str): 事件源，可以是 Chain 或具体的模块名称
+        service (str): 服务名称
+
+        # 输出参数
+        source (str): 拦截源，默认值为 "未知拦截源"
+        cancel (bool): 是否取消认证，默认值为 False
+    """
+    # 输入参数
+    commands: Dict[str, dict] = Field(..., description="菜单命令")
+    origin: str = Field(..., description="事件源")
+    service: Optional[str] = Field(..., description="服务名称")
+
+    # 输出参数
+    cancel: bool = Field(False, description="是否取消注册")
+    source: str = Field("未知拦截源", description="拦截源")