ForcePilot/backend/package/yuxi/channel/extensions/wechat-mp/gateway.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

154 lines
4.7 KiB
Python

import asyncio
import logging
import time
import httpx
from yuxi.channel.extensions.wechat_mp.config import WeChatMPConfig
logger = logging.getLogger(__name__)
TOKEN_URL = "https://api.weixin.qq.com/cgi-bin/token"
REFRESH_INTERVAL = 7000
RETRY_MAX = 3
RETRY_BASE_DELAY = 2
_queue: asyncio.Queue | None = None
_deduplicator = None
_gateway: "WeChatMPGateway | None" = None
def _get_webhook_queue() -> asyncio.Queue | None:
return _queue
def _get_deduplicator():
global _deduplicator
if _deduplicator is None:
from yuxi.channel.extensions.wechat_mp.dedupe import MessageDeduplicator
_deduplicator = MessageDeduplicator()
return _deduplicator
def _set_gateway(gw: "WeChatMPGateway") -> None:
global _gateway
_gateway = gw
def _get_gateway() -> "WeChatMPGateway | None":
return _gateway
class WeChatMPGateway:
def __init__(self):
self._account = None
self._queue: asyncio.Queue | None = None
self._cancel_event = asyncio.Event()
self._access_token: str | None = None
self._token_expires_at: float = 0
self._refresh_task: asyncio.Task | None = None
self._http: httpx.AsyncClient | None = None
self._running = False
self._token_lock = asyncio.Lock()
async def start(self, ctx) -> object:
global _queue
account = self._resolve_account(ctx)
if not account.is_configured():
logger.warning("WeChat MP account not configured, skipping start")
return {"running": False, "reason": "not-configured"}
self._account = account
_queue = asyncio.Queue(maxsize=1000)
self._queue = _queue
self._cancel_event.clear()
self._http = httpx.AsyncClient(timeout=15.0)
try:
await self._refresh_token()
self._refresh_task = asyncio.create_task(self._token_refresh_loop())
self._running = True
logger.info("WeChat MP gateway started for account %s", account.account_id)
return {"running": True, "account_id": account.account_id}
except Exception:
logger.exception("WeChat MP gateway failed to start")
await self.stop(ctx)
raise
async def stop(self, ctx) -> None:
global _queue
self._running = False
self._cancel_event.set()
if self._refresh_task and not self._refresh_task.done():
self._refresh_task.cancel()
try:
await self._refresh_task
except asyncio.CancelledError:
pass
if self._http:
await self._http.aclose()
self._http = None
_queue = None
self._queue = None
logger.info("WeChat MP gateway stopped")
@property
def access_token(self) -> str | None:
if self._access_token and time.time() < self._token_expires_at:
return self._access_token
return None
async def _token_refresh_loop(self):
while not self._cancel_event.is_set():
try:
await asyncio.sleep(REFRESH_INTERVAL)
if not self._cancel_event.is_set():
await self._refresh_token()
except asyncio.CancelledError:
break
async def _refresh_token(self):
async with self._token_lock:
if self._access_token and time.time() < self._token_expires_at:
return
params = {
"grant_type": "client_credential",
"appid": self._account.app_id,
"secret": self._account.app_secret,
}
for attempt in range(RETRY_MAX):
try:
resp = await self._http.get(TOKEN_URL, params=params)
data = resp.json()
if "access_token" in data:
self._access_token = data["access_token"]
self._token_expires_at = time.time() + data.get("expires_in", 7200) - 200
logger.info("WeChat MP access_token refreshed, expires in %ds", data["expires_in"])
return
errcode = data.get("errcode")
logger.error("Token refresh failed: errcode=%s, errmsg=%s", errcode, data.get("errmsg"))
if errcode in (-1, 40001, 40014):
raise ConnectionError(f"Invalid credentials: {data.get('errmsg')}")
except Exception:
if attempt == RETRY_MAX - 1:
raise
delay = RETRY_BASE_DELAY * (2 ** attempt)
await asyncio.sleep(delay)
@staticmethod
def _resolve_account(ctx):
config = WeChatMPConfig()
return config.resolve_account()