WeiXinMPSDK 综合示例实战指南:基于 Senparc.Weixin.Sample.Net8 的全平台微信模块集成与 AI 对话能力

原创2026-09-24 13:22:001,884 阅读
文章标签:后端即时通讯API设计

WeiXinMPSDK 综合示例实战指南:基于 Senparc.Weixin.Sample.Net8 的全平台微信模块集成与 AI 对话能力

本指南以 Senparc.Weixin.Sample.Net8 项目说明 为核心,系统讲解 WeiXinMPSDK 仓库中这套"全家桶"综合示例的工程结构、配置体系、消息处理链路,以及已集成到其中的公众号 AI 对话、多模态与长对话记忆能力。读完本文,你将掌握如何基于 .NET 8 快速搭建一个同时承载公众号、小程序、企业微信、微信支付(V2/V3)、开放平台的 MVC 项目,并能在自己的 MessageHandler 中复刻一套完整的 AI 机器人交互方案。

一、项目定位:为什么需要这样一套"综合示例"

在仓库的 Samples 目录 下,官方为不同平台分别维护了独立示例(公众号 MP、微信支付 TenPayV2 与 TenPayV3、企业微信 Work、小程序 WxOpen 等)。而 net8-mvc 下的 Senparc.Weixin.Sample.Net8 则是将 Senparc.Weixin SDK 各模块集成在一起的综合示例,以 .NET 8.0 作为默认 Web 运行框架。

它的设计目标非常明确:

  • 面向综合场景:当你的真实项目同时涉及多个微信平台时,可以直接以本项目为起点,而不是从零拼接多个独立示例;
  • 模块有边界:由于各模块整合后业务逻辑复杂度上升,示例中已使用注释、文件夹等方式对模块进行清晰区分,阅读代码没有障碍(详见 readme.md);
  • 按需取舍:如果仅需查看单个模块的示例代码(公众号、小程序、开放平台、微信支付等),可以退回 Samples 目录直接查看对应独立文件夹。

从工程文件 Senparc.Weixin.Sample.net8.csproj 可以看到,Web 项目通过 ProjectReference 引用 Senparc.Weixin.Net8Sample.CommonService.csproj(项目文件),并依赖 Senparc.AI.Agents、Senparc.AI.Kernel、Senparc.CO2NET.WebApi、Senparc.NeuChar.App/AspNet、Microsoft.AspNetCore.Mvc.NewtonsoftJson 等包,同时通过 Senparc.Weixin.Sample.Shared.projitems 共享静态资源与视图——这正是"一个解决方案承载全部微信模块"的骨架。

二、环境准备与编译前提

该示例可以直接进行部署测试,高级功能测试需要修改配置文件(如修改 appId 等)。在编译与运行前需要注意:

  • IDE 版本:建议使用 Visual Studio 2022(或更新版本),并安装 .NET 8.0 SDK;
  • 多目标编译前提:由于仓库 /src 下的源码使用了条件编译(#if NET462 等),默认情况下需要开发环境同时安装 .NET Framework 4.6.2 与 .NET 8.0 才能完整编译;
  • 可调试 SDK 源码:当前 Sample 可用于直接调试 Senparc.Weixin SDK,支持 .NET 4.6.2+、.NET Standard 2.1+、.NET 8.0 的不同版本库编译,并可在 Release 编译条件下生成 NuGet 包。

如果希望使用更新的运行时,仓库还提供了 net10-mvc 版本 与 net45-mvc 版本 作为对照;项目根目录同时存在 Senparc.Weixin.Sample.Net8.sln 与 Senparc.Weixin.Sample.Net10.sln 两个解决方案文件。

三、工程结构:按模块划分的 Controller 体系

整个 Web 项目的核心入口是 Program.cs,它使用 Host.CreateDefaultBuilder 配置 WebHost,并通过 UseServiceProviderFactory(new SenparcServiceProviderFactory()) 接入 Senparc 的依赖注入体系,随后委托给 Startup.cs 完成服务注册与管道配置。

Controllers 目录 是理解模块边界的"地图",它被组织为以下三类:

目录 承载模块 代表控制器
Controllers/Weixin/MP/ 公众号 WeixinController(消息回调)、OAuth2Controller、MenuController、MediaController、AnalysisController、SubscribeMsgController、WeixinJSSDKController、WeixinAsyncController、WebSocketController、DeviceController、AsyncMethodsController
Controllers/Weixin/Open/ 开放平台 OpenController、OpenOAuthController(第三方授权)
Controllers/Weixin/TenPay/ 微信支付 TenPayController(V2)、TenPayV3Controller、TenPayApiV3Controller
Controllers/ThirdPartyAuth/ 第三方平台授权 ThirdPartyAuthController
Controllers/Weixin/Work/ 企业微信 WorkController
Controllers/Weixin/WxOpen/ 小程序 WxOpenController
Controllers/Tools/ 配套工具与演示 AiDocController、CacheController、DocumentController、FilterTestController、ForTestController、PluginsController、QrCodeController、SimulateToolController
Controllers/ 根 通用 HomeController、BaseController、CaseCollectionController

配合 Views 目录 下的同名视图(TenPay/、TenPayV3/、TenPayApiV3/、WxOpen/、Work/ 等),可以快速定位某一模块的完整请求-视图链路。

四、注册与启动流程:Startup.cs 中的模块装配

Startup.cs 是理解"如何把全部微信模块装进一个站点"的关键文件,其装配顺序如下:

  1. 基础服务:AddSession()、AddControllersWithViews().AddNewtonsoftJson()、AddMemoryCache()(本地缓存必须)、AddSignalR()(WebSocket 演示);
  2. SDK 注册(必须):services.AddSenparcWeixin(Configuration, Env),随后按需追加 AddSenparcWebSocket<CustomNetCoreWebSocketMessageHandler>()(WebSocket 能力)与 AddSenparcAI(Configuration)(AI 能力);
  3. 全局初始化(必须):app.UseSenparcGlobal(...) 启动 CO2NET 全局注册,其中可配置:
    • 分布式缓存:通过 Cache_Redis_Configuration / Cache_Memcached_Configuration 配置串决定是否启用 Redis(UseKeyValueRedisNow() 键值对策略 / UseHashRedisNow() HashSet 策略)或 Memcached,未启用时回退到内存缓存;代码中 UseRedis() / UseMemcached() 以"是否还是 #{...#} 占位符默认值"来判断是否启用;
    • 日志:RegisterTraceLog(ConfigTraceLog),Debug 状态下会在 App_Data/WeixinTraceLog/ 目录生成全部 API 请求日志;
    • APM 统计:CO2NET.APM.Config.EnableAPM(默认开启)、DataExpire(默认 60 分钟);
  4. 微信模块注册:UseSenparcWeixin(...) 回调内按顺序执行——
    • 微信缓存(必须放在配置开头):UseSenparcWeixinCacheCsRedis() 或 Memcached;
    • 账号注册:RegisterMpAccount(公众号)、RegisterWxOpenAccount(小程序,可注册多个,如 senparcWeixinSetting.Value.Items["第二个小程序"])、RegisterWorkAccount(企业微信,可多个)、RegisterTenpayOld(支付 V2)、RegisterTenpayV3 / RegisterTenpayApiV3(支付 V3)、RegisterOpenComponent(第三方开放平台,含 getComponentVerifyTicketFunc、getAuthorizerRefreshTokenFunc、authorizerTokenRefreshedFunc 三个委托);
    • 在任意位置仍可用 AccessTokenContainer.Register(...)、ComponentContainer.Register() 等容器方法手动补充注册;
  5. MessageHandler 中间件(推荐):
    • app.UseMessageHandlerForMp("/WeixinAsync", CustomMessageHandler.GenerateMessageHandler, options => ...) 承载公众号消息;
    • app.UseMessageHandlerForWxOpen("/WxOpenAsync", ...) 承载小程序消息;
    • app.UseMessageHandlerForWork("/WorkAsync", ...) 承载企业微信消息;
    • 中间件支持多账号,可通过 options.AccountSettingFunc = context => ... 根据请求参数动态返回对应 SenparcWeixinSetting;
    • options.TextResponseLimitOptions = new TextResponseLimitOptions(2048, WeixinAppId) 可设置最大文本长度,超长后自动调用客服接口分批回复;
  6. 启用 AI 与路由:registerService.UseSenparcAI() 之后,UseEndpoints 中映射 SenparcHub(SignalR)与默认 MVC 路由。

五、配置文件详解:appsettings.json 三大区块

appsettings.json 是运行本项目唯一需要按自己账号修改的文件,分为三大区块。

5.1 SenparcSetting(CO2NET 全局配置)

"SenparcSetting": {
  "IsDebug": true,
  "DefaultCacheNamespace": "DefaultCache",
  "Cache_Redis_Configuration": "#{Cache_Redis_Configuration}#",
  "Cache_Memcached_Configuration": "#{Cache_Memcached_Configuration}#",
  "SenparcUnionAgentKey": "#{SenparcUnionAgentKey}#"
}

注意:配置文件中 #{...#} 为 Azure DevOps 默认占位符格式,使用明文信息时必须删除两侧的 # 与 {}(如 "Token": "MyFullToken")。Cache_Redis_Configuration 支持带密码与参数的完整连接串,例如 localhost:6379,password=senparc,connectTimeout=1000,connectRetry=2,syncTimeout=10000,defaultDatabase=3。

5.2 SenparcWeixinSetting(微信账号配置)

"SenparcWeixinSetting": {
  "IsDebug": true,
  "Token": "#{Token}#",
  "EncodingAESKey": "#{EncodingAESKey}#",
  "WeixinAppId": "#{WeixinAppId}#",
  "WeixinAppSecret": "#{WeixinAppSecret}#",
  "WxOpenAppId": "#{WxOpenAppId}#",
  "WxOpenAppSecret": "#{WxOpenAppSecret}#",
  "WxOpenToken": "#{WxOpenToken}#",
  "WxOpenEncodingAESKey": "#{WxOpenEncodingAESKey}#",
  "WeixinCorpId": "#{WeixinCorpId}#",
  "WeixinCorpAgentId": "#{WeixinCorpAgentId}#",
  "WeixinCorpSecret": "#{WeixinCorpSecret}#",
  "WeixinCorpToken": "#{WeixinCorpToken}#",
  "WeixinCorpEncodingAESKey": "#{WeixinCorpEncodingAESKey}#",
  "WeixinPay_PartnerId": "#{WeixinPay_PartnerId}#",
  "WeixinPay_Key": "#{WeixinPay_Key}#",
  "WeixinPay_AppId": "#{WeixinPay_AppId}#",
  "WeixinPay_AppKey": "#{WeixinPay_AppKey}#",
  "WeixinPay_TenpayNotify": "#{WeixinPay_TenpayNotify}#",
  "TenPayV3_AppId": "#{TenPayV3_AppId}#",
  "TenPayV3_AppSecret": "#{TenPayV3_AppSecret}#",
  "TenPayV3_SubAppId": "#{TenPayV3_SubAppId}#",
  "TenPayV3_SubAppSecret": "#{TenPayV3_SubAppSecret}#",
  "TenPayV3_MchId": "#{TenPayV3_MchId}#",
  "TenPayV3_SubMchId": "#{TenPayV3_SubMchId}#",
  "TenPayV3_Key": "#{TenPayV3_Key}#",
  "TenPayV3_CertPath": "#{TenPayV3_CertPath}#",
  "TenPayV3_CertSecret": "#{TenPayV3_CertSecret}#",
  "TenPayV3_TenpayNotify": "#{TenPayV3_TenpayNotify}#",
  "TenPayV3_PrivateKey": "#{TenPayV3_PrivateKey}#",
  "TenPayV3_SerialNumber": "#{TenPayV3_SerialNumber}#",
  "TenPayV3_ApiV3Key": "#{TenPayV3_APIv3Key}#",
  "TenPayV3_WxOpenTenpayNotify": "#{TenPayV3_WxOpenTenpayNotify}#",
  "EncryptionType": "#{EncryptionType}#",
  "Component_Appid": "#{Component_Appid}#",
  "Component_Secret": "#{Component_Secret}#",
  "Component_Token": "#{Component_Token}#",
  "Component_EncodingAESKey": "#{Component_EncodingAESKey}#",
  "AgentUrl": "#{AgentUrl}#",
  "AgentToken": "#{AgentToken}#",
  "SenparcWechatAgentKey": "#{SenparcWechatAgentKey}#",
  "Items": { "第二个公众号": { ... }, "第二个小程序": { ... }, "企业微信审批": { ... } }
}

关键说明:

  • 不要修改 key,否则无法被自动识别;不使用的参数可以删除,但不能留空字符串(所有字符串值都可能被用于字典索引);
  • TenPayV3_CertPath 支持物理路径(如 D:\\cert\\apiclient_cert.p12)或相对路径(如 ~/App_Data/cert/apiclient_cert.p12,必须放在 App_Data 等受保护目录下);证书私钥 TenPayV3_PrivateKey 支持明文私钥(无换行字符)或私钥文件路径;
  • EncryptionType 根据后台申请证书类型填写 RSA 或 SM(大部分情况为 RSA);
  • 不设置 TenPayV3_WxOpenTenpayNotify 时,默认在 TenPayV3_TenpayNotify 值末尾追加 WxOpen;
  • Items 节点下可以任意组合多套公众号、小程序、企业微信、微信支付(V2/V3)、开放平台信息,key 不能重复,例如 "第四个公众号+对应小程序+对应微信支付" 这类复合账号。

5.3 SenparcAiSetting(AI 平台配置)

"SenparcAiSetting": {
  "IsDebug": true,
  "AiPlatform": "AzureOpenAI",
  "NeuCharAIKeys": {
    "ApiKey": "<Your ApiKey>",
    "NeuCharEndpoint": "https://www.neuchar.com/<DeveloperId>",
    "ModelName": { "Chat": "gpt-35-turbo" }
  },
  "AzureOpenAIKeys": {
    "ApiKey": "<Your AzureApiKey>",
    "AzureEndpoint": "<Your AzureEndPoint>",
    "AzureOpenAIApiVersion": "2022-12-01",
    "ModelName": { "Chat": "gpt-35-turbo" }
  },
  "OpenAIKeys": {
    "ApiKey": "<Your OpenAIKey>",
    "OrganizationId": "<Your OpenAIOrgId>",
    "ModelName": { "Chat": "gpt-35-turbo" }
  },
  "Items": {
    "AzureDalle3": {
      "AiPlatform": "AzureOpenAI",
      "AzureOpenAIKeys": {
        "ApiKey": "<My AzureOpenAI Keys>",
        "AzureEndpoint": "<My AzureOpenAI DallE3 Endpoint>",
        "AzureOpenAIApiVersion": "2022-12-01",
        "ModelName": { "TextToImage": "dall-e-3" }
      }
    }
  }
}

AiPlatform 需修改为实际平台对应的枚举值(本项目示例为 AzureOpenAI)。Items 下的 "AzureDallE3" 是专门用于文生图的独立模型配置,其 ModelName 使用 TextToImage 节点指定 dall-e-3,这一配置正是下方 AI 示例中图片生成能力的数据来源。

六、消息处理链路:Controller 与中间件两条路径

公众号消息回调存在两种接入方式,示例中都给出了完整演示:

方式一:传统 Controller 方式,见 WeixinController.cs:

  • Get 方法用 CheckSignature.Check(...) 验证签名后返回 echostr,用于微信后台"接口配置信息"的 URL 验证;
  • Post(异步)方法:校验签名 → 组装 PostModel(Token / EncodingAESKey / AppId)→ 实例化 CustomMessageHandler(可设置 maxRecordCount 控制上下文消息最大条数,默认 10)→ 设置 OmitRepeatedMessage(去重)与 DefaultMessageHandlerAsyncEvent.SelfSynicMethod → ExecuteAsync() 执行 → 返回 FixWeixinBugWeixinResult;
  • MiniPost 提供最简化的同步处理流程。

方式二:MessageHandler 中间件(推荐,无需创建独立 Controller):直接在 Startup.cs 中 app.UseMessageHandlerForMp("/WeixinAsync", CustomMessageHandler.GenerateMessageHandler, options => ...) 完成挂载,CustomMessageHandler 通过静态委托 GenerateMessageHandler 提供构造入口(见 CustomMessageHandler.cs)。

无论走哪条路径,核心逻辑都在 CustomMessageHandler(partial class,继承 MessageHandler<CustomMessageContext>)。其 OnTextRequestAsync 展示了 SDK 的关键字路由能力:StartHandler() 之后依次 .Keyword("AI", ...)、.Keyword("约束", ...)、.Keywords(new[]{"托管","代理"}, ...)、.SelectMenuKeyword("101", ...)、.Regex(@"^\d+#\d+$", ...)、.Default(async ...) 等链式匹配,命中即返回,未命中走兜底逻辑。值得注意的是,AI 对话被插入到整个关键字路由之前:

var aiResponseMessage = await this.AIChatAsync(requestMessage);
if (aiResponseMessage != null)
{
    return aiResponseMessage;
}

也就是说,AI 对话逻辑(AIChatAsync 返回非 null 即表示 AI 已介入)拥有最高优先级,随后才进入关键字路由与默认回复。

七、AI 示例深入:从启动到多模态与长对话记忆

readme 中说明:"目前 AI 示例已经集成到当前解决方案中",相关能力代码整合在 Senparc.Weixin.Sample.CommonService/AI 文件夹下,在解决方案的 Senparc.Weixin.Net8Sample.CommonService 项目中查看。该文件夹下只有两个文件:CustomMessageHandler_AI.cs(AI 对话的 partial 方法)与 ChatStore.cs(对话状态缓存),与 CustomMessageHandler.cs 通过 partial class 合并为一个类。

7.1 启动与状态机:ChatStore

用户在公众号发送关键字 AI 即触发 StartAIChatAsync():它基于 base.GetCurrentMessageContext() 获取当前用户上下文,创建新的 ChatStore 并序列化为 JSON 存入 currentMessageContext.StorageData(以字符格式提升兼容性),再通过 GlobalMessageContext.UpdateMessageContextAsync() 写入缓存——由于使用了 CurrentMessageContext,多用户之间完全隔离,对话不会串。随后返回欢迎语:

输入"p"暂停,可以暂时保留记忆
输入"e"退出,彻底删除记忆
输入"m"可以进入多模态对话模式(根据语义自动生成文字+图片)
输入"t"可以从多模态进入纯文本对话模式
输入"img 文字"可以强制生成图片,例如:img 一只猫
输入"dm"可以关闭Markdown格式输出,使用纯文本回复
输入"lc"可以开启长对话模式,开启后,对话每到达最大历史对话轮数(默认10轮)后,会自动整理对话记忆,并清空对话历史,以支持长对话

[结果由 AI 生成,仅供参考]

ChatStore.cs 定义了完整的对话状态机:

  • ChatStatus 枚举:None(默认/转换失败)、Chat(聊天中)、Paused(暂停);
  • MultimodelType 枚举:None、SimpleChat(纯文字)、ChatAndImage(多模态);
  • 会话字段:History(List<WeixinAiChatHistory>,每条含 Role 与 Content)、UseMarkdown(默认 true)、UseLongChat(默认 false)、LastStoredMemory(上一轮整理的记忆)、LastStoredPrompt(上一次提问);
  • 转换方法:GetChatHistory() / SetChatHistory() 负责在 WeixinAiChatHistory 与 Microsoft.Extensions.AI.ChatMessage(v3.1.0 起聊天历史已迁移到 Microsoft.Extensions.AI 消息模型)之间互转,另有 AddUserMessage / AddAssistantMessage / AddSystemMessage / AddToolMessage 与 ClearHistory()。

7.2 文字对话主流程:AIChatAsync

AIChatAsync(requestMessage) 是核心入口,其内部按以下优先级处理用户输入:

  1. e:请求 AI 发送告别语,storeHistory=false 且清除状态记录(UpdateMessageContextAsync(..., null));
  2. p:请求 AI 告别并提醒"输入 AI 可再次启动",状态置为 Paused;
  3. 暂停状态下输入 AI:恢复为 Chat 并重新发送欢迎语;其他输入直接返回 null(不介入);
  4. dm / md:切换 Markdown 输出开关(仅在对话/暂停状态下有效);
  5. lc:切换长对话模式开关;
  6. m / t:在 SimpleChat 状态下切到 ChatAndImage(多模态),或在 ChatAndImage 下切回纯文字;
  7. 多模态判断:ChatAndImage 状态下,调用 JudgeMultimodel() 让 AI 判断当前输入是否包含"生成/制作图片"的意图(few-shot 提示词引导输出 0/1,示例见 CustomMessageHandler_AI.cs),命中则在 prompt 前追加 img 前缀;
  8. 正式请求 AI:通过 SenparcMessageQueue(CO2NET 消息队列)异步执行,避免微信 5 秒响应超时——TextChatAsync 走文字问答,Regex.Match(prompt, GEN_IMAGE_PATTERN) 命中 img\s+(.+) 则走 GenerateImageAsync 文生图;同步返回 ResponseMessageNoResponse 空响应,最终结果通过客服消息接口(CustomApi.SendTextAsync)推送给用户。

7.3 文生图流程:GenerateImageAsync

GenerateImageAsync(imgPrompt, history) 的完整链路(源码):

  1. 先异步发送"图片生成中,通常需要 1 分钟左右"提示(避免公众号响应超时);
  2. 若存在历史记录,调用 GetGenerateImgagePromptAsync() 把对话历史与最新命令一并交给 AI,由 AI 优化出一条可供 DALL·E 3 使用的图片生成 Prompt(这是可选增强能力);
  3. 从 Senparc.AI.Config.SenparcAiSetting["AzureDallE3"] 读取文生图专用配置,ConfigImageModel("Jeffrey").BuildKernel() 后调用 ImageGenerationAsync(imgPrompt, 1024, 1024);
  4. 将图片字节或 URI 保存到 ~/App_Data/TempGenImg 下的临时 PNG 文件;
  5. 通过 MediaApi.UploadTemporaryMediaAsync 上传临时素材(超时 100 秒),再用 CustomApi.SendImageAsync 把图片推送给用户;
  6. 最后把"按要求生成图片"与"任务已完成"写回当前用户的 ChatStore(源码注释提示:实际使用中建议加同步锁)。

7.4 文本对话与历史裁剪:TextChatAsync

TextChatAsync(源码)演示了"微信上下文 ↔ AgentSession 历史"的打通方式:

  • 默认系统消息来自 Senparc.AI.DefaultSetting.DEFAULT_SYSTEM_MESSAGE,模型参数由 CreateAgentOptions() 统一封装(文字对话使用 MaxOutputTokens=2000, Temperature=0.3f, TopP=0.5f);
  • BuildKernelWithAgentSessionAsync() 创建 AgentSession,并通过 session.SetInMemoryChatHistory(chatStore.GetChatHistory()) 恢复历史;
  • 对话完成后 session.TryGetInMemoryChatHistory(...) 取出最新历史,经 TrimAgentHistory(history, maxUserMessages=10) 裁剪(按 User 消息条数上限 10 裁剪,保留最近的轮次)后写回 ChatStore;
  • 回复文本末尾附上 由 AI 模型生成,仅供科学研究:{modelName} 字样,通过客服消息发送。

7.5 长对话记忆整理:ConsolidateMemoryAsync

长对话模式(lc)下,TextChatAsync 会先调用 ConsolidateMemoryAsync():当历史中 Assistant 消息条数 ≥ 9 时(源码注释说明:因为 Senparc.AI 的消息最大条数处理逻辑略有出入,这里暂设为 9),用上一轮记忆(LastStoredMemory)或默认系统消息作为 SystemMessage,让 AI 按固定模板总结"用户主要需求/偏好习惯/关键信息/之前聊天内容",再拼接上"用户最近一次提问的内容",存为新的 LastStoredMemory 并 ClearHistory() 清空历史——实现"每满一轮自动整理记忆、清空历史以支持超长对话"的效果;若尚未达到阈值,则直接返回 LastStoredMemory(可能为 null,此时回退到默认系统消息)。

7.6 体验方式

readme 提到可以关注"盛派网络小助手"公众号并输入关键字 AI 来体验公众号 AI 机器人能力(示例图片存放于 Senparc.Weixin.Sample.Shared/wwwroot/images 目录下)。在你自己的环境中运行本项目并配置好 SenparcAiSetting 后,同样可以对任一已注册公众号发送 AI 复现上述全部交互。

八、AI 示例之外的更多演示能力

除 AI 外,该综合示例还覆盖了多项值得直接复用的演示,分散在 Tools 控制器 与各模块控制器中:

  • WebSocket:SenparcHub(SignalR)配合 Senparc.WebSocket 与 CustomNetCoreWebSocketMessageHandler,支持服务端主动推送;
  • 消息去重与容错:OmitRepeatedMessage 默认开启,容错 关键字故意延时验证微信重试机制(base.OmitRepeatedMessageFunc 可自定义例外,见 CustomMessageHandler.cs);
  • 超长文本回复:超长 关键字配合 TextResponseLimitOptions 演示超长内容自动分批通过客服接口发送;
  • 多账号注册:MultiAccountTest 演示从 Items 读取多套配置并发刷新 AccessToken;
  • 文档与二维码工具:AiDocController、DocumentController(配合 App_Data/Document/)、QrCodeController 等。

九、小结与学习路径

Senparc.Weixin.Sample.Net8 的价值不在于"能跑通某个接口",而在于它是一张完整的微信全平台集成地图:从 Program.cs/Startup.cs 的装配顺序,到 appsettings.json 的三层配置,再到 CustomMessageHandler 的关键字路由与 AI 接入点,每个环节都有源码可循。建议的学习路径是:

  1. 先阅读本文涉及的 readme.md 与 appsettings.json,明确模块边界与配置项;
  2. 通读 Startup.cs 的注册顺序,理解"缓存→账号→支付→开放平台→中间件"的依赖关系;
  3. 对照 CustomMessageHandler.cs 与 CustomMessageHandler_AI.cs 学习消息处理与 AI 集成;
  4. 若只关注单一平台,可切换到 Samples 下的独立示例(MP、TenPayV2/V3、Work、WxOpen、Open 等)做减法学习。
登录后查看全文
WeiXinMPSDK