ForcePilot/backend/package/yuxi/channel/extensions/qqbot/approval.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

85 lines
2.4 KiB
Python

from __future__ import annotations
import logging
import time
from dataclasses import dataclass, field
from typing import Any
logger = logging.getLogger(__name__)
@dataclass
class ApprovalRequest:
id: str
initiator_id: str
action: str
description: str
created_at: float = field(default_factory=time.time)
status: str = "pending"
class QQBotApprovalManager:
def __init__(self, config: dict, account_id: str = "default"):
self._config = config
self._account_id = account_id
self._requests: dict[str, ApprovalRequest] = {}
@property
def enabled(self) -> bool:
approval_cfg = self._get_approval_config()
return approval_cfg.get("enabled", False) in (True, "auto")
@property
def approvers(self) -> list[str]:
return self._get_approval_config().get("approvers", [])
def is_approver(self, peer_id: str) -> bool:
return peer_id in self.approvers
def create_request(self, initiator_id: str, action: str, description: str) -> ApprovalRequest:
import uuid
req_id = uuid.uuid4().hex[:12]
req = ApprovalRequest(
id=req_id,
initiator_id=initiator_id,
action=action,
description=description,
)
self._requests[req_id] = req
logger.info(
"Approval request created: id=%s, initiator=%s, action=%s",
req_id,
initiator_id,
action,
)
return req
def handle_decision(self, request_id: str, decision: str) -> ApprovalRequest | None:
req = self._requests.get(request_id)
if req is None:
return None
if decision in ("allow-once", "allow-always", "always"):
req.status = "approved"
elif decision == "deny":
req.status = "denied"
else:
req.status = "unknown"
logger.info(
"Approval decision: id=%s, decision=%s, status=%s",
request_id,
decision,
req.status,
)
return req
def get_request(self, request_id: str) -> ApprovalRequest | None:
return self._requests.get(request_id)
def _get_approval_config(self) -> dict:
channel_cfg = self._config.get("channels", {}).get("qqbot", {})
accounts = channel_cfg.get("accounts", {})
account = accounts.get(self._account_id, {})
return account.get("exec_approvals", {})