From cbc653ffd0ea9abf4360623dc7a7651e1a49cc61 Mon Sep 17 00:00:00 2001
From: 简律纯 <i@jyunko.cn>
Date: Sat, 25 Oct 2025 00:30:48 +0800
Subject: feat: Implement plugin system with combat tracker and dice analyzer

- Added `plugin_system_demo.py` to demonstrate basic plugin usage, processing, and analysis.
- Created `CombatTrackerPlugin` for tracking combat statistics including damage and healing.
- Developed `DiceAnalyzerPlugin` for analyzing dice rolls and calculating success rates.
- Introduced `renderer_demo.py` for rendering output in HTML, Markdown, and JSON formats.
- Implemented `rule_system_demo.py` to showcase rule engine capabilities with various examples.
- Established core rule engine functionality in `rules.py` with support for conditions and actions.
- Enhanced base plugin structure in `base.py` to support different plugin types (Processor, Renderer, Analyzer).
- Added custom exception handling in `exceptions.py` for better error management.
- Configured logging setup in `logging_config.py` for improved logging capabilities.
- Created unit tests in `test_rust_core.py` to validate core functionalities and performance.
---
 src/conventionalrp/plugins/base.py | 103 +++++++++++++++++++++++++++++++++++++
 1 file changed, 103 insertions(+)
 create mode 100644 src/conventionalrp/plugins/base.py

(limited to 'src/conventionalrp/plugins/base.py')

diff --git a/src/conventionalrp/plugins/base.py b/src/conventionalrp/plugins/base.py
new file mode 100644
index 0000000..f9e92a7
--- /dev/null
+++ b/src/conventionalrp/plugins/base.py
@@ -0,0 +1,103 @@
+from typing import Any, Dict, List, Optional
+from abc import ABC, abstractmethod
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class Plugin(ABC):
+    """
+    插件基类
+    
+    所有插件必须继承此类并实现必要的方法
+    """
+    
+    def __init__(self, name: str, version: str = "1.0.0"):
+        self.name = name
+        self.version = version
+        self.enabled = True
+        self.logger = logging.getLogger(f"conventionalrp.plugins.{name}")
+    
+    @abstractmethod
+    def initialize(self, config: Optional[Dict[str, Any]] = None):
+        pass
+    
+    @abstractmethod
+    def process(self, data: Any) -> Any:
+        pass
+    
+    def on_enable(self):
+        """插件启用时调用"""
+        self.logger.info(f"Plugin {self.name} enabled")
+    
+    def on_disable(self):
+        """插件禁用时调用"""
+        self.logger.info(f"Plugin {self.name} disabled")
+    
+    def get_metadata(self) -> Dict[str, Any]:
+        return {
+            "name": self.name,
+            "version": self.version,
+            "enabled": self.enabled,
+            "type": self.__class__.__name__,
+        }
+    
+    def __repr__(self) -> str:
+        return f"Plugin(name={self.name}, version={self.version}, enabled={self.enabled})"
+
+
+class ParserPlugin(Plugin):
+    def __init__(self, name: str, version: str = "1.0.0"):
+        super().__init__(name, version)
+        self.priority = 50
+    
+    @abstractmethod
+    def can_parse(self, text: str) -> bool:
+        """
+        判断是否可以解析给定文本
+        """
+        pass
+    
+    @abstractmethod
+    def parse(self, text: str) -> List[Dict[str, Any]]:
+        """
+        解析文本
+        """
+        pass
+
+
+class ProcessorPlugin(Plugin):
+    @abstractmethod
+    def process_token(self, token: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        处理单个 token
+        """
+        pass
+    
+    def process(self, data: Any) -> Any:
+        """
+        处理数据（实现基类方法）
+        """
+        if isinstance(data, dict):
+            return self.process_token(data)
+        elif isinstance(data, list):
+            return [self.process_token(token) for token in data]
+        return data
+
+
+class RendererPlugin(Plugin):
+    @abstractmethod
+    def render(self, data: Any) -> str:
+        pass
+    
+    def process(self, data: Any) -> Any:
+        return self.render(data)
+
+
+class AnalyzerPlugin(Plugin):
+    @abstractmethod
+    def analyze(self, data: Any) -> Dict[str, Any]:
+        pass
+    
+    def process(self, data: Any) -> Any:
+        return self.analyze(data)
-- 
cgit v1.2.3-70-g09d2