ForcePilot/backend/package/yuxi/channel/extensions/wechat-kf/session.py

80 lines
3.1 KiB
Python
Raw Normal View History

feat(channel): 添加微信客服、微信公众号和微信支付通知渠道扩展 新增微信客服、微信公众号、微信支付通知三个渠道扩展。 微信客服渠道扩展功能模块: - account: 账户管理 - config: 渠道配置管理 - gateway: SSE/WebSocket 网关接入 - webhook: Webhook 事件处理 - outbound: 外发消息管理 - streaming: 流式消息处理 - pairing: 用户配对与绑定 - security: 安全校验 - crypto: 加解密处理 - dedupe: 消息去重 - customer: 客户管理 - servicer: 客服管理 - session: 会话管理 - status: 会话状态管理 - media: 媒体资源处理 - statistics: 统计功能 - sync: 数据同步 - upgrade: 升级处理 微信公众号渠道扩展功能模块: - config: 渠道配置管理 - gateway: SSE/WebSocket 网关接入 - webhook: Webhook 事件处理 - outbound: 外发消息管理 - streaming: 流式消息处理 - pairing: 用户配对与绑定 - security: 安全校验 - crypto: 加解密处理 - dedupe: 消息去重 - passive_reply: 被动回复 - message: 消息处理 - broadcast: 群发消息 - template: 模板消息 - menu: 菜单管理 - qrcode: 二维码管理 - user: 用户管理 - media: 媒体资源处理 - status: 会话状态管理 微信支付通知渠道扩展功能模块: - config: 渠道配置管理 - webhook: Webhook 事件处理 - crypto: 加解密与签名校验 - cert_manager: 证书管理 - event_router: 事件路由 - dedupe: 消息去重 - pay_repo: 支付数据仓库 - query_client: 查询客户端 - arq_tasks: 异步任务 - callback_compensator: 回调补偿
2026-05-21 12:00:30 +08:00
import time
from yuxi.channel.extensions.wechat_kf.types import KFAccount, KFSession, KFSessionStatus
class KFSessionManager:
def __init__(self, account: KFAccount):
self._account = account
self._sessions: dict[str, KFSession] = {}
self._last_cleanup: float = time.time()
def _session_key(self, open_kfid: str, external_user_id: str) -> str:
return f"{open_kfid}:{external_user_id}"
def get_session(self, open_kfid: str, external_user_id: str) -> KFSession | None:
self._cleanup_expired()
return self._sessions.get(self._session_key(open_kfid, external_user_id))
def create_session(self, open_kfid: str, external_user_id: str, session_id: str = "") -> KFSession:
session = KFSession(
session_id=session_id or f"sess_{int(time.time() * 1000)}",
kf_account_id=open_kfid,
external_user_id=external_user_id,
status=KFSessionStatus.ACTIVE,
created_at=time.time(),
last_user_msg_at=time.time(),
)
self._sessions[self._session_key(open_kfid, external_user_id)] = session
return session
def mark_user_message(self, open_kfid: str, external_user_id: str):
session = self.get_session(open_kfid, external_user_id)
if session:
session.last_user_msg_at = time.time()
session.msg_count_in_round = 0
if session.status == KFSessionStatus.CLOSED:
session.status = KFSessionStatus.ACTIVE
def mark_reply_sent(self, open_kfid: str, external_user_id: str):
session = self.get_session(open_kfid, external_user_id)
if session:
session.last_reply_at = time.time()
session.msg_count_in_round += 1
def close_session(self, open_kfid: str, external_user_id: str):
session = self.get_session(open_kfid, external_user_id)
if session:
session.status = KFSessionStatus.CLOSED
def can_send_message(self, open_kfid: str, external_user_id: str) -> tuple[bool, str]:
session = self.get_session(open_kfid, external_user_id)
if not session:
return False, "无活跃会话"
if session.status == KFSessionStatus.CLOSED:
return False, "会话已关闭"
now = time.time()
if now - session.last_user_msg_at > 48 * 3600:
return False, "已超过48小时下发窗口"
if session.msg_count_in_round >= 5:
return False, "本轮消息数已达上限(5条)"
return True, ""
def update_session(self, session: KFSession):
key = self._session_key(session.kf_account_id, session.external_user_id)
self._sessions[key] = session
def _cleanup_expired(self):
now = time.time()
if now - self._last_cleanup < 60:
return
self._last_cleanup = now
ttl = self._account.session_ttl
expired_keys = [
key
for key, sess in self._sessions.items()
if sess.status == KFSessionStatus.CLOSED and now - sess.created_at > ttl
]
for key in expired_keys:
del self._sessions[key]