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

96 lines
3.6 KiB
Python

from __future__ import annotations
import logging
from typing import Any
from yuxi.channel.extensions.qqbot.api_client import QQBotApiClient
from yuxi.channel.extensions.qqbot.types import QQBotChatType
logger = logging.getLogger(__name__)
class QQBotOutboundMedia:
def __init__(self, api_client: QQBotApiClient, media_manager: Any = None):
self._api_client = api_client
self._media = media_manager
async def send_photo(
self, target_id: str, file_path: str, reply_to_id: str | None = None
) -> dict | None:
return await self._send_media_file(target_id, file_path, "image", reply_to_id)
async def send_voice(
self, target_id: str, file_path: str, reply_to_id: str | None = None
) -> dict | None:
return await self._send_media_file(target_id, file_path, "voice", reply_to_id)
async def send_video(
self, target_id: str, file_path: str, reply_to_id: str | None = None
) -> dict | None:
return await self._send_media_file(target_id, file_path, "video", reply_to_id)
async def send_document(
self, target_id: str, file_path: str, reply_to_id: str | None = None
) -> dict | None:
return await self._send_media_file(target_id, file_path, "file", reply_to_id)
async def _send_media_file(
self, target_id: str, file_path: str, media_type: str, reply_to_id: str | None = None
) -> dict | None:
chat_type, actual_target = self._parse_target(target_id)
if self._media:
result = await self._media.upload_file(file_path, chat_type.value, actual_target)
if result:
return result
from pathlib import Path
path = Path(file_path)
if not path.exists():
logger.warning("File not found for media send: %s", file_path)
return None
file_data = path.read_bytes()
qt = QQBotChatType.C2C if chat_type in (QQBotChatType.C2C, QQBotChatType.DM) else QQBotChatType.GROUP
from yuxi.channel.extensions.qqbot.api_routes import (
FILE_TYPE_FILE,
FILE_TYPE_IMAGE,
FILE_TYPE_VIDEO,
FILE_TYPE_VOICE,
)
ft_map = {"image": FILE_TYPE_IMAGE, "voice": FILE_TYPE_VOICE, "video": FILE_TYPE_VIDEO, "file": FILE_TYPE_FILE}
ft = ft_map.get(media_type, FILE_TYPE_FILE)
att = await self._api_client.upload_media(actual_target, file_data, path.name, ft, qt)
if att:
media_payload = {"file_info": att.file_info} if att.file_info else None
if chat_type == QQBotChatType.C2C:
await self._api_client.send_c2c_message(
actual_target, content="", msg_type=7, media=media_payload,
msg_id=reply_to_id,
)
else:
await self._api_client.send_group_message(
actual_target, content="", msg_type=7, media=media_payload,
msg_id=reply_to_id,
)
return {"url": att.url, "filename": att.filename, "file_info": att.file_info, "ttl": att.ttl}
return None
def _parse_target(self, target_id: str) -> tuple[QQBotChatType, str]:
parts = target_id.split(":", 2)
if len(parts) >= 3:
prefix = parts[1]
actual_id = parts[2]
if prefix in ("c2c", "dm"):
return (QQBotChatType.C2C, actual_id)
elif prefix == "group":
return (QQBotChatType.GROUP, actual_id)
elif prefix == "channel":
return (QQBotChatType.GUILD, actual_id)
return (QQBotChatType.C2C, target_id)