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

69 lines
2.4 KiB
Python

from __future__ import annotations
import logging
import time
from dataclasses import dataclass, field
from typing import Any
from yuxi.channel.extensions.qqbot.types import KnownUser
logger = logging.getLogger(__name__)
class KnownUsersStore:
def __init__(self):
self._users: dict[str, KnownUser] = {}
def _make_key(self, account_id: str, openid: str, user_type: str, group_openid: str | None = None) -> str:
base = f"{account_id}:{openid}:{user_type}"
if group_openid:
base += f":{group_openid}"
return base
async def record_known_user(self, user: KnownUser) -> None:
key = self._make_key(user.account_id, user.openid, user.type, user.group_openid)
now = time.time()
if key in self._users:
existing = self._users[key]
existing.last_seen_at = now
existing.interaction_count += 1
if user.nickname:
existing.nickname = user.nickname
else:
user.first_seen_at = now
user.last_seen_at = now
user.interaction_count = 1
self._users[key] = user
async def get_known_user(
self, account_id: str, openid: str, user_type: str, group_openid: str | None = None
) -> KnownUser | None:
key = self._make_key(account_id, openid, user_type, group_openid)
return self._users.get(key)
async def list_known_users(self, account_id: str | None = None) -> list[KnownUser]:
users = list(self._users.values())
if account_id:
users = [u for u in users if u.account_id == account_id]
return sorted(users, key=lambda u: u.last_seen_at, reverse=True)
async def get_stats(self, account_id: str | None = None) -> dict:
users = await self.list_known_users(account_id)
now = time.time()
c2c_count = sum(1 for u in users if u.type == "c2c")
group_count = sum(1 for u in users if u.type == "group")
active_24h = sum(1 for u in users if now - u.last_seen_at < 86400)
active_7d = sum(1 for u in users if now - u.last_seen_at < 604800)
return {
"total_users": len(users),
"c2c_users": c2c_count,
"group_users": group_count,
"active_in_24h": active_24h,
"active_in_7d": active_7d,
}
def clear(self) -> None:
self._users.clear()