fix(agent): grant channel owners admin access

app/helper/agent.py

@@ -1,31 +1,81 @@
 from queue import Queue
 from threading import Lock
-from typing import Optional, Union
+from typing import Callable, Iterable, Optional, Union
+
+from app.schemas.types import MessageChannel
 
 
 _WEB_AGENT_EDIT_QUEUES: dict[str, list[Queue[dict]]] = {}
 _WEB_AGENT_EDIT_LOCK = Lock()
+_ChannelAdminResolver = Callable[[Optional[dict]], Iterable[Union[str, int]]]
+_CHANNEL_ADMIN_RESOLVERS: dict[str, _ChannelAdminResolver] = {}
+
+
+def register_channel_admin_resolver(
+        channel: Union[MessageChannel, str],
+        resolver: _ChannelAdminResolver,
+) -> None:
+    """
+    注册消息渠道的管理员主体 ID 解析器。
+
+    :param channel: 消息渠道
+    :param resolver: 由渠道配置解析全部管理员主体 ID 的函数
+    """
+    channel_value = channel.value if isinstance(channel, MessageChannel) else str(channel)
+    _CHANNEL_ADMIN_RESOLVERS[channel_value] = resolver
+
+
+def resolve_config_principal_ids(
+        config: Optional[dict],
+        *config_keys: str,
+) -> set[str]:
+    """
+    从渠道自行声明的配置键中解析主体 ID。
+
+    :param config: 当前消息渠道配置
+    :param config_keys: 由渠道模块维护的主体 ID 配置键
+    :return: 去空白后的主体 ID 集合
+    """
+    principal_ids = set()
+    for config_key in config_keys:
+        principal_ids.update(
+            item.strip()
+            for item in str((config or {}).get(config_key) or "").split(",")
+            if item.strip()
+        )
+    return principal_ids
 
 
 def matches_channel_admin(
+        channel: Union[MessageChannel, str],
         config: Optional[dict],
-        admin_key: str,
         *principal_ids: Optional[Union[str, int]],
 ) -> bool:
-    """按渠道配置中的稳定主体 ID 判断管理员身份。"""
-    admins = {
-        item.strip()
-        for item in str((config or {}).get(admin_key) or "").split(",")
-        if item.strip()
+    """
+    按渠道配置中的稳定主体 ID 判断管理员身份。
+
+    :param channel: 消息渠道
+    :param config: 当前消息渠道配置
+    :param principal_ids: 消息渠道提供的稳定用户主体 ID
+    :return: 任一用户主体 ID 命中渠道注册的管理员集合时返回 True
+    """
+    channel_value = channel.value if isinstance(channel, MessageChannel) else str(channel)
+    resolver = _CHANNEL_ADMIN_RESOLVERS.get(channel_value)
+    if not resolver:
+        return False
+    authorized_ids = {
+        str(principal_id).strip()
+        for principal_id in resolver(config)
+        if principal_id is not None and str(principal_id).strip()
     }
-    if not admins:
+    if not authorized_ids:
         return False
     candidates = {
         str(principal_id).strip()
         for principal_id in principal_ids
         if principal_id is not None and str(principal_id).strip()
     }
-    return bool(admins.intersection(candidates))
+    return bool(authorized_ids.intersection(candidates))
 
 
 def normalize_web_agent_button_rows(buttons: Optional[list[list[dict]]]) -> list[list[dict]]: