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

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

src/common/data_models/message_manager_data_model.py

@@ -10,6 +10,7 @@ from enum import Enum
 from typing import List, Optional, TYPE_CHECKING
 
 from . import BaseDataModel
+from src.plugin_system.base.component_types import ChatType
 
 if TYPE_CHECKING:
     from .database_data_model import DatabaseMessages
@@ -28,6 +29,7 @@ class StreamContext(BaseDataModel):
     """聊天流上下文信息"""
 
     stream_id: str
+    chat_type: ChatType = ChatType.PRIVATE  # 聊天类型，默认为私聊
     unread_messages: List["DatabaseMessages"] = field(default_factory=list)
     history_messages: List["DatabaseMessages"] = field(default_factory=list)
     last_check_time: float = field(default_factory=time.time)
@@ -39,6 +41,42 @@ class StreamContext(BaseDataModel):
         message.is_read = False
         self.unread_messages.append(message)
 
+        # 自动检测和更新chat type
+        self._detect_chat_type(message)
+
+    def _detect_chat_type(self, message: "DatabaseMessages"):
+        """根据消息内容自动检测聊天类型"""
+        # 只有在第一次添加消息时才检测聊天类型，避免后续消息改变类型
+        if len(self.unread_messages) == 1:  # 只有这条消息
+            # 如果消息包含群组信息，则为群聊
+            if hasattr(message, 'chat_info_group_id') and message.chat_info_group_id:
+                self.chat_type = ChatType.GROUP
+            elif hasattr(message, 'chat_info_group_name') and message.chat_info_group_name:
+                self.chat_type = ChatType.GROUP
+            else:
+                self.chat_type = ChatType.PRIVATE
+
+    def update_chat_type(self, chat_type: ChatType):
+        """手动更新聊天类型"""
+        self.chat_type = chat_type
+
+    def is_group_chat(self) -> bool:
+        """检查是否为群聊"""
+        return self.chat_type == ChatType.GROUP
+
+    def is_private_chat(self) -> bool:
+        """检查是否为私聊"""
+        return self.chat_type == ChatType.PRIVATE
+
+    def get_chat_type_display(self) -> str:
+        """获取聊天类型的显示名称"""
+        if self.chat_type == ChatType.GROUP:
+            return "群聊"
+        elif self.chat_type == ChatType.PRIVATE:
+            return "私聊"
+        else:
+            return "未知类型"
+
     def get_unread_messages(self) -> List["DatabaseMessages"]:
         """获取未读消息"""
         return [msg for msg in self.unread_messages if not msg.is_read]