⚡ 初始提交 - FutureOSS v1.0 插件化运行时框架

一切皆为插件的开发者工具运行时框架

🧩 核心特性:
  - 插件热插拔 (importlib 动态加载)
  - 依赖自动解析 (拓扑排序 + 循环检测)
  - 企业级稳定 (熔断/降级/重试/隔离)
  - 事件驱动 (发布/订阅事件总线)
  - 完整配置 (YAML 配置 + 热重载)

oss/plugin/types.py

@@ -0,0 +1,92 @@
+"""插件类型定义"""
+from abc import ABC, abstractmethod
+from typing import Any, Optional
+
+
+# ========== 插件自定义类型注册 ==========
+_plugin_types: dict[str, Any] = {}
+
+
+def register_plugin_type(type_name: str, type_class: Any):
+    """注册插件自定义类型"""
+    _plugin_types[type_name] = type_class
+
+
+def get_plugin_type(type_name: str) -> Optional[Any]:
+    """获取已注册的插件类型"""
+    return _plugin_types.get(type_name)
+
+
+def list_plugin_types() -> dict[str, Any]:
+    """列出所有已注册的插件类型"""
+    return _plugin_types.copy()
+
+
+# ========== HTTP 响应类型 ==========
+class Response:
+    """HTTP 响应对象"""
+    def __init__(self, status: int = 200, headers: Optional[dict[str, str]] = None, body: str = ""):
+        self.status = status
+        self.headers = headers or {}
+        self.body = body
+
+
+# ========== 插件数据类型 ==========
+class Metadata:
+    """插件元数据"""
+    def __init__(self, name: str = "", version: str = "", author: str = "", description: str = ""):
+        self.name = name
+        self.version = version
+        self.author = author
+        self.description = description
+
+
+class PluginConfig:
+    """插件配置"""
+    def __init__(self, enabled: bool = True, args: Optional[dict[str, Any]] = None):
+        self.enabled = enabled
+        self.args = args or {}
+
+
+class Manifest:
+    """插件清单"""
+    def __init__(self, metadata: Optional[Metadata] = None, config: Optional[PluginConfig] = None, dependencies: Optional[list[str]] = None):
+        self.metadata = metadata or Metadata()
+        self.config = config or PluginConfig()
+        self.dependencies = dependencies or []
+
+
+# ========== 插件基类 ==========
+class Plugin(ABC):
+    """插件基类"""
+
+    @abstractmethod
+    def init(self, deps: Optional[dict[str, Any]] = None):
+        """初始化插件"""
+        ...
+
+    @abstractmethod
+    def start(self):
+        """启动插件"""
+        ...
+
+    @abstractmethod
+    def stop(self):
+        """停止插件"""
+        ...
+
+    def meta(self) -> Manifest:
+        """获取插件元数据"""
+        return Manifest()
+
+    def reload(self, config: Optional[dict[str, Any]] = None):
+        """热重载插件配置"""
+        pass
+
+    def health(self) -> bool:
+        """健康检查"""
+        return True
+
+    def stats(self) -> dict[str, Any]:
+        """获取插件统计信息"""
+        return {}