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

53 lines
1.8 KiB
Python

from __future__ import annotations
import logging
from typing import Any
from yuxi.channel.extensions.qqbot.format import chunk_markdown_text, md_to_qq_markdown
logger = logging.getLogger(__name__)
class QQBotDelivery:
def __init__(self, outbound: Any, account: Any):
self._outbound = outbound
self._account = account
async def deliver_text(
self, target_id: str, text: str, reply_to_id: str | None = None
) -> list[str]:
formatted = md_to_qq_markdown(text) if self._account.markdown_support else text
chunks = chunk_markdown_text(formatted)
sent_ids = []
for i, chunk in enumerate(chunks):
await self._outbound.send_text(
target_id, chunk, reply_to_id=reply_to_id if i == 0 else None
)
return sent_ids
async def deliver_media_tags(
self, target_id: str, text: str, reply_to_id: str | None = None
) -> tuple[str, list[str]]:
from yuxi.channel.extensions.qqbot.media_tags import parse_media_tags
plain_text, media_items = parse_media_tags(text)
media_ids: list[str] = []
for media_item in media_items:
try:
result = await self._outbound.send_media(
target_id,
media_item.url,
media_item.tag_type if media_item.tag_type != "qqmedia" else "auto",
reply_to_id=reply_to_id,
)
if result and result.get("url"):
media_ids.append(result["url"])
except Exception:
logger.exception("Failed to send media tag: %s", media_item.url)
if plain_text.strip():
await self._outbound.send_text(target_id, plain_text, reply_to_id=reply_to_id)
return plain_text, media_ids