feat: 在插件系统中添加 Chatter 组件

- 在 component_types.py 中新增了用于 CHATTER 的 ComponentType。
- 实现了 ChatterInfo 类，用于存储 Chatter 组件的相关信息。
- 增强了 ComponentRegistry，以支持 Chatter 组件的注册与管理。
- 创建了 ChatterManager，用于管理 Chatter 实例并处理聊天流。
- 开发了 BaseChatter 抽象类，用于定义 Chatter 的行为规范。
- 实现了 AffinityChatter，作为具备兴趣评分与关系构建功能的具体 Chatter 组件。
- 添加了一个内置的 Chatter 插件，并附带完整文档与使用示例。
- 更新了 PluginManager，在插件概览中加入 Chatter 组件的统计信息。

src/plugin_system/base/base_chatter.py

@@ -0,0 +1,57 @@
+from abc import ABC, abstractmethod
+from typing import List, Optional, TYPE_CHECKING
+from src.common.data_models.message_manager_data_model import StreamContext
+from .component_types import ChatType
+from src.plugin_system.base.component_types import ChatterInfo, ComponentType
+
+if TYPE_CHECKING:
+    from src.chat.planner_actions.action_manager import ActionManager
+    from src.chat.planner_actions.planner import ActionPlanner
+
+class BaseChatter(ABC):
+    chatter_name: str = ""
+    """Chatter组件的名称"""
+    chatter_description: str = ""
+    """Chatter组件的描述"""
+    chat_types: List[ChatType] = [ChatType.PRIVATE, ChatType.GROUP]
+
+    def __init__(self, stream_id: str, planner: 'ActionPlanner', action_manager: 'ActionManager'):
+        """
+        初始化聊天处理器
+
+        Args:
+            stream_id: 聊天流ID
+            planner: 动作规划器
+            action_manager: 动作管理器
+        """
+        self.stream_id = stream_id
+        self.planner = planner
+        self.action_manager = action_manager
+
+    @abstractmethod
+    async def execute(self, context: StreamContext) -> dict:
+        """
+        执行聊天处理流程
+
+        Args:
+            context: StreamContext对象，包含聊天流的所有消息信息
+
+        Returns:
+            处理结果字典
+        """
+        pass
+
+    @classmethod
+    def get_chatter_info(cls) -> "ChatterInfo":
+        """从类属性生成ChatterInfo
+        Returns:
+            ChatterInfo对象
+        """
+        
+        return ChatterInfo(
+            name=cls.chatter_name,
+            description=cls.chatter_description or "No description provided.",
+            chat_type_allow=cls.chat_types[0],
+            component_type=ComponentType.CHATTER,
+        )
+

src/plugin_system/base/component_types.py

@@ -17,6 +17,7 @@ class ComponentType(Enum):
     TOOL = "tool"  # 工具组件
     SCHEDULER = "scheduler"  # 定时任务组件（预留）
     EVENT_HANDLER = "event_handler"  # 事件处理组件
+    CHATTER = "chatter"  # 聊天处理器组件
 
     def __str__(self) -> str:
         return self.value
@@ -54,8 +55,8 @@ class ChatMode(Enum):
 class ChatType(Enum):
     """聊天类型枚举，用于限制插件在不同聊天环境中的使用"""
 
-    GROUP = "group"  # 仅群聊可用
     PRIVATE = "private"  # 仅私聊可用
+    GROUP = "group"  # 仅群聊可用
     ALL = "all"  # 群聊和私聊都可用
 
     def __str__(self):
@@ -210,6 +211,17 @@ class EventHandlerInfo(ComponentInfo):
         self.component_type = ComponentType.EVENT_HANDLER
 
 
+@dataclass
+class ChatterInfo(ComponentInfo):
+    """聊天处理器组件信息"""
+
+    chat_type_allow: ChatType = ChatType.ALL  # 允许的聊天类型
+
+    def __post_init__(self):
+        super().__post_init__()
+        self.component_type = ComponentType.CHATTER
+
+
 @dataclass
 class EventInfo(ComponentInfo):
     """事件组件信息"""