WeiXinMPSDK 综合示例实战指南:基于 Senparc.Weixin.Sample.Net8 的全平台微信模块集成与 AI 对话能力
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 是理解"如何把全部微信模块装进一个站点"的关键文件,其装配顺序如下:
- 基础服务:
AddSession()、AddControllersWithViews().AddNewtonsoftJson()、AddMemoryCache()(本地缓存必须)、AddSignalR()(WebSocket 演示); - SDK 注册(必须):
services.AddSenparcWeixin(Configuration, Env),随后按需追加AddSenparcWebSocket<CustomNetCoreWebSocketMessageHandler>()(WebSocket 能力)与AddSenparcAI(Configuration)(AI 能力); - 全局初始化(必须):
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 分钟);
- 分布式缓存:通过
- 微信模块注册:
UseSenparcWeixin(...)回调内按顺序执行——- 微信缓存(必须放在配置开头):
UseSenparcWeixinCacheCsRedis()或 Memcached; - 账号注册:
RegisterMpAccount(公众号)、RegisterWxOpenAccount(小程序,可注册多个,如senparcWeixinSetting.Value.Items["第二个小程序"])、RegisterWorkAccount(企业微信,可多个)、RegisterTenpayOld(支付 V2)、RegisterTenpayV3/RegisterTenpayApiV3(支付 V3)、RegisterOpenComponent(第三方开放平台,含getComponentVerifyTicketFunc、getAuthorizerRefreshTokenFunc、authorizerTokenRefreshedFunc三个委托); - 在任意位置仍可用
AccessTokenContainer.Register(...)、ComponentContainer.Register()等容器方法手动补充注册;
- 微信缓存(必须放在配置开头):
- MessageHandler 中间件(推荐):
app.UseMessageHandlerForMp("/WeixinAsync", CustomMessageHandler.GenerateMessageHandler, options => ...)承载公众号消息;app.UseMessageHandlerForWxOpen("/WxOpenAsync", ...)承载小程序消息;app.UseMessageHandlerForWork("/WorkAsync", ...)承载企业微信消息;- 中间件支持多账号,可通过
options.AccountSettingFunc = context => ...根据请求参数动态返回对应SenparcWeixinSetting; options.TextResponseLimitOptions = new TextResponseLimitOptions(2048, WeixinAppId)可设置最大文本长度,超长后自动调用客服接口分批回复;
- 启用 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) 是核心入口,其内部按以下优先级处理用户输入:
e:请求 AI 发送告别语,storeHistory=false且清除状态记录(UpdateMessageContextAsync(..., null));p:请求 AI 告别并提醒"输入 AI 可再次启动",状态置为Paused;- 暂停状态下输入
AI:恢复为Chat并重新发送欢迎语;其他输入直接返回 null(不介入); dm/md:切换 Markdown 输出开关(仅在对话/暂停状态下有效);lc:切换长对话模式开关;m/t:在SimpleChat状态下切到ChatAndImage(多模态),或在ChatAndImage下切回纯文字;- 多模态判断:
ChatAndImage状态下,调用JudgeMultimodel()让 AI 判断当前输入是否包含"生成/制作图片"的意图(few-shot 提示词引导输出 0/1,示例见 CustomMessageHandler_AI.cs),命中则在 prompt 前追加img前缀; - 正式请求 AI:通过
SenparcMessageQueue(CO2NET 消息队列)异步执行,避免微信 5 秒响应超时——TextChatAsync走文字问答,Regex.Match(prompt, GEN_IMAGE_PATTERN)命中img\s+(.+)则走GenerateImageAsync文生图;同步返回ResponseMessageNoResponse空响应,最终结果通过客服消息接口(CustomApi.SendTextAsync)推送给用户。
7.3 文生图流程:GenerateImageAsync
GenerateImageAsync(imgPrompt, history) 的完整链路(源码):
- 先异步发送"图片生成中,通常需要 1 分钟左右"提示(避免公众号响应超时);
- 若存在历史记录,调用
GetGenerateImgagePromptAsync()把对话历史与最新命令一并交给 AI,由 AI 优化出一条可供 DALL·E 3 使用的图片生成 Prompt(这是可选增强能力); - 从
Senparc.AI.Config.SenparcAiSetting["AzureDallE3"]读取文生图专用配置,ConfigImageModel("Jeffrey").BuildKernel()后调用ImageGenerationAsync(imgPrompt, 1024, 1024); - 将图片字节或 URI 保存到
~/App_Data/TempGenImg下的临时 PNG 文件; - 通过
MediaApi.UploadTemporaryMediaAsync上传临时素材(超时 100 秒),再用CustomApi.SendImageAsync把图片推送给用户; - 最后把"按要求生成图片"与"任务已完成"写回当前用户的
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 接入点,每个环节都有源码可循。建议的学习路径是:
- 先阅读本文涉及的 readme.md 与 appsettings.json,明确模块边界与配置项;
- 通读 Startup.cs 的注册顺序,理解"缓存→账号→支付→开放平台→中间件"的依赖关系;
- 对照 CustomMessageHandler.cs 与 CustomMessageHandler_AI.cs 学习消息处理与 AI 集成;
- 若只关注单一平台,可切换到 Samples 下的独立示例(MP、TenPayV2/V3、Work、WxOpen、Open 等)做减法学习。