Merge remote-tracking branch 'origin/v3' into v3

# Conflicts:
#	app/api/endpoints/agent.py
#	app/api/endpoints/anthropic.py
#	app/api/endpoints/openai.py
#	app/chain/__init__.py
#	app/chain/message.py
#	app/chain/site.py
#	app/chain/subscribe.py
#	app/chain/transfer.py
#	app/modules/discord/__init__.py
#	app/modules/qqbot/__init__.py
#	app/modules/slack/__init__.py
#	app/modules/telegram/__init__.py
#	app/modules/wechat/__init__.py
#	app/runtime/extensions/module_manager.py
#	app/runtime/extensions/service_registry.py
#	tests/test_agent_interaction.py
#	tests/test_slash_command_interactions.py
#	tests/test_web_agent_stream.py

app/runtime/extensions/service_config.py

@@ -0,0 +1,76 @@
+from typing import List, Optional, Type
+
+from pydantic import ValidationError
+
+from app.db.oper.systemconfig import SystemConfigOper
+from app.runtime.log import logger
+from app.schemas import (
+    DownloaderConf,
+    MediaServerConf,
+    NotificationConf,
+    NotificationSwitchConf,
+)
+from app.schemas.types import MessageType, SystemConfigKey
+
+
+class ServiceConfigHelper:
+    """读取并校验通知、下载器和媒体服务器的宿主配置。"""
+
+    @staticmethod
+    def get_configs(config_key: SystemConfigKey, conf_type: Type) -> List:
+        """按指定 Schema 过滤单条非法配置，避免影响同组其它服务。"""
+        config_data = SystemConfigOper().get(config_key)
+        if not config_data:
+            return []
+        configs = []
+        for conf in config_data:
+            if not isinstance(conf, dict):
+                logger.warning(f"{config_key.value} 配置格式不正确，已跳过：{conf}")
+                continue
+            try:
+                configs.append(conf_type(**conf))
+            except ValidationError as err:
+                logger.error(
+                    f"{config_key.value} 配置 {conf.get('name')} 校验失败，已跳过：{err}"
+                )
+        return configs
+
+    @staticmethod
+    def get_downloader_configs() -> List[DownloaderConf]:
+        """返回已通过结构校验的下载器配置。"""
+        return ServiceConfigHelper.get_configs(
+            SystemConfigKey.Downloaders,
+            DownloaderConf,
+        )
+
+    @staticmethod
+    def get_mediaserver_configs() -> List[MediaServerConf]:
+        """返回已通过结构校验的媒体服务器配置。"""
+        return ServiceConfigHelper.get_configs(
+            SystemConfigKey.MediaServers,
+            MediaServerConf,
+        )
+
+    @staticmethod
+    def get_notification_configs() -> List[NotificationConf]:
+        """返回已通过结构校验的通知配置。"""
+        return ServiceConfigHelper.get_configs(
+            SystemConfigKey.Notifications,
+            NotificationConf,
+        )
+
+    @staticmethod
+    def get_notification_switches() -> List[NotificationSwitchConf]:
+        """返回已通过结构校验的通知场景开关。"""
+        return ServiceConfigHelper.get_configs(
+            SystemConfigKey.NotificationSwitchs,
+            NotificationSwitchConf,
+        )
+
+    @staticmethod
+    def get_notification_switch(mtype: MessageType) -> Optional[str]:
+        """返回指定通知场景的目标范围。"""
+        for switch in ServiceConfigHelper.get_notification_switches():
+            if switch.type == mtype.value:
+                return switch.action
+        return None