update：示例插件

plugins/hello_world_plugin/plugin.py

@@ -0,0 +1,145 @@
+from typing import List, Tuple, Type
+from src.plugin_system import (
+    BasePlugin, register_plugin, BaseAction, BaseCommand,
+    ComponentInfo, ActionActivationType, ChatMode,
+    ConfigField
+)
+
+# ===== Action组件 =====
+
+class HelloAction(BaseAction):
+    """问候Action - 简单的问候动作"""
+
+    # === 基本信息（必须填写）===
+    action_name = "hello_greeting"
+    action_description = "向用户发送问候消息"
+
+    # === 功能描述（必须填写）===
+    action_parameters = {
+        "greeting_message": "要发送的问候消息"
+    }
+    action_require = [
+        "需要发送友好问候时使用",
+        "当有人向你问好时使用",
+        "当你遇见没有见过的人时使用"
+        ]
+    associated_types = ["text"]
+
+    async def execute(self) -> Tuple[bool, str]:
+        """执行问候动作 - 这是核心功能"""
+        # 发送问候消息
+        greeting_message = self.action_data.get("greeting_message","")
+        base_message = self.get_config("greeting.message", "嗨！很开心见到你！😊")
+        message = base_message + greeting_message
+        await self.send_text(message)
+
+        return True, "发送了问候消息"
+
+class ByeAction(BaseAction):
+    """告别Action - 只在用户说再见时激活"""
+    
+    action_name = "bye_greeting"
+    action_description = "向用户发送告别消息"
+    
+    # 使用关键词激活
+    focus_activation_type = ActionActivationType.KEYWORD
+    normal_activation_type = ActionActivationType.KEYWORD
+    
+    # 关键词设置
+    activation_keywords = ["再见", "bye", "88", "拜拜"]
+    keyword_case_sensitive = False
+    
+    action_parameters = {"bye_message": "要发送的告别消息"}
+    action_require = [
+        "用户要告别时使用",
+        "当有人要离开时使用",
+        "当有人和你说再见时使用",
+        ]
+    associated_types = ["text"]
+    
+    async def execute(self) -> Tuple[bool, str]:
+        bye_message = self.action_data.get("bye_message","")
+        
+        message = "再见！期待下次聊天！👋" + bye_message
+        await self.send_text(message)
+        return True, "发送了告别消息"
+
+class TimeCommand(BaseCommand):
+    """时间查询Command - 响应/time命令"""
+
+    command_name = "time"
+    command_description = "查询当前时间"
+
+    # === 命令设置（必须填写）===
+    command_pattern = r"^/time$"  # 精确匹配 "/time" 命令
+    command_help = "查询当前时间"
+    command_examples = ["/time"]
+    intercept_message = True  # 拦截消息，不让其他组件处理
+
+    async def execute(self) -> Tuple[bool, str]:
+        """执行时间查询"""
+        import datetime
+  
+        # 获取当前时间
+        time_format = self.get_config("time.format", "%Y-%m-%d %H:%M:%S")
+        now = datetime.datetime.now()
+        time_str = now.strftime(time_format)
+  
+        # 发送时间信息
+        message = f"⏰ 当前时间：{time_str}"
+        await self.send_text(message)
+  
+        return True, f"显示了当前时间: {time_str}"
+
+
+# ===== 插件注册 =====
+
+@register_plugin
+class HelloWorldPlugin(BasePlugin):
+    """Hello World插件 - 你的第一个MaiCore插件"""
+
+    # 插件基本信息
+    plugin_name = "hello_world_plugin"
+    plugin_description = "我的第一个MaiCore插件，包含问候功能"
+    plugin_version = "1.0.0"
+    plugin_author = "你的名字"
+    enable_plugin = True
+    config_file_name = "config.toml"  # 配置文件名
+
+    # 配置节描述
+    config_section_descriptions = {
+        "plugin": "插件基本信息",
+        "greeting": "问候功能配置",
+        "time": "时间查询配置"
+    }
+
+    # 配置Schema定义
+    config_schema = {
+        "plugin": {
+            "name": ConfigField(type=str, default="hello_world_plugin", description="插件名称"),
+            "version": ConfigField(type=str, default="1.0.0", description="插件版本"),
+            "enabled": ConfigField(type=bool, default=False, description="是否启用插件")
+        },
+        "greeting": {
+            "message": ConfigField(
+                type=str, 
+                default="嗨！很开心见到你！😊", 
+                description="默认问候消息"
+            ),
+            "enable_emoji": ConfigField(type=bool, default=True, description="是否启用表情符号")
+        },
+        "time": {
+            "format": ConfigField(
+                type=str, 
+                default="%Y-%m-%d %H:%M:%S", 
+                description="时间显示格式"
+            )
+        }
+    }
+
+    def get_plugin_components(self) -> List[Tuple[ComponentInfo, Type]]:
+        return [
+            (HelloAction.get_action_info(), HelloAction),
+            (ByeAction.get_action_info(), ByeAction),  # 添加告别Action
+            (TimeCommand.get_command_info(), TimeCommand),
+        ]