ForcePilot/backend/package/yuxi/channels/adapters/wechat/template_card.py
Kris 05abecc02b feat(wechat): 新增完整微信渠道适配器实现
该提交实现了支持企业微信、微信公众号、个人微信桥接三种模式的完整微信渠道适配器,包含以下核心模块:
1. 基础认证与配置相关:auth_adapter、config_reload、setup_contract等
2. 消息处理与格式转换:format、attachment_adapter、outbound_adapter等
3. 多模式客户端支持:wecom/mp子模块,包含加解密、消息收发能力
4. 辅助能力:限速器、防抖、会话绑定、事件映射、模板渲染等
5. 扩展能力:二维码登录、消息读取、特权用户、心跳监控等

实现了完整的微信生态对接能力,支持消息收发、事件处理、API调用限流、配置热重载等功能。
2026-05-12 00:51:04 +08:00

94 lines
2.5 KiB
Python

from __future__ import annotations
from dataclasses import dataclass
from typing import Any, Literal
@dataclass
class TemplateCardButton:
text: str
style: Literal["default", "primary", "danger"] = "default"
key: str = ""
url: str | None = None
miniprogram_appid: str | None = None
miniprogram_pagepath: str | None = None
@dataclass
class TemplateCard:
card_type: Literal["text_notice", "news_notice", "button_interaction"] = "text_notice"
title: str = ""
description: str = ""
url: str | None = None
image_url: str | None = None
buttons: list[TemplateCardButton] | None = None
emphasis_title: str | None = None
sub_title: str | None = None
task_id: str | None = None
extra: dict[str, Any] | None = None
class WeChatTemplateCardBuilder:
@staticmethod
def text_notice(title: str, description: str = "", url: str | None = None) -> TemplateCard:
return TemplateCard(
card_type="text_notice",
title=title,
description=description,
url=url,
)
@staticmethod
def news_notice(
title: str,
description: str = "",
url: str | None = None,
image_url: str | None = None,
) -> TemplateCard:
return TemplateCard(
card_type="news_notice",
title=title,
description=description,
url=url,
image_url=image_url,
)
@staticmethod
def button_interaction(
title: str,
description: str = "",
buttons: list[TemplateCardButton] | None = None,
task_id: str | None = None,
) -> TemplateCard:
return TemplateCard(
card_type="button_interaction",
title=title,
description=description,
buttons=buttons or [],
task_id=task_id,
)
@staticmethod
def button(
text: str,
key: str = "",
url: str | None = None,
style: Literal["default", "primary", "danger"] = "default",
) -> TemplateCardButton:
return TemplateCardButton(text=text, key=key, url=url, style=style)
@staticmethod
def miniprogram_button(
text: str,
appid: str,
pagepath: str,
style: Literal["default", "primary", "danger"] = "default",
) -> TemplateCardButton:
return TemplateCardButton(
text=text,
key="miniprogram",
miniprogram_appid=appid,
miniprogram_pagepath=pagepath,
style=style,
)