插件和组件管理API

src/plugin_system/apis/__init__.py

@@ -7,6 +7,7 @@
 # 导入所有API模块
 from src.plugin_system.apis import (
     chat_api,
+    component_manage_api,
     config_api,
     database_api,
     emoji_api,
@@ -14,15 +15,17 @@ from src.plugin_system.apis import (
     llm_api,
     message_api,
     person_api,
+    plugin_manage_api,
     send_api,
     utils_api,
-    plugin_register_api,
 )
 from .logging_api import get_logger
 from .plugin_register_api import register_plugin
+
 # 导出所有API模块，使它们可以通过 apis.xxx 方式访问
 __all__ = [
     "chat_api",
+    "component_manage_api",
     "config_api",
     "database_api",
     "emoji_api",
@@ -30,9 +33,9 @@ __all__ = [
     "llm_api",
     "message_api",
     "person_api",
+    "plugin_manage_api",
     "send_api",
     "utils_api",
-    "plugin_register_api",
     "get_logger",
     "register_plugin",
 ]

src/plugin_system/apis/component_manage_api.py

@@ -0,0 +1,222 @@
+from typing import Optional, Union, Dict
+from src.plugin_system.base.component_types import (
+    CommandInfo,
+    ActionInfo,
+    EventHandlerInfo,
+    PluginInfo,
+    ComponentType,
+)
+
+
+# === 插件信息查询 ===
+def get_all_plugin_info() -> Dict[str, PluginInfo]:
+    """
+    获取所有插件的信息。
+
+    Returns:
+        dict: 包含所有插件信息的字典，键为插件名称，值为 PluginInfo 对象。
+    """
+    from src.plugin_system.core.component_registry import component_registry
+
+    return component_registry.get_all_plugins()
+
+
+def get_plugin_info(plugin_name: str) -> Optional[PluginInfo]:
+    """
+    获取指定插件的信息。
+
+    Args:
+        plugin_name (str): 插件名称。
+
+    Returns:
+        PluginInfo: 插件信息对象，如果插件不存在则返回 None。
+    """
+    from src.plugin_system.core.component_registry import component_registry
+
+    return component_registry.get_plugin_info(plugin_name)
+
+
+# === 组件查询方法 ===
+def get_component_info(
+    component_name: str, component_type: ComponentType
+) -> Optional[Union[CommandInfo, ActionInfo, EventHandlerInfo]]:
+    """
+    获取指定组件的信息。
+
+    Args:
+        component_name (str): 组件名称。
+        component_type (ComponentType): 组件类型。
+    Returns:
+        Union[CommandInfo, ActionInfo, EventHandlerInfo]: 组件信息对象，如果组件不存在则返回 None。
+    """
+    from src.plugin_system.core.component_registry import component_registry
+
+    return component_registry.get_component_info(component_name, component_type)  # type: ignore
+
+
+def get_components_info_by_type(
+    component_type: ComponentType,
+) -> Dict[str, Union[CommandInfo, ActionInfo, EventHandlerInfo]]:
+    """
+    获取指定类型的所有组件信息。
+
+    Args:
+        component_type (ComponentType): 组件类型。
+
+    Returns:
+        dict: 包含指定类型组件信息的字典，键为组件名称，值为对应的组件信息对象。
+    """
+    from src.plugin_system.core.component_registry import component_registry
+
+    return component_registry.get_components_by_type(component_type)  # type: ignore
+
+
+def get_enabled_components_info_by_type(
+    component_type: ComponentType,
+) -> Dict[str, Union[CommandInfo, ActionInfo, EventHandlerInfo]]:
+    """
+    获取指定类型的所有启用的组件信息。
+
+    Args:
+        component_type (ComponentType): 组件类型。
+
+    Returns:
+        dict: 包含指定类型启用组件信息的字典，键为组件名称，值为对应的组件信息对象。
+    """
+    from src.plugin_system.core.component_registry import component_registry
+
+    return component_registry.get_enabled_components_by_type(component_type)  # type: ignore
+
+
+# === Action 查询方法 ===
+def get_registered_action_info(action_name: str) -> Optional[ActionInfo]:
+    """
+    获取指定 Action 的注册信息。
+
+    Args:
+        action_name (str): Action 名称。
+
+    Returns:
+        ActionInfo: Action 信息对象，如果 Action 不存在则返回 None。
+    """
+    from src.plugin_system.core.component_registry import component_registry
+
+    return component_registry.get_registered_action_info(action_name)
+
+
+def get_registered_command_info(command_name: str) -> Optional[CommandInfo]:
+    """
+    获取指定 Command 的注册信息。
+
+    Args:
+        command_name (str): Command 名称。
+
+    Returns:
+        CommandInfo: Command 信息对象，如果 Command 不存在则返回 None。
+    """
+    from src.plugin_system.core.component_registry import component_registry
+
+    return component_registry.get_registered_command_info(command_name)
+
+
+# === EventHandler 特定查询方法 ===
+def get_registered_event_handler_info(
+    event_handler_name: str,
+) -> Optional[EventHandlerInfo]:
+    """
+    获取指定 EventHandler 的注册信息。
+
+    Args:
+        event_handler_name (str): EventHandler 名称。
+
+    Returns:
+        EventHandlerInfo: EventHandler 信息对象，如果 EventHandler 不存在则返回 None。
+    """
+    from src.plugin_system.core.component_registry import component_registry
+
+    return component_registry.get_registered_event_handler_info(event_handler_name)
+
+
+# === 组件管理方法 ===
+def globally_enable_component(component_name: str, component_type: ComponentType) -> bool:
+    """
+    全局启用指定组件。
+
+    Args:
+        component_name (str): 组件名称。
+        component_type (ComponentType): 组件类型。
+
+    Returns:
+        bool: 启用成功返回 True，否则返回 False。
+    """
+    from src.plugin_system.core.component_registry import component_registry
+
+    return component_registry.enable_component(component_name, component_type)
+
+
+async def globally_disable_component(component_name: str, component_type: ComponentType) -> bool:
+    """
+    全局禁用指定组件。
+
+    **此函数是异步的，确保在异步环境中调用。**
+
+    Args:
+        component_name (str): 组件名称。
+        component_type (ComponentType): 组件类型。
+
+    Returns:
+        bool: 禁用成功返回 True，否则返回 False。
+    """
+    from src.plugin_system.core.component_registry import component_registry
+
+    return await component_registry.disable_component(component_name, component_type)
+
+
+def locally_enable_component(component_name: str, component_type: ComponentType, stream_id: str) -> bool:
+    """
+    局部启用指定组件。
+
+    Args:
+        component_name (str): 组件名称。
+        component_type (ComponentType): 组件类型。
+        stream_id (str): 消息流 ID。
+
+    Returns:
+        bool: 启用成功返回 True，否则返回 False。
+    """
+    from src.plugin_system.core.global_announcement_manager import global_announcement_manager
+
+    match component_type:
+        case ComponentType.ACTION:
+            return global_announcement_manager.enable_specific_chat_action(stream_id, component_name)
+        case ComponentType.COMMAND:
+            return global_announcement_manager.enable_specific_chat_command(stream_id, component_name)
+        case ComponentType.EVENT_HANDLER:
+            return global_announcement_manager.enable_specific_chat_event_handler(stream_id, component_name)
+        case _:
+            raise ValueError(f"未知 component type: {component_type}")
+
+
+def locally_disable_component(component_name: str, component_type: ComponentType, stream_id: str) -> bool:
+    """
+    局部禁用指定组件。
+
+    Args:
+        component_name (str): 组件名称。
+        component_type (ComponentType): 组件类型。
+        stream_id (str): 消息流 ID。
+
+    Returns:
+        bool: 禁用成功返回 True，否则返回 False。
+    """
+    from src.plugin_system.core.global_announcement_manager import global_announcement_manager
+
+    match component_type:
+        case ComponentType.ACTION:
+            return global_announcement_manager.disable_specific_chat_action(stream_id, component_name)
+        case ComponentType.COMMAND:
+            return global_announcement_manager.disable_specific_chat_command(stream_id, component_name)
+        case ComponentType.EVENT_HANDLER:
+            return global_announcement_manager.disable_specific_chat_event_handler(stream_id, component_name)
+        case _:
+            raise ValueError(f"未知 component type: {component_type}")

src/plugin_system/apis/plugin_manage_api.py

@@ -0,0 +1,95 @@
+from typing import Tuple, List
+def list_loaded_plugins() -> List[str]:
+    """
+    列出所有当前加载的插件。
+
+    Returns:
+        list: 当前加载的插件名称列表。
+    """
+    from src.plugin_system.core.plugin_manager import plugin_manager
+
+    return plugin_manager.list_loaded_plugins()
+
+
+def list_registered_plugins() -> List[str]:
+    """
+    列出所有已注册的插件。
+
+    Returns:
+        list: 已注册的插件名称列表。
+    """
+    from src.plugin_system.core.plugin_manager import plugin_manager
+
+    return plugin_manager.list_registered_plugins()
+
+
+async def remove_plugin(plugin_name: str) -> bool:
+    """
+    卸载指定的插件。
+    
+    **此函数是异步的，确保在异步环境中调用。**
+
+    Args:
+        plugin_name (str): 要卸载的插件名称。
+
+    Returns:
+        bool: 卸载是否成功。
+    """
+    from src.plugin_system.core.plugin_manager import plugin_manager
+
+    return await plugin_manager.remove_registered_plugin(plugin_name)
+
+
+async def reload_plugin(plugin_name: str) -> bool:
+    """
+    重新加载指定的插件。
+    
+    **此函数是异步的，确保在异步环境中调用。**
+
+    Args:
+        plugin_name (str): 要重新加载的插件名称。
+
+    Returns:
+        bool: 重新加载是否成功。
+    """
+    from src.plugin_system.core.plugin_manager import plugin_manager
+
+    return await plugin_manager.reload_registered_plugin(plugin_name)
+
+
+def load_plugin(plugin_name: str) -> Tuple[bool, int]:
+    """
+    加载指定的插件。
+
+    Args:
+        plugin_name (str): 要加载的插件名称。
+
+    Returns:
+        Tuple[bool, int]: 加载是否成功，成功或失败个数。
+    """
+    from src.plugin_system.core.plugin_manager import plugin_manager
+
+    return plugin_manager.load_registered_plugin_classes(plugin_name)
+
+def add_plugin_directory(plugin_directory: str) -> bool:
+    """
+    添加插件目录。
+
+    Args:
+        plugin_directory (str): 要添加的插件目录路径。
+    Returns:
+        bool: 添加是否成功。
+    """
+    from src.plugin_system.core.plugin_manager import plugin_manager
+
+    return plugin_manager.add_plugin_directory(plugin_directory)
+
+def rescan_plugin_directory() -> Tuple[int, int]:
+    """
+    重新扫描插件目录，加载新插件。
+    Returns:
+        Tuple[int, int]: 成功加载的插件数量和失败的插件数量。
+    """
+    from src.plugin_system.core.plugin_manager import plugin_manager
+
+    return plugin_manager.rescan_plugin_directory()