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

76 lines
2.7 KiB
Python

from __future__ import annotations
import json
import logging
import time
from pathlib import Path
from typing import Any
from yuxi.channel.extensions.qqbot.types import SessionState
logger = logging.getLogger(__name__)
DEFAULT_SESSION_DIR = Path.home() / ".forcepilot" / "qqbot" / "sessions"
SESSION_EXPIRE_SECONDS = 300
class SessionStore:
def __init__(self, session_dir: Path | None = None):
self._session_dir = session_dir or DEFAULT_SESSION_DIR
self._session_dir.mkdir(parents=True, exist_ok=True)
def _session_path(self, account_id: str) -> Path:
safe_id = account_id.replace("/", "_").replace("\\", "_")
return self._session_dir / f"{safe_id}.json"
def save(self, account_id: str, state: SessionState) -> None:
path = self._session_path(account_id)
data = {
"session_id": state.session_id,
"last_seq": state.last_seq,
"last_connected_at": state.last_connected_at,
"account_id": state.account_id,
"saved_at": time.time(),
"app_id": state.app_id,
}
try:
path.write_text(json.dumps(data, ensure_ascii=False), encoding="utf-8")
logger.debug("Session saved for account '%s': session_id=%s", account_id, state.session_id)
except OSError as e:
logger.warning("Failed to save session for '%s': %s", account_id, e)
def load(self, account_id: str) -> SessionState | None:
path = self._session_path(account_id)
if not path.exists():
return None
try:
data = json.loads(path.read_text(encoding="utf-8"))
saved_at = data.get("saved_at", 0)
if time.time() - saved_at > SESSION_EXPIRE_SECONDS:
logger.debug("Session expired for account '%s'", account_id)
return None
return SessionState(
session_id=data.get("session_id"),
last_seq=data.get("last_seq"),
last_connected_at=data.get("last_connected_at", 0),
account_id=data.get("account_id", account_id),
saved_at=saved_at,
app_id=data.get("app_id"),
)
except (json.JSONDecodeError, OSError) as e:
logger.warning("Failed to load session for '%s': %s", account_id, e)
return None
def clear(self, account_id: str) -> None:
path = self._session_path(account_id)
try:
path.unlink(missing_ok=True)
except OSError:
pass
def clear_all(self) -> None:
for path in self._session_dir.glob("*.json"):
try:
path.unlink()
except OSError:
pass