暴露全部api，解决循环import问题

src/plugin_system/apis/__init__.py

@@ -16,6 +16,7 @@ from src.plugin_system.apis import (
     person_api,
     send_api,
     utils_api,
+    plugin_register_api,
 )
 
 # 导出所有API模块，使它们可以通过 apis.xxx 方式访问
@@ -30,4 +31,5 @@ __all__ = [
     "person_api",
     "send_api",
     "utils_api",
+    "plugin_register_api",
 ]

src/plugin_system/apis/plugin_register_api.py

@@ -0,0 +1,29 @@
+from src.common.logger import get_logger
+
+logger = get_logger("plugin_register")
+
+
+def register_plugin(cls):
+    from src.plugin_system.core.plugin_manager import plugin_manager
+    from src.plugin_system.base.base_plugin import BasePlugin
+
+    """插件注册装饰器
+
+    用法:
+        @register_plugin
+        class MyPlugin(BasePlugin):
+            plugin_name = "my_plugin"
+            plugin_description = "我的插件"
+            ...
+    """
+    if not issubclass(cls, BasePlugin):
+        logger.error(f"类 {cls.__name__} 不是 BasePlugin 的子类")
+        return cls
+
+    # 只是注册插件类，不立即实例化
+    # 插件管理器会负责实例化和注册
+    plugin_name = cls.plugin_name or cls.__name__
+    plugin_manager.plugin_classes[plugin_name] = cls
+    logger.debug(f"插件类已注册: {plugin_name}")
+
+    return cls