ForcePilot/backend/package/yuxi/channel/extensions/qqbot/group_gating.py
Kris 2ab65f153f feat(channel): 添加 QQ Bot 渠道扩展
新增 QQ Bot 渠道扩展,支持在 Yuxi 平台中集成 QQ 机器人渠道。

包含以下功能模块:
- api_client: QQ API 客户端封装
- api_routes: API 路由管理
- config: 渠道配置管理
- gateway: SSE/WebSocket 网关接入
- websocket: WebSocket 实时连接
- credentials: 凭证管理
- token: Token 管理
- outbound: 外发消息管理
- outbound_media: 媒体外发
- streaming: 流式消息处理
- streaming_media: 媒体流处理
- pairing: 用户配对与绑定
- security: 安全校验
- dedupe: 消息去重
- monitor: 渠道状态监控
- status: 会话状态管理
- session: 会话管理
- pipeline: 消息管道
- pipeline_stages: 管道阶段
- commands: 指令处理
- commands_builtin: 内置指令
- interaction: 交互处理
- approval: 审批流程
- ark: ARK 消息
- audio: 音频处理
- media: 媒体资源
- media_chunked: 分块媒体
- media_tags: 媒体标签
- message_queue: 消息队列
- delivery: 消息送达确认
- reconnect: 重连机制
- typing_keepalive: 输入状态保活
- group_activation: 群激活
- group_gating: 群门控
- group_history: 群历史
- known_users: 已知用户
- ref_index: 引用索引
- tools: Agent 工具集成
- types: 类型定义
2026-05-21 11:35:12 +08:00

60 lines
2.0 KiB
Python

from __future__ import annotations
import logging
from typing import Any
from yuxi.channel.extensions.qqbot.types import GateDecision
logger = logging.getLogger(__name__)
class GroupGatingEngine:
def __init__(
self,
config: dict,
bot_openid: str | None = None,
security: Any | None = None,
):
self._config = config
self._bot_openid = bot_openid
self._security = security
async def resolve_gate_decision(self, ctx: Any) -> GateDecision:
msg = ctx.msg
group_openid = msg.group_openid or ""
is_at = "GROUP_AT_MESSAGE_CREATE" in (msg.event_type or "")
has_any_mention = bool(msg.mentions)
was_mentioned = self._bot_openid in (msg.mentions or [])
group_cfg = self._get_group_config(group_openid)
ignore_other_mentions = group_cfg.get("ignore_other_mentions", True)
require_mention = group_cfg.get("require_mention", True)
if ignore_other_mentions and has_any_mention and not was_mentioned:
return GateDecision.DROP_OTHER_MENTION
if msg.content.startswith("/"):
is_control = self._is_control_command(msg.content)
if is_control and not self._is_authorized(msg.sender_id):
return GateDecision.BLOCK_UNAUTHORIZED_COMMAND
if is_control:
return GateDecision.PROCESS
if require_mention and not is_at:
return GateDecision.SKIP_NO_MENTION
return GateDecision.PROCESS
def _get_group_config(self, group_openid: str) -> dict:
groups = self._config.get("channels", {}).get("qqbot", {}).get("groups", {})
return groups.get(group_openid, {})
def _is_control_command(self, content: str) -> bool:
control_prefixes = ("/bot-approve", "/bot-streaming", "/bot-clear-storage", "/bot-upgrade")
return content.startswith(control_prefixes)
def _is_authorized(self, sender_id: str) -> bool:
if self._security:
return self._security.check_dm_access(sender_id)
return False