ForcePilot/backend/package/yuxi/channel/extensions/wechat-kf/session.py
Kris 87a8931db3 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

80 lines
3.1 KiB
Python

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]