refactor(schemas): 统一 message/notification 命名边界，旧名收敛至兼容映射表

- notification 域：渠道能力（MessageChannel→NotificationChannel、ChannelCapability* 迁入 notification.py）
- message 域：消息收发（Notification→Message、NotificationType→MessageType、CommingMessage→IncomingMessage、NotificationHistoryItem→MessageHistoryItem、NotificationClear*→MessageClear*）
- Agent 工具契约：send_notification_message→send_message、notification_callback→message_callback
- 源码不保留旧名物理别名，旧导入经 app/runtime/compat/manifest.py SYMBOL_ALIASES 惰性解析
- API 路径与持久化键冻结不变，前端零改动
- 新增兼容守护测试与 docs/rules/07 命名边界规范

app/schemas/event.py

@@ -4,7 +4,7 @@ from typing import Iterable, Optional, Dict, Any, List, Set, Callable
 from pydantic import BaseModel, Field, field_validator, model_validator
 
 from app.schemas.common import JsonData
-from app.schemas.message import MessageChannel
+from app.schemas.types import NotificationChannel
 from app.schemas.file import FileItem
 from app.schemas.media import OptionalMediaIdentityMixin, RequiredMediaIdentityMixin
 from app.schemas.types import MediaSource
@@ -366,7 +366,7 @@ class ResourceDownloadEventData(ChainEventData):
         # 输入参数
         context (Context): 当前资源上下文
         episodes (Set[int]): 需要下载的集数
-        channel (MessageChannel): 通知渠道
+        channel (NotificationChannel): 通知渠道
         origin (str): 来源（消息通知、Subscribe、Manual等）
         downloader (str): 下载器
         options (dict): 其他参数
@@ -380,7 +380,7 @@ class ResourceDownloadEventData(ChainEventData):
     # 输入参数
     context: Any = Field(None, description="当前资源上下文")
     episodes: Optional[Set[int]] = Field(None, description="需要下载的集数")
-    channel: Optional[MessageChannel] = Field(None, description="通知渠道")
+    channel: Optional[NotificationChannel] = Field(None, description="通知渠道")
     origin: Optional[str] = Field(None, description="来源")
     downloader: Optional[str] = Field(None, description="下载器")
     options: Optional[dict] = Field(default={}, description="其他参数")

app/schemas/message.py

@@ -1,14 +1,13 @@
-from dataclasses import dataclass
 from enum import Enum
-from typing import Optional, Union, List, Dict, Set, Any
+from typing import Optional, Union, List, Dict, Any
 
 from pydantic import BaseModel, Field, field_validator
 
 from app.schemas.common import JsonData
-from app.schemas.types import ContentType, NotificationType, MessageChannel
+from app.schemas.types import ContentType, MessageType, NotificationChannel
 
 
-class NotificationClearScope(str, Enum):
+class MessageClearScope(str, Enum):
     """
     通知中心清理范围。
     """
@@ -21,7 +20,8 @@ class NotificationClearScope(str, Enum):
     Media = "media"
 
 
-class NotificationClearBefore(BaseModel):
+
+class MessageClearBefore(BaseModel):
     """
     通知中心按范围记录的清理时间。
     """
@@ -34,6 +34,7 @@ class NotificationClearBefore(BaseModel):
     media: int = 0
 
 
+
 class MessageResponse(BaseModel):
     """
     消息发送响应，包含消息ID等信息用于后续编辑
@@ -44,7 +45,7 @@ class MessageResponse(BaseModel):
     # 聊天ID
     chat_id: Optional[Union[str, int]] = None
     # 消息渠道
-    channel: Optional[MessageChannel] = None
+    channel: Optional[NotificationChannel] = None
     # 消息来源
     source: Optional[str] = None
     # 渠道自定义上下文（如飞书流式卡片 card_id/element_id/sequence）
@@ -53,7 +54,7 @@ class MessageResponse(BaseModel):
     success: bool = False
 
 
-class NotificationHistoryItem(BaseModel):
+class MessageHistoryItem(BaseModel):
     """
     通知历史记录。
     """
@@ -84,17 +85,19 @@ class NotificationHistoryItem(BaseModel):
     note: Optional[JsonData] = None
 
 
-class WebMessageItem(NotificationHistoryItem):
+
+class WebMessageItem(MessageHistoryItem):
     """Web 消息历史记录。"""
 
 
-class NotificationClearData(BaseModel):
-    """通知中心各范围的清理时间。"""
+class MessageClearData(BaseModel):
+    """消息中心各范围的清理时间。"""
 
-    clear_before: NotificationClearBefore = Field(description="各范围清理时间")
+    clear_before: MessageClearBefore = Field(description="各范围清理时间")
 
 
-class CommingMessage(BaseModel):
+
+class IncomingMessage(BaseModel):
     """
     外来消息
     """
@@ -110,7 +113,7 @@ class CommingMessage(BaseModel):
         size: Optional[int] = None
 
         @classmethod
-        def from_value(cls, value: Any) -> Optional["CommingMessage.MessageImage"]:
+        def from_value(cls, value: Any) -> Optional["IncomingMessage.MessageImage"]:
             if value is None:
                 return None
             if isinstance(value, cls):
@@ -142,7 +145,7 @@ class CommingMessage(BaseModel):
         @classmethod
         def normalize_list(
             cls, values: Optional[Any]
-        ) -> Optional[List["CommingMessage.MessageImage"]]:
+        ) -> Optional[List["IncomingMessage.MessageImage"]]:
             if not values:
                 return None
             if not isinstance(values, list):
@@ -171,7 +174,7 @@ class CommingMessage(BaseModel):
     # 渠道适配器依据稳定用户 ID、管理员名单及渠道主用户 ID 生成的授权事实
     is_channel_admin: Optional[bool] = None
     # 消息渠道
-    channel: Optional[MessageChannel] = None
+    channel: Optional[NotificationChannel] = None
     # 来源（渠道名称）
     source: Optional[str] = None
     # 消息体
@@ -205,7 +208,7 @@ class CommingMessage(BaseModel):
     @classmethod
     def _normalize_images(
         cls, value: Any
-    ) -> Optional[List["CommingMessage.MessageImage"]]:
+    ) -> Optional[List["IncomingMessage.MessageImage"]]:
         return cls.MessageImage.normalize_list(value)
 
     def to_dict(self):
@@ -214,22 +217,23 @@ class CommingMessage(BaseModel):
         """
         items = self.model_dump()
         for k, v in items.items():
-            if isinstance(v, MessageChannel):
+            if isinstance(v, NotificationChannel):
                 items[k] = v.value
         return items
 
 
-class Notification(BaseModel):
+
+class Message(BaseModel):
     """
     消息
     """
 
     # 消息渠道
-    channel: Optional[MessageChannel] = None
+    channel: Optional[NotificationChannel] = None
     # 消息来源
     source: Optional[str] = None
     # 消息类型
-    mtype: Optional[NotificationType] = None
+    mtype: Optional[MessageType] = None
     # 内容类型
     ctype: Optional[ContentType] = None
     # 标题
@@ -281,11 +285,12 @@ class Notification(BaseModel):
         """
         items = self.model_dump()
         for k, v in items.items():
-            if isinstance(v, MessageChannel) or isinstance(v, NotificationType):
+            if isinstance(v, NotificationChannel) or isinstance(v, MessageType):
                 items[k] = v.value
         return items
 
 
+
 class NotificationSwitch(BaseModel):
     """
     消息开关
@@ -384,323 +389,3 @@ class AgentWebChoiceRequest(BaseModel):
     original_message_id: Optional[Union[str, int]] = Field(default=None)
     # WebAgent 原聊天 ID，用于传统按钮回调原地编辑
     original_chat_id: Optional[Union[str, int]] = Field(default=None)
-
-
-class ChannelCapability(Enum):
-    """
-    渠道能力枚举
-    """
-
-    # 支持内联按钮
-    INLINE_BUTTONS = "inline_buttons"
-    # 支持菜单命令
-    MENU_COMMANDS = "menu_commands"
-    # 支持消息编辑
-    MESSAGE_EDITING = "message_editing"
-    # 支持消息删除
-    MESSAGE_DELETION = "message_deletion"
-    # 支持回调查询
-    CALLBACK_QUERIES = "callback_queries"
-    # 支持富文本
-    RICH_TEXT = "rich_text"
-    # 支持 Markdown
-    MARKDOWN = "markdown"
-    # 支持图片
-    IMAGES = "images"
-    # 支持链接
-    LINKS = "links"
-    # 支持原生语音输出
-    AUDIO_OUTPUT = "audio_output"
-    # 支持文件发送
-    FILE_SENDING = "file_sending"
-    # 支持可收口的消息处理状态提示，如 reaction 或 typing
-    PROCESSING_STATUS = "processing_status"
-
-
-@dataclass
-class ChannelCapabilities:
-    """
-    渠道能力配置
-    """
-
-    channel: MessageChannel
-    capabilities: Set[ChannelCapability]
-    max_buttons_per_row: int = 5
-    max_button_rows: int = 10
-    max_button_text_length: int = 30
-    # 单条消息最大长度（0 表示不限制），用于流式输出时自动分段
-    max_message_length: int = 0
-    fallback_enabled: bool = True
-
-
-class ChannelCapabilityManager:
-    """
-    渠道能力管理器
-    """
-
-    _capabilities: Dict[MessageChannel, ChannelCapabilities] = {
-        MessageChannel.Telegram: ChannelCapabilities(
-            channel=MessageChannel.Telegram,
-            capabilities={
-                ChannelCapability.INLINE_BUTTONS,
-                ChannelCapability.MENU_COMMANDS,
-                ChannelCapability.MESSAGE_EDITING,
-                ChannelCapability.MESSAGE_DELETION,
-                ChannelCapability.CALLBACK_QUERIES,
-                ChannelCapability.MARKDOWN,
-                ChannelCapability.RICH_TEXT,
-                ChannelCapability.IMAGES,
-                ChannelCapability.LINKS,
-                ChannelCapability.AUDIO_OUTPUT,
-                ChannelCapability.FILE_SENDING,
-                ChannelCapability.PROCESSING_STATUS,
-            },
-            max_buttons_per_row=4,
-            max_button_rows=10,
-            max_button_text_length=30,
-            # Telegram 文本消息限制 4096 字符，预留空间给 MarkdownV2 转义和标题
-            max_message_length=3500,
-        ),
-        MessageChannel.Wechat: ChannelCapabilities(
-            channel=MessageChannel.Wechat,
-            capabilities={
-                ChannelCapability.IMAGES,
-                ChannelCapability.LINKS,
-                ChannelCapability.AUDIO_OUTPUT,
-                ChannelCapability.MENU_COMMANDS,
-            },
-            fallback_enabled=True,
-        ),
-        MessageChannel.Feishu: ChannelCapabilities(
-            channel=MessageChannel.Feishu,
-            capabilities={
-                ChannelCapability.INLINE_BUTTONS,
-                ChannelCapability.MESSAGE_EDITING,
-                ChannelCapability.CALLBACK_QUERIES,
-                ChannelCapability.MARKDOWN,
-                ChannelCapability.RICH_TEXT,
-                ChannelCapability.IMAGES,
-                ChannelCapability.LINKS,
-                ChannelCapability.AUDIO_OUTPUT,
-                ChannelCapability.FILE_SENDING,
-                ChannelCapability.PROCESSING_STATUS,
-            },
-            max_buttons_per_row=3,
-            max_button_rows=8,
-            max_button_text_length=20,
-            max_message_length=30000,
-            fallback_enabled=True,
-        ),
-        MessageChannel.WechatClawBot: ChannelCapabilities(
-            channel=MessageChannel.WechatClawBot,
-            capabilities={
-                ChannelCapability.MARKDOWN,
-                ChannelCapability.IMAGES,
-                ChannelCapability.LINKS,
-                ChannelCapability.FILE_SENDING,
-            },
-            max_message_length=2800,
-            fallback_enabled=True,
-        ),
-        MessageChannel.Slack: ChannelCapabilities(
-            channel=MessageChannel.Slack,
-            capabilities={
-                ChannelCapability.INLINE_BUTTONS,
-                ChannelCapability.MESSAGE_EDITING,
-                ChannelCapability.MESSAGE_DELETION,
-                ChannelCapability.CALLBACK_QUERIES,
-                ChannelCapability.MARKDOWN,
-                ChannelCapability.RICH_TEXT,
-                ChannelCapability.IMAGES,
-                ChannelCapability.LINKS,
-                ChannelCapability.MENU_COMMANDS,
-                ChannelCapability.FILE_SENDING,
-                ChannelCapability.PROCESSING_STATUS,
-            },
-            max_buttons_per_row=3,
-            max_button_rows=8,
-            max_button_text_length=25,
-            # Slack 消息限制 40000 字符，预留空间给格式化
-            max_message_length=39000,
-            fallback_enabled=True,
-        ),
-        MessageChannel.Discord: ChannelCapabilities(
-            channel=MessageChannel.Discord,
-            capabilities={
-                ChannelCapability.INLINE_BUTTONS,
-                ChannelCapability.MESSAGE_EDITING,
-                ChannelCapability.MESSAGE_DELETION,
-                ChannelCapability.CALLBACK_QUERIES,
-                ChannelCapability.MARKDOWN,
-                ChannelCapability.RICH_TEXT,
-                ChannelCapability.IMAGES,
-                ChannelCapability.LINKS,
-                ChannelCapability.FILE_SENDING,
-                ChannelCapability.PROCESSING_STATUS,
-            },
-            max_buttons_per_row=5,
-            max_button_rows=5,
-            max_button_text_length=80,
-            # Discord 消息限制 2000 字符
-            max_message_length=1800,
-            fallback_enabled=True,
-        ),
-        MessageChannel.SynologyChat: ChannelCapabilities(
-            channel=MessageChannel.SynologyChat,
-            capabilities={
-                ChannelCapability.MARKDOWN,
-                ChannelCapability.RICH_TEXT,
-                ChannelCapability.IMAGES,
-                ChannelCapability.LINKS,
-            },
-            fallback_enabled=True,
-        ),
-        MessageChannel.VoceChat: ChannelCapabilities(
-            channel=MessageChannel.VoceChat,
-            capabilities={
-                ChannelCapability.MARKDOWN,
-                ChannelCapability.RICH_TEXT,
-                ChannelCapability.IMAGES,
-                ChannelCapability.LINKS,
-            },
-            fallback_enabled=True,
-        ),
-        MessageChannel.WebPush: ChannelCapabilities(
-            channel=MessageChannel.WebPush,
-            capabilities={ChannelCapability.LINKS},
-            fallback_enabled=True,
-        ),
-        MessageChannel.Web: ChannelCapabilities(
-            channel=MessageChannel.Web,
-            capabilities={
-                ChannelCapability.MARKDOWN,
-                ChannelCapability.RICH_TEXT,
-                ChannelCapability.IMAGES,
-                ChannelCapability.LINKS,
-            },
-            fallback_enabled=True,
-        ),
-        MessageChannel.WebAgent: ChannelCapabilities(
-            channel=MessageChannel.WebAgent,
-            capabilities={
-                ChannelCapability.INLINE_BUTTONS,
-                ChannelCapability.CALLBACK_QUERIES,
-                ChannelCapability.MESSAGE_EDITING,
-                ChannelCapability.MARKDOWN,
-                ChannelCapability.RICH_TEXT,
-                ChannelCapability.IMAGES,
-                ChannelCapability.LINKS,
-                ChannelCapability.AUDIO_OUTPUT,
-                ChannelCapability.FILE_SENDING,
-            },
-            fallback_enabled=False,
-        ),
-        MessageChannel.QQ: ChannelCapabilities(
-            channel=MessageChannel.QQ,
-            capabilities={
-                ChannelCapability.RICH_TEXT,
-                ChannelCapability.IMAGES,
-                ChannelCapability.LINKS,
-                ChannelCapability.INLINE_BUTTONS,
-                ChannelCapability.CALLBACK_QUERIES,
-            },
-            max_buttons_per_row=5,
-            max_button_rows=5,
-            max_button_text_length=30,
-            fallback_enabled=True,
-        ),
-    }
-
-    @classmethod
-    def get_capabilities(cls, channel: MessageChannel) -> Optional[ChannelCapabilities]:
-        """
-        获取渠道能力
-        """
-        return cls._capabilities.get(channel)
-
-    @classmethod
-    def supports_capability(
-        cls, channel: MessageChannel, capability: ChannelCapability
-    ) -> bool:
-        """
-        检查渠道是否支持某项能力
-        """
-        channel_caps = cls.get_capabilities(channel)
-        if not channel_caps:
-            return False
-        return capability in channel_caps.capabilities
-
-    @classmethod
-    def supports_buttons(cls, channel: MessageChannel) -> bool:
-        """
-        检查渠道是否支持按钮
-        """
-        return cls.supports_capability(channel, ChannelCapability.INLINE_BUTTONS)
-
-    @classmethod
-    def supports_callbacks(cls, channel: MessageChannel) -> bool:
-        """
-        检查渠道是否支持回调
-        """
-        return cls.supports_capability(channel, ChannelCapability.CALLBACK_QUERIES)
-
-    @classmethod
-    def supports_editing(cls, channel: MessageChannel) -> bool:
-        """
-        检查渠道是否支持消息编辑
-        """
-        return cls.supports_capability(channel, ChannelCapability.MESSAGE_EDITING)
-
-    @classmethod
-    def supports_markdown(cls, channel: MessageChannel) -> bool:
-        """
-        检查渠道是否支持 Markdown。
-        """
-        return cls.supports_capability(channel, ChannelCapability.MARKDOWN)
-
-    @classmethod
-    def supports_deletion(cls, channel: MessageChannel) -> bool:
-        """
-        检查渠道是否支持消息删除
-        """
-        return cls.supports_capability(channel, ChannelCapability.MESSAGE_DELETION)
-
-    @classmethod
-    def get_max_buttons_per_row(cls, channel: MessageChannel) -> int:
-        """
-        获取每行最大按钮数
-        """
-        channel_caps = cls.get_capabilities(channel)
-        return channel_caps.max_buttons_per_row if channel_caps else 2
-
-    @classmethod
-    def get_max_button_rows(cls, channel: MessageChannel) -> int:
-        """
-        获取最大按钮行数
-        """
-        channel_caps = cls.get_capabilities(channel)
-        return channel_caps.max_button_rows if channel_caps else 5
-
-    @classmethod
-    def get_max_button_text_length(cls, channel: MessageChannel) -> int:
-        """
-        获取按钮文本最大长度
-        """
-        channel_caps = cls.get_capabilities(channel)
-        return channel_caps.max_button_text_length if channel_caps else 20
-
-    @classmethod
-    def get_max_message_length(cls, channel: MessageChannel) -> int:
-        """
-        获取单条消息最大长度（0 表示不限制）
-        """
-        channel_caps = cls.get_capabilities(channel)
-        return channel_caps.max_message_length if channel_caps else 0
-
-    @classmethod
-    def should_use_fallback(cls, channel: MessageChannel) -> bool:
-        """
-        是否应该使用降级策略
-        """
-        channel_caps = cls.get_capabilities(channel)
-        return channel_caps.fallback_enabled if channel_caps else True

app/schemas/notification.py

@@ -1,9 +1,13 @@
-"""通知渠道 API 输出模型。"""
+"""通知渠道能力与 API 输出模型。"""
 
-from typing import Optional
+from dataclasses import dataclass
+from enum import Enum
+from typing import Dict, Optional, Set
 
 from pydantic import BaseModel, Field
 
+from app.schemas.types import NotificationChannel
+
 
 class WechatClawBotKnownTarget(BaseModel):
     """微信 ClawBot 已知消息目标。"""
@@ -27,3 +31,323 @@ class WechatClawBotData(BaseModel):
     known_targets: list[WechatClawBotKnownTarget] = Field(default_factory=list)
     default_target: Optional[str] = None
     base_url: Optional[str] = None
+
+
+class ChannelCapability(Enum):
+    """
+    渠道能力枚举
+    """
+
+    # 支持内联按钮
+    INLINE_BUTTONS = "inline_buttons"
+    # 支持菜单命令
+    MENU_COMMANDS = "menu_commands"
+    # 支持消息编辑
+    MESSAGE_EDITING = "message_editing"
+    # 支持消息删除
+    MESSAGE_DELETION = "message_deletion"
+    # 支持回调查询
+    CALLBACK_QUERIES = "callback_queries"
+    # 支持富文本
+    RICH_TEXT = "rich_text"
+    # 支持 Markdown
+    MARKDOWN = "markdown"
+    # 支持图片
+    IMAGES = "images"
+    # 支持链接
+    LINKS = "links"
+    # 支持原生语音输出
+    AUDIO_OUTPUT = "audio_output"
+    # 支持文件发送
+    FILE_SENDING = "file_sending"
+    # 支持可收口的消息处理状态提示，如 reaction 或 typing
+    PROCESSING_STATUS = "processing_status"
+
+
+@dataclass
+class ChannelCapabilities:
+    """
+    渠道能力配置
+    """
+
+    channel: NotificationChannel
+    capabilities: Set[ChannelCapability]
+    max_buttons_per_row: int = 5
+    max_button_rows: int = 10
+    max_button_text_length: int = 30
+    # 单条消息最大长度（0 表示不限制），用于流式输出时自动分段
+    max_message_length: int = 0
+    fallback_enabled: bool = True
+
+
+class ChannelCapabilityManager:
+    """
+    渠道能力管理器
+    """
+
+    _capabilities: Dict[NotificationChannel, ChannelCapabilities] = {
+        NotificationChannel.Telegram: ChannelCapabilities(
+            channel=NotificationChannel.Telegram,
+            capabilities={
+                ChannelCapability.INLINE_BUTTONS,
+                ChannelCapability.MENU_COMMANDS,
+                ChannelCapability.MESSAGE_EDITING,
+                ChannelCapability.MESSAGE_DELETION,
+                ChannelCapability.CALLBACK_QUERIES,
+                ChannelCapability.MARKDOWN,
+                ChannelCapability.RICH_TEXT,
+                ChannelCapability.IMAGES,
+                ChannelCapability.LINKS,
+                ChannelCapability.AUDIO_OUTPUT,
+                ChannelCapability.FILE_SENDING,
+                ChannelCapability.PROCESSING_STATUS,
+            },
+            max_buttons_per_row=4,
+            max_button_rows=10,
+            max_button_text_length=30,
+            # Telegram 文本消息限制 4096 字符，预留空间给 MarkdownV2 转义和标题
+            max_message_length=3500,
+        ),
+        NotificationChannel.Wechat: ChannelCapabilities(
+            channel=NotificationChannel.Wechat,
+            capabilities={
+                ChannelCapability.IMAGES,
+                ChannelCapability.LINKS,
+                ChannelCapability.AUDIO_OUTPUT,
+                ChannelCapability.MENU_COMMANDS,
+            },
+            fallback_enabled=True,
+        ),
+        NotificationChannel.Feishu: ChannelCapabilities(
+            channel=NotificationChannel.Feishu,
+            capabilities={
+                ChannelCapability.INLINE_BUTTONS,
+                ChannelCapability.MESSAGE_EDITING,
+                ChannelCapability.CALLBACK_QUERIES,
+                ChannelCapability.MARKDOWN,
+                ChannelCapability.RICH_TEXT,
+                ChannelCapability.IMAGES,
+                ChannelCapability.LINKS,
+                ChannelCapability.AUDIO_OUTPUT,
+                ChannelCapability.FILE_SENDING,
+                ChannelCapability.PROCESSING_STATUS,
+            },
+            max_buttons_per_row=3,
+            max_button_rows=8,
+            max_button_text_length=20,
+            max_message_length=30000,
+            fallback_enabled=True,
+        ),
+        NotificationChannel.WechatClawBot: ChannelCapabilities(
+            channel=NotificationChannel.WechatClawBot,
+            capabilities={
+                ChannelCapability.MARKDOWN,
+                ChannelCapability.IMAGES,
+                ChannelCapability.LINKS,
+                ChannelCapability.FILE_SENDING,
+            },
+            max_message_length=2800,
+            fallback_enabled=True,
+        ),
+        NotificationChannel.Slack: ChannelCapabilities(
+            channel=NotificationChannel.Slack,
+            capabilities={
+                ChannelCapability.INLINE_BUTTONS,
+                ChannelCapability.MESSAGE_EDITING,
+                ChannelCapability.MESSAGE_DELETION,
+                ChannelCapability.CALLBACK_QUERIES,
+                ChannelCapability.MARKDOWN,
+                ChannelCapability.RICH_TEXT,
+                ChannelCapability.IMAGES,
+                ChannelCapability.LINKS,
+                ChannelCapability.MENU_COMMANDS,
+                ChannelCapability.FILE_SENDING,
+                ChannelCapability.PROCESSING_STATUS,
+            },
+            max_buttons_per_row=3,
+            max_button_rows=8,
+            max_button_text_length=25,
+            # Slack 消息限制 40000 字符，预留空间给格式化
+            max_message_length=39000,
+            fallback_enabled=True,
+        ),
+        NotificationChannel.Discord: ChannelCapabilities(
+            channel=NotificationChannel.Discord,
+            capabilities={
+                ChannelCapability.INLINE_BUTTONS,
+                ChannelCapability.MESSAGE_EDITING,
+                ChannelCapability.MESSAGE_DELETION,
+                ChannelCapability.CALLBACK_QUERIES,
+                ChannelCapability.MARKDOWN,
+                ChannelCapability.RICH_TEXT,
+                ChannelCapability.IMAGES,
+                ChannelCapability.LINKS,
+                ChannelCapability.FILE_SENDING,
+                ChannelCapability.PROCESSING_STATUS,
+            },
+            max_buttons_per_row=5,
+            max_button_rows=5,
+            max_button_text_length=80,
+            # Discord 消息限制 2000 字符
+            max_message_length=1800,
+            fallback_enabled=True,
+        ),
+        NotificationChannel.SynologyChat: ChannelCapabilities(
+            channel=NotificationChannel.SynologyChat,
+            capabilities={
+                ChannelCapability.MARKDOWN,
+                ChannelCapability.RICH_TEXT,
+                ChannelCapability.IMAGES,
+                ChannelCapability.LINKS,
+            },
+            fallback_enabled=True,
+        ),
+        NotificationChannel.VoceChat: ChannelCapabilities(
+            channel=NotificationChannel.VoceChat,
+            capabilities={
+                ChannelCapability.MARKDOWN,
+                ChannelCapability.RICH_TEXT,
+                ChannelCapability.IMAGES,
+                ChannelCapability.LINKS,
+            },
+            fallback_enabled=True,
+        ),
+        NotificationChannel.WebPush: ChannelCapabilities(
+            channel=NotificationChannel.WebPush,
+            capabilities={ChannelCapability.LINKS},
+            fallback_enabled=True,
+        ),
+        NotificationChannel.Web: ChannelCapabilities(
+            channel=NotificationChannel.Web,
+            capabilities={
+                ChannelCapability.MARKDOWN,
+                ChannelCapability.RICH_TEXT,
+                ChannelCapability.IMAGES,
+                ChannelCapability.LINKS,
+            },
+            fallback_enabled=True,
+        ),
+        NotificationChannel.WebAgent: ChannelCapabilities(
+            channel=NotificationChannel.WebAgent,
+            capabilities={
+                ChannelCapability.INLINE_BUTTONS,
+                ChannelCapability.CALLBACK_QUERIES,
+                ChannelCapability.MESSAGE_EDITING,
+                ChannelCapability.MARKDOWN,
+                ChannelCapability.RICH_TEXT,
+                ChannelCapability.IMAGES,
+                ChannelCapability.LINKS,
+                ChannelCapability.AUDIO_OUTPUT,
+                ChannelCapability.FILE_SENDING,
+            },
+            fallback_enabled=False,
+        ),
+        NotificationChannel.QQ: ChannelCapabilities(
+            channel=NotificationChannel.QQ,
+            capabilities={
+                ChannelCapability.RICH_TEXT,
+                ChannelCapability.IMAGES,
+                ChannelCapability.LINKS,
+                ChannelCapability.INLINE_BUTTONS,
+                ChannelCapability.CALLBACK_QUERIES,
+            },
+            max_buttons_per_row=5,
+            max_button_rows=5,
+            max_button_text_length=30,
+            fallback_enabled=True,
+        ),
+    }
+
+    @classmethod
+    def get_capabilities(cls, channel: NotificationChannel) -> Optional[ChannelCapabilities]:
+        """
+        获取渠道能力
+        """
+        return cls._capabilities.get(channel)
+
+    @classmethod
+    def supports_capability(
+        cls, channel: NotificationChannel, capability: ChannelCapability
+    ) -> bool:
+        """
+        检查渠道是否支持某项能力
+        """
+        channel_caps = cls.get_capabilities(channel)
+        if not channel_caps:
+            return False
+        return capability in channel_caps.capabilities
+
+    @classmethod
+    def supports_buttons(cls, channel: NotificationChannel) -> bool:
+        """
+        检查渠道是否支持按钮
+        """
+        return cls.supports_capability(channel, ChannelCapability.INLINE_BUTTONS)
+
+    @classmethod
+    def supports_callbacks(cls, channel: NotificationChannel) -> bool:
+        """
+        检查渠道是否支持回调
+        """
+        return cls.supports_capability(channel, ChannelCapability.CALLBACK_QUERIES)
+
+    @classmethod
+    def supports_editing(cls, channel: NotificationChannel) -> bool:
+        """
+        检查渠道是否支持消息编辑
+        """
+        return cls.supports_capability(channel, ChannelCapability.MESSAGE_EDITING)
+
+    @classmethod
+    def supports_markdown(cls, channel: NotificationChannel) -> bool:
+        """
+        检查渠道是否支持 Markdown。
+        """
+        return cls.supports_capability(channel, ChannelCapability.MARKDOWN)
+
+    @classmethod
+    def supports_deletion(cls, channel: NotificationChannel) -> bool:
+        """
+        检查渠道是否支持消息删除
+        """
+        return cls.supports_capability(channel, ChannelCapability.MESSAGE_DELETION)
+
+    @classmethod
+    def get_max_buttons_per_row(cls, channel: NotificationChannel) -> int:
+        """
+        获取每行最大按钮数
+        """
+        channel_caps = cls.get_capabilities(channel)
+        return channel_caps.max_buttons_per_row if channel_caps else 2
+
+    @classmethod
+    def get_max_button_rows(cls, channel: NotificationChannel) -> int:
+        """
+        获取最大按钮行数
+        """
+        channel_caps = cls.get_capabilities(channel)
+        return channel_caps.max_button_rows if channel_caps else 5
+
+    @classmethod
+    def get_max_button_text_length(cls, channel: NotificationChannel) -> int:
+        """
+        获取按钮文本最大长度
+        """
+        channel_caps = cls.get_capabilities(channel)
+        return channel_caps.max_button_text_length if channel_caps else 20
+
+    @classmethod
+    def get_max_message_length(cls, channel: NotificationChannel) -> int:
+        """
+        获取单条消息最大长度（0 表示不限制）
+        """
+        channel_caps = cls.get_capabilities(channel)
+        return channel_caps.max_message_length if channel_caps else 0
+
+    @classmethod
+    def should_use_fallback(cls, channel: NotificationChannel) -> bool:
+        """
+        是否应该使用降级策略
+        """
+        channel_caps = cls.get_capabilities(channel)
+        return channel_caps.fallback_enabled if channel_caps else True

app/schemas/types.py

@@ -436,7 +436,7 @@ class MediaImageType(Enum):
 
 
 # 消息类型
-class NotificationType(Enum):
+class MessageType(Enum):
     # 资源下载
     Download = "资源下载"
     # 整理入库
@@ -472,10 +472,10 @@ class ContentType(str, Enum):
     DownloadAdded = "downloadAdded"
 
 
-# 消息渠道
-class MessageChannel(Enum):
+# 通知渠道
+class NotificationChannel(Enum):
     """
-    消息渠道
+    通知渠道
     """
     Wechat = "微信"
     Feishu = "飞书"