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

71 lines
2.4 KiB
Python

from __future__ import annotations
import logging
import time
from yuxi.channel.extensions.qqbot.errors import classify_close_code
logger = logging.getLogger(__name__)
BACKOFF_SEQUENCE_MS = [1000, 2000, 5000, 10000, 30000, 60000]
MAX_RETRY_COUNT = 100
FAST_DISCONNECT_THRESHOLD_MS = 5000
FAST_DISCONNECT_COUNT = 3
FAST_DISCONNECT_PENALTY_MS = 60000
class ReconnectStateMachine:
def __init__(self):
self._retry_count = 0
self._disconnect_timestamps: list[float] = []
self._penalty_until: float = 0.0
@property
def retry_count(self) -> int:
return self._retry_count
def handle_close(self, code: int) -> tuple[bool, float | None]:
should_retry, penalty = classify_close_code(code)
if not should_retry:
logger.info("Close code %d is not retryable", code)
return (False, None)
if penalty and penalty > 0:
logger.info("Close code %d requires penalty: %dms", code, penalty)
self._penalty_until = time.time() + penalty / 1000.0
delay = self._calculate_delay()
self._retry_count += 1
self._record_disconnect()
return (self._retry_count <= MAX_RETRY_COUNT, delay)
def _calculate_delay(self) -> float | None:
if time.time() < self._penalty_until:
penalty_delay = self._penalty_until - time.time()
logger.info("Penalty active, delay=%.1fs", penalty_delay)
return penalty_delay
if self._detect_fast_disconnect():
logger.info("Fast disconnect detected, applying penalty")
self._penalty_until = time.time() + FAST_DISCONNECT_PENALTY_MS / 1000.0
return FAST_DISCONNECT_PENALTY_MS / 1000.0
index = min(self._retry_count, len(BACKOFF_SEQUENCE_MS) - 1)
delay_ms = BACKOFF_SEQUENCE_MS[index]
return delay_ms / 1000.0
def _record_disconnect(self) -> None:
now = time.time()
self._disconnect_timestamps.append(now)
cutoff = now - FAST_DISCONNECT_THRESHOLD_MS / 1000.0
self._disconnect_timestamps = [t for t in self._disconnect_timestamps if t > cutoff]
def _detect_fast_disconnect(self) -> bool:
return len(self._disconnect_timestamps) >= FAST_DISCONNECT_COUNT
def reset(self) -> None:
self._retry_count = 0
self._disconnect_timestamps.clear()
self._penalty_until = 0.0