Mud.Wechat.MiniProgram 1.0.0

dotnet add package Mud.Wechat.MiniProgram --version 1.0.0
                    
NuGet\Install-Package Mud.Wechat.MiniProgram -Version 1.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Mud.Wechat.MiniProgram" Version="1.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Mud.Wechat.MiniProgram" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Mud.Wechat.MiniProgram" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Mud.Wechat.MiniProgram --version 1.0.0
                    
#r "nuget: Mud.Wechat.MiniProgram, 1.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Mud.Wechat.MiniProgram@1.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Mud.Wechat.MiniProgram&version=1.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Mud.Wechat.MiniProgram&version=1.0.0
                    
Install as a Cake Tool

Mud.Wechat.MiniProgram

微信小程序 SDK 主包:46 个业务域 587 端点(登录与身份 / 二维码与链接 / 内容安全 / 数据分析 / 订阅消息 / 动态消息 / 客服 / 硬件设备 / 运维中心 / 插件 / 付费 / 附近小程序 / 搜一搜 / 生物认证 / 服务市场 / 红包封面 / 学生身份 / 人脸核身 / 用工关系 / 物流助手 / 会员服务 / 交易保障 / 直播 / 短剧媒资 / 虚拟支付 / 发货信息管理与品牌申请 / 小说作品管理 / 实名认证 / 小游戏 / 云开发 / 交易组件 V2(商店账号 / 商品 / 订单 / 售后 / 优惠券 / 资金 / 分享员)/ 基础交易工具 V1(商品目录 / SKU / 订单地址 / 优惠券与抢购 / 装修素材 / 资金)/ 米大师虚拟支付 / 城市服务 / 行业能力)的声明式 HTTP 客户端、模块注册器、AOT JsonContext 合并,以及小程序码 / 反馈图片(二进制流)与物流对账文件(文本)的手工通道。

小程序与公众号同属微信公众平台:同一令牌域、同一批路由前缀(/wxa/、/datacube/、/sns/),因此本线不重复实现令牌与多应用基座,直接复用 Mud.Wechat.OfficialAccount.Abstractions(守卫 MP-X2 锁定)。装配入口也因此是两段式的——先 AddMpApp 建底座,再 AddMiniProgramServices 装本线模块。

能力面(587 端点 = 581 特性路由 + 6 手工通道,计数与路由表由 MP-X5 锁定)

模块(MiniProgramModule) 注册方法 端点 接口
Auth AddAuthApi() 8 IWxaAuthService(8 端点:checksession / resetusersessionkey / getuserphonenumber / getpaidunionid / openpid / 检查加密信息 / encryptKey / sns/jscode2session(方法级 [Token(Disabled = true)] 免应用级令牌,A-7 合并);IWxaCode2SessionService 已 [Obsolete] 过渡保留一版)
QrCodeLink AddQrCodeLinkApi() 9 IWxaQrCodeLinkService(URL Link / Scheme / NFC Scheme / 短链 的生成与查询,6 端点走生成管线)+ IWxaCodeService(小程序码 3 端点走手工通道,见下)
Security AddSecurityApi() 3 IWxaSecurityService(msg_sec_check 同步文本 + media_check_async 异步媒体 + getuserriskrank)
DataAnalysis AddDataAnalysisApi() 11 IWxaDataAnalysisService(/datacube/getweanalysisappid*:日/周/月访问趋势与留存 + 页面访问 + 访问分布 + 用户画像 + 数据概况 + wxa/business/performance/boot)
SubscribeMessage AddSubscribeMessageApi() 4 IWxaSubscribeMessageService(发送订阅消息 + 用户通知开关 / 扩展)
DynamicMessage AddDynamicMessageApi() 3 IWxaDynamicMessageService(activityid/create + 动态消息发送 + 聊天工具动态卡片消息)
Kf AddKfApi() 11 IWxaKfService(客服角色 2 + 客服子商户 4 + 微信客服绑定 3 + 客服输入状态 1)+ IWxaKfMediaService(临时素材二进制手工通道 1;media/get 成功返回素材流、失败才是 JSON,视频素材特例返回含 video_url 的 JSON)
HardwareDevice AddHardwareDeviceApi() 9 IWxaHardwareDeviceService(设备消息发送 + getsnticket + 设备组 4 + License 3)
Operation AddOperationApi() 10 IWxaOperationService(9 端点:域名配置 / 性能·来源·客户端版本 / 实时与错误日志 / 反馈列表 / 灰度发布)+ IWxaFeedbackMediaService(反馈图片手工通道)
Plugin AddPluginApi() 2 IWxaPluginService(/wxa/devplugin、/wxa/plugin,action 驱动)
Charge AddChargeApi() 2 IWxaChargeService(资源包用量 + 最近平均用量)
NearbyPoi AddNearbyPoiApi() 4 IWxaNearbyPoiService(添加 / 删除地点 + 列表 + 展示状态)
Search AddSearchApi() 1 IWxaSearchService(wxaapi_submitpages 搜一搜数据推送)
Soter AddSoterApi() 1 IWxaSoterService(SOTER 生物认证秘钥签名验证)
ServiceMarket AddServiceMarketApi() 2 IWxaServiceMarketService(调用服务市场接口 + 异步取处理数据)
RedPacketCover AddRedPacketCoverApi() 1 IWxaRedPacketCoverService(ctoken 敏感,禁落日志)
Student AddStudentApi() 1 IWxaStudentService(快速获取学生身份)
FaceVerify AddFaceVerifyApi() 2 IWxaFaceVerifyService(获取 verifyid + 查询验证信息;cert_info 敏感)
LaborUse AddLaborUseApi() 2 IWxaLaborUseService(推送用工消息 + 解绑用工关系)
Express AddExpressApi() 83 IWxaExpressBusinessService(商家寄件 12)+ IWxaExpressDeliveryService(服务商 / 物流消息 / 退货 / 散单寄件 / 投诉处理 / 消息推送 28)+ IWxaExpressIntracityService(同城配送 16)+ IWxaExpressInsuranceFreightService(无忧退货 11)+ IWxaExpressLocalService(即时配送 15)+ IWxaExpressBillService(对账文件文本手工通道 1;single_waybill/get_bill 成功返回对账文件、失败才是 JSON ⇒ 按 Content-Type 分支判错)
Vip AddVipApi() 6 IWxaVipService(会员信息增改查删 4 + 会员列表 1 + 已关联小店列表 1;2026-10 核对为小程序令牌、自小店线设计方案 §4.1 结论 A 划入)
TransactionGuarantee AddTransactionGuaranteeApi() 16 IWxaTradeGuaranteeService(交易保障状态 + 违规处罚列表 2,权限集 30)+ IWxaTradeCommentService(评价管理 9:列表 / 详情 / 评论回复列表 3 查走 GET 且参数进 Query + 回复增删 / 评论增删 / 确认和解 / 重置 API 客服 quota 5 写,权限集 151)+ IWxaTradeComplaintService(投诉管理 5:详情 GET + 回应 / 补充凭证 / 退款凭证 / 申诉 4 写,权限集 76,路由前缀 /wxaapi/minishop/ 为历史遗留 ⇒ P3-R1 已按能力面收窄)
Live AddLiveApi() 38 IWxaLiveRoomService(直播间本体 11:创建 / 编辑 / 删除 3 + 推流地址与分享二维码 2 走 GET + getliveinfo + 橱窗与回放与客服与评论开关 4 + 导入商品 1,权限集 52)+ IWxaLiveAssistantService(小助手 4 + 主播副号 4,小助手不等于成员角色)+ IWxaLiveRoomGoodsService(房间内商品 7:删除 / 推送 / 上下架 / 排序 / 取讲解视频 + getkey 走 GET + setkey)+ IWxaLiveGoodsService(商品库 7:add / update / audit / resetaudit / delete + getapproved 走 GET + getgoodswarehouse)+ IWxaLiveRoleService(成员角色 3)+ IWxaLiveSubscribeService(长期订阅粉丝 1 + 群发 1)。四支查询端点走 /wxa/business/ 前缀(官方历史命名),其余 34 条走 /wxaapi/broadcast/
Vod AddVodApi() 32 IWxaVodUploadService(上传 6:单文件与分片两条通路 + 拉取上传 + gettask 轮询,权限集 153)+ IWxaVodMediaService(媒资 4:列表 / 详情 / 播放地址 / 删除)+ IWxaVodDramaService(剧目 8:提审 / 列表 / 详情 / 提交替换 / 替换 / 改基础信息 / 查最新审核信息 + 播放器推荐位开关)+ IWxaVodCdnService(CDN 与资源包 3:用量 / 日志 / 资源包列表)+ IWxaVodAuthorizationService(授权与版权 11:剧目与版权双向授权 6 + 三视角查询 + 应用授权 2)。路由 /wxa/sec/vod/(31)+ 播放器族 /wxadrama/setplayerdramarecmdswitch(1,本域唯一非 /wxa/sec/vod/ 前缀),32 条全小写连写;authorizedrama 是全域唯一一支 GET 且带 JSON 请求体(官方调用方式与示例如此,同页错误码 43002 与之矛盾 ⇒ 裁决留档由 DV2 锁定动词)
XPay AddXPayApi() 37 IWxaXPayCurrencyService(代币 4:currency_pay / cancel_currency_pay / present_currency / query_user_balance,其中扣减与退款扣减与查余额三支官方要求 pay_sig+signature 双签)+ IWxaXPayOrderService(订单 7:查单 / 退款 / 发货通知 / 下载单任务两支 + 账单与 iOS 月结账单下载)+ IWxaXPayGoodsService(道具 5:上传与发布各 start/query + upload_vp_file)+ IWxaXPaySubscribeService(会员订阅 4:预扣款 / 扣款 / 查签约 / 解约)+ IWxaXPayFundsService(资金与提现 10:转账账户绑定与查询 + 资金账单创建与查询 + 追缴账单 + 广告资金与广告资金下载 + 商户可提现余额 + 提现单创建与查询)+ IWxaXPayComplaintService(投诉与管控 7:列表 / 详情 / 协商历史 / 回应 / 完结 / 上传凭证签名 + query_punishment_reasons)。路由单一族 /xpay/,37 条全 POST 全小写下划线;注册委托在装载 HTTP 客户端之前先 XPaySensitiveQueryKeys.RegisterAll() 登记 pay_sig(守卫 XP6)
OrderShipping AddOrderShippingApi() 12 IWxaOrderShippingService(发货录入与报备 4:upload_shipping_info / upload_combined_shipping_info / notify_confirm_receive / opspecialorder)+ IWxaOrderQueryService(订单与管理状态查询 4:get_order / get_order_list / is_trade_managed / is_trade_management_confirmation_completed)+ IWxaOrderSettingService(设置 2:set_msg_jump_path / setwxatradetypecgi)+ IWxaFamousBrandService(品牌申请 2:apply / get_status,权限集 142)。两族前缀 /wxa/sec/order/(10)与 /wxa/sec/famousbrand/(2),12 条全 POST;本域无方法级 [Query] 业务凭据(对照 XPay 的 pay_sig),且官方 12 页均无端点级频率数字 ⇒ 只有规模限制(守卫 OS1~OS6)
Novel AddNovelApi() 23 IWxaNovelBookService(作品本体 6:创建 / 编辑 / 删除 / 列表 / 详情 / 审核)+ IWxaNovelChapterService(章节管理 8:上传 / 批量上传 / 删除 / 替换 / 列表 / 详情 / 重排序 / 更新 seq)+ IWxaNovelAuthService(授权管理 3:添加 / 查询 / 删除)+ IWxaNovelAccountAuthService(账号授权 3:按 appid 添加 / 查询 V2 / 删除)+ IWxaNovelReaderService(读者运营 3:设置预览配置 / 获取预览配置 / 设置推荐小说)。路由族 /wxa/book/*(20)+ /wxa/business/novelreader/*(3),23 条全 POST,权限集 169;本域零 /wxaapi/broadcast/* 路由(该族属 Live 域,NV1 负锁);官方本域无端点级频率数字 ⇒ 注释留档该空缺(守卫 NV1~NV5)
RealName AddRealNameApi() 1 IWxaRealNameService(/intp/realname/checkrealnameinfo 校验实名信息,权限集未明确、不支持第三方代调用、官方无端点级频率数字)
Game AddGameApi() 20 IWxaGameService 单接口(帧同步房间 4:createwxagameroom / getwxagameframe + 两支 access_info 定位的 GET)+ 用户数据存储 3(remove_user_storage / setuserinteractivedata / set_user_storage)+ 对局匹配规则 5(/wxa/business/gamematch/*)+ 米大师索要单 1(getpayfororder,官方页面标注已废弃但在册)+ 内容安全 2(/wxa/game/content_spam/*)+ 米大师 V2 游戏币 5(/wxa/game/{getbalance,pay,cancelpay,present,queryorderinfo})。出处为 minigame/dev/api-backend/ 独立文档树(2026-10-15 逐页浏览器取证);动词是 2 GET + 18 POST(五支「查询」端点官方一律 POST);路由三族 /wxa/ 直属 7 + /wxa/business/ 6 + /wxa/game/ 7,同族形态不成对(set_user_storage 带下划线、setuserinteractivedata 连写;setMatchIdOpenState→setmatchopenstate、pay_v2.queryOrder→queryorderinfo 英文名与路径不同形 ⇒ 照请求地址)。令牌面只有应用级 access_token(Query)一支:官方 20 页逐页写明不支持第三方平台调用(与 CloudBase 恰好相反)。第二重凭据 8 支:存储三支带 openid+signature+sig_method、pay_v2 五支带 signature+sig_method+pay_sig,全部是宿主计算的登录态/支付签名 ⇒ 落方法级 [Query] 而非 [Token];pay_sig 走 AddGameApi() 委托内复用 XPaySensitiveQueryKeys.RegisterAll() 登记(键集单一来源,守卫 GM6)。官方文档六处缺陷/矛盾(路径与英文名不同形、team_member_count 重复行、match_id 类型标 number、updateMatchRule 参数表疑复用、getGameFrame 请求体表重复行、getPayForOrder 废弃但在册)在接口 remarks 留档并由 GM4 锁定;端点级频率数字只有内容安全两支(文本 1 万/分钟・1000 万/天、建议超时 1s;图片 2 千/分钟・20 万/天、≤10M、建议超时 5s)(守卫 GM1~GM7)
CloudBase AddCloudBaseApi() 44 IWxaCloudBaseEnvService(环境与账号 8:开通云开发 + 环境创建 / 查询 / 转换 / 共享 + 腾讯云凭证 getqcloudtoken 与微信令牌权限 + 手机号绑定查询)+ IWxaCloudBaseDataService(数据库与云存储 16:库/集合/索引管理 + 记录增删改查 + 文件上传下载与存储桶面)+ IWxaCloudBaseScfService(云函数 9:创建 / 更新 / 删除 / 列表 / 配置 + 层与容器面)+ IWxaCloudBaseMiscService(其它能力 11:回调配置 / 短信任务 / 统计 / cloudID / 微信支付配置 / 开放数据)。/tcb/* 42 + /wxa/getopendata + /wxa/getvoipsign(后两支为清单路由错配的纠正),44 条全 POST;路由官方页面分布在两棵文档树(miniprogram/dev/server/API/cloudbase/* 与 doc/oplatform/openApi/cloudbase-common/* + cloudbase-batch/*)但同一套 /tcb/ 路由;权限集 49(/tcb/wxpaylist 与 /tcb/wxpayopenauth 为 49、102,/wxa/getopendata 为 18、49,/wxa/getvoipsign 为 18),44 端点全部支持第三方代商家调用(令牌仍走小程序 access_token);唯一端点级频率数字是 /tcb/getqcloudtoken 的 10 次每小时。敏感面:secretid/secretkey/token、codesecret、COS 直传 authorization/签名 headers、含环境变量的 config、用户开放数据明文 ⇒ 禁入日志与异常消息(守卫 TCB6/TCB7)。/componenttcb/*(仅 component_access_token)归开放平台线,本线零声明(守卫 CBZ1 九条下架/错配 + CBZ2 两线不交叉);另有两套线字段格式并存(微信侧 snake_case 与腾讯云透传侧 PascalCase,守卫 TCB5)
ShopAccount AddShopAccountApi() 16 交易组件 V2 商店账号域,七接口共用注册组:IWxaShopAccountService(账号与信息 4)+ IWxaShopAuditService(审核 4:品牌 / 类目 / 小程序证书 / 审核结果,返回成功 ≠ 生效)+ IWxaShopCategoryService(/shop/cat/get,官方页文件名拼作 cateogry)+ IWxaShopImageService(/shop/img/upload)+ IWxaShopPromoterService(推客列表)+ IWxaShopRegisterService(入驻准入 4:apply 与 apply_scene 同一官方页但请求体不同,各自建模)+ IWxaShopSceneService(场景校验)。路由族 /shop/account/*、/shop/audit/*、/shop/register/* 等(V2)
ShopFunds AddShopFundsApi() 9 交易组件 V2 资金域,三接口共用注册组:IWxaShopFundsAccountService(余额与银行账户 3)+ IWxaShopFundsFlowService(订单流水 3)+ IWxaShopFundsWithdrawService(提现 3)。路由族 /shop/funds/*(提现三支与扫码两支位于 ministore/wxafunds/ 分区)。个人金融信息:银行卡号 / 开户名 / 提现金额 / 结算流水禁入日志与异常消息
ShopSharer AddShopSharerApi() 8 IWxaShopSharerService(分享员绑定 / 解绑 / 列表 / 统计 / 分享模式等,路由族 /shop/sharer/*,全部 POST)。绑定与解绑为异步终态(终态由回调推送);set_share_mode 官方参数表写 sharer_mode、示例写 share_mode ⇒ 取示例键并由守卫负锁;切换模式 2 后停止全族统计、30 天冷却(1310005)
ShopSpu AddShopSpuApi() 9 IWxaShopSpuService(V2 商品:/shop/spu/add|del|get|get_list|update|update_without_audit 等,全部 POST)。与 V1 商品域(ProductCatalog / ProductSku 的 /product/*)是两代契约,不得互引类型或路由;审核类端点返回成功 ≠ 生效
ShopCoupon AddShopCouponApi() 11 交易组件 V2 优惠券域,两接口共用注册组:IWxaShopCouponService(商家券 8)+ IWxaShopUserCouponService(用户券 3)。路由族 /shop/coupon/*、/shop/user_coupon/*;券面额与门槛单位为分、discount_num 为折扣千分比;库存与状态由官方异步结算
ProductCatalog AddProductCatalogApi() 22 基础交易工具(原标准版交易组件 V1)商品域,八接口共用注册组:IWxaProductCatalogService(商品本体与分类 5)+ IWxaProductDeliveryService / IWxaProductFreightService(配送与运费 4)+ IWxaProductOfflineService / IWxaProductStoreService(线下与门店 3)+ IWxaProductRegisterService(售后与保障 3)+ IWxaProductServiceMarketService / IWxaProductShipMethodService(服务市场与物流方式等 7)。路由族 /product/*(官方 minishopopencomponent/API 分区),与 V2 /shop/* 两代不互引
ProductFunds AddProductFundsApi() 7 IWxaProductFundsService(V1 资金:结算账户 / 提现 / 流水,路由族 /product/funds/*)。金额单位分;结算账户与提现流水禁入日志与异常消息
ShopOrder AddShopOrderApi() 20 交易组件 V2 订单域,四接口共用注册组:IWxaShopOrderService(订单 8)+ IWxaShopDeliveryService(发货 3,含官方文件名拼作 recieve.html 而正文请求地址为 /shop/delivery/receive 的纠正)+ IWxaShopPayService(支付 6)+ IWxaShopWxPayService(微信支付进件 3)。状态机 10/11/20/21/30/100/181/200/250;fund_type = 1(二级商户单)才允许取支付参数
ProductSku AddProductSkuApi() 17 基础交易工具 V1 SKU 域,三接口共用注册组:IWxaProductSkuService(SKU 7)+ IWxaProductSpuService(SPU 8)+ IWxaProductStockService(库存 2)。路由族 /product/sku/*、/product/spu/*、/product/stock/*;market_price 必须严格大于 sale_price(9401055);库存全量覆盖幂等、增量更新不幂等
ShopAfterSale AddShopAfterSaleApi() 18 售后域,三接口共用注册组:IWxaShopAftersaleService(V1 售后 4:/shop/aftersale/*,out_aftersale_id + refund + 状态 0~19)+ IWxaShopComplaintService(交易纠纷 3:/shop/complaint/*,只读 + 补材料,官方未发布枚举值 ⇒ 只建模 int)+ IWxaEcAftersaleService(V2 售后 11:/shop/ecaftersale/*,aftersale_id + orderamt + 状态 1~25)。两代字段与枚举不得互抄;openid / 手机号 / 退货地址 / 运单号 / 退款 ID 禁入日志
ProductOrder AddProductOrderApi() 14 基础交易工具 V1 订单与地址域,两接口共用注册组:IWxaProductAddressService(地址 4)+ IWxaProductOrderService(订单 10)。路由族 /product/address/*、/product/order/*;状态值域与时间格式均与 V2 ShopOrder 不同;售后三支的 order_id 是售后单号(官方反直觉点);两页 URL 互换留档
ProductCoupon AddProductCouponApi() 10 基础交易工具 V1 优惠券与限时抢购域,两接口共用注册组:IWxaProductCouponService(优惠券 7)+ IWxaProductLimitedDiscountService(限时抢购 3)。路由族 /product/coupon/*、/product/limiteddiscount/*;读写两侧时间与枚举异型;官方两页 valid_type 冲突(create 1/2、update 0/1)留档
ProductMedia AddProductMediaApi() 10 基础交易工具 V1 装修与素材域,三接口共用注册组:IWxaProductDecorationService(装修服务 6,启停两段式:decoration_service 返回成功仅表示已下发确认,生效须轮询 check_status)+ IWxaProductImageService(图片上传 1:upload_type=0 multipart / =1 JSON 双形态)+ IWxaProductQrCodeService(管理二维码 3,图片为 base64)。/product/img/upload 双形态共路由按 1 条计
Midas AddMidasApi() 8 IWxaMidasService(小游戏米大师虚拟支付:正式环境 4 + 沙箱环境 4;路由族 /cgi-bin/midas/*、/cgi-bin/midas/sandbox/*)。只承载 HTTPS 调用面;sig 由调用方按 HMAC-SHA256 计算后透传,SDK 不代算、密钥与签名原文禁入日志;幂等依赖 bill_no
CityService AddCityServiceApi() 5 城市服务域,两接口共用注册组:IWxaCityServiceElderMedicalService(适老化医疗 2:getmedrealname 等)+ IWxaCityServiceBasicService(基础能力 3:getservicepath / sendchannelmsg / sendmsgdata)。路由族 /cityservice/*;人脸核身三端点不落地(官方无现行页)由零声明守卫锁定;open_id、医保授权码、密文姓名禁入日志
BusinessCapability AddBusinessCapabilityApi() 5 行业能力域,两接口共用注册组:IWxaBusinessRetailService(B2b 门店助手 3:batchcreateretail / getretailinfo / retailnotifybusiness)+ IWxaBusinessRuntimeService(WMPF 硬件框架 2:runtime/adddevice / runtime/pushappmsg)。B2b 族用小程序 access_token,WMPF adddevice 须用移动应用(LauncherAPP)令牌(官方原文,宿主保证);/wxa/business/applyliveinfo 归开放平台线、本线零声明;手机号 / 统一社会信用代码 / 法人姓名 / push_token 禁入日志

三个模块级方法之外还有 AddAllApis()、AddModules(params MiniProgramModule[]) 与 Build()(返回 IServiceCollection)。

用法

// 凭据与公众号共用同一配置节(AppId / AppSecret),令牌底座由公众号包提供
builder.Services.AddMpApp(builder.Configuration, "MpApps")
               .AddMiniProgramServices(b => b.AddAllApis());

// 换会话走 appid + js_code,**方法级 [Token(Disabled = true)] 免令牌**(A-7 合并后随 IWxaAuthService 承载;
// 声明接口级 [Token] 反而会把应用级令牌注入免令牌端点,语义错误)
var session = await auth.Code2SessionAsync(appId, appSecret, jsCode, ct);   // session_key 不入日志(MP-X7)
var trend   = await dataAnalysis.GetDailyVisitTrendAsync(request, ct);
using var code = await wxaCode.GetUnlimitedCodeAsync(request, ct);                  // 图片流,须释放

小程序线没有回调工程:消息与事件接收属公众号 XML 通道(Mud.Wechat.OfficialAccount.Callback),本线的 MiniProgramScaffoldContractGuards 锁定「无 Callback 程序集」这一形态,防止「顺手补一个」造成两条线各自解析同一信封。

小程序码的二进制通道(本包手写通道之一)

getwxacode / getwxacodeunlimit / createwxaqrcode 三端点成功时返回图片字节流、失败时才返回 JSON,无法进 [HttpClientApi] 生成管线(管线按 JSON 反序列化)。故:

  • 接口 IWxaCodeService(Interfaces/QrCodeLink/)+ 手写实现 WxaCodeService(QrCodeLink/,非 Internal/)。
  • 返回 WxaCodeResult : IDisposable(ContentType / FileName / Content / Response),调用方须释放(内部持有 HttpResponseMessage)。
  • 判错按 Content-Type 分支:命中 json 才解析 errcode,非零即抛 WxaException(errcode, errmsg, path);application/json 之外的响应一律当图片处理。
  • 三条路由以路径常量形式存在(不在 HTTP 特性上),因此 MP-X1 的路由重复校验须把它们单独并入参照集,否则会出现「反射口径失效 ⇒ 静默假绿」。

落位与形态约束

  • 平铺命名空间、无 IsAbstract 父接口(MP-X4):本线接口全部落 Mud.Wechat.MiniProgram,不复制企业微信线「父接口 / 子接口分面」形态——三模式差异在小程序侧不存在。
  • 字段名照官方原文(MP-X5):session_key / js_code / trace_id / page_url 等不得驼峰化。
  • [Token].Name 恒为 access_token(MP-X3),注入走 Query(微信公众平台契约)。
  • 即时配送返回体不是 errcode/errmsg(2026-10-12 逐页核验):/cgi-bin/express/local/* 全族官方用 resultcode/resultmsg 表达运力侧结果,故该族响应统一继承 WxaExpressLocalResponse(在 WxaResponse 之上补齐两字段),判错以 resultcode == 0 为准。另:该族官方字段名拼写在各页间不一致(下单页 insurancfee / 预下单页 insurancefee、下单页 couponfee / 预下单页 couponFee),照各页原文承载,勿跨页统一。
  • 直播域官方拼写在页间不一致(2026-10-13 逐页取证,照各页原文承载,勿跨页统一):房间定位键同域四形态 —— roomId(broadcast 写侧)、room_id(/wxa/business/ 侧与订阅群发)、roomid(getliveinfo 应答连写)、id(editroom / deleteroom / updatecomment);商品键 goodsId 写侧为 number、getapproved 应答为 string、getgoodswarehouse 应答为 snake_case 的 goods_id;路由侧同族大小写混排(getapproved 全小写 vs getVideo / deleteInRoom 驼峰)。另:addassistant 写入用 username 而 getassistantlist 应答用 alias,getkey 请求为 goodsKey 而应答为 vendorGoodsKey。
  • 短剧媒资域官方自相矛盾与同族异名(2026-10-13 逐页取证,照官方示例与页间原文承载,勿跨页统一):authorizedrama 参数表列被授权方为 authorized、同页示例为 authorized_appid ⇒ 采信示例(域内其余 12 处被授权方字段名一律 authorized_appid);到期键两侧不同源——剧目侧 authz_expire_time、版权侧 expire_time;两视角查询端点 getauthorizedobjects(过去式,应答含 authorizer_appid)与 getauthorizeobjects(原形,应答含 authorized_appid)官方并存不得归一,而「查已授权小程序列表」官方是 getauthorizeapps(无 authorized 形态);同名 drama_id 在授权写侧是数组、查询侧是单值;file_size 官方类型列为 string、data_interval 表列 string 而示例为数字(按示例取 number);task_info 与 result[] 内层的 errcode/errmsg 是任务级/逐剧目级结果码,外层 WxaResponse 兜不住 ⇒ 两类型各自承载。另:媒资审核状态与剧目审核状态取值集同为 0~4 但 2 的语义不同 ⇒ 两套常量类分立。
  • 短剧媒资敏感值:getcdnlogs 返回的日志含客户端 IP、getmedia / getmedialink 返回的 mp4_url / hls_url 是带签名的临时播放地址 ⇒ 与 permanent_code 同级别处置,禁止写入日志、遥测或异常消息。
  • 虚拟支付的 pay_sig / signature 不是令牌(MP-B4):两支都是宿主自行计算的支付签名(pay_sig 按官方 HMAC 口径、signature 为用户态签名),因此落方法级 [Query] 参数由调用方传入,不得做成 [Token] 声明([Token] 只会注入 access_token,语义错误且会污染令牌面)。域内令牌绑定仍是 Wechat.Mp.AccessToken + Query 注入(MP-X2/X3)。
  • pay_sig 必须靠登记而非词表:组件 SensitiveUrlRedactor 是精确匹配词表,sig / sign / signature 三支都覆盖不到 pay_sig ⇒ AddXPayApi() **与 AddGameApi()(米大师 V2 五支同用 pay_sig)**的注册委托都先 XPaySensitiveQueryKeys.RegisterAll() 再装载客户端(AGENTS §8「补词表 / 登记豁免」二选一取登记一支;两模块共用同一登记面,键集单一来源,不建第二张表);组件词表一旦收录 pay_sig,守卫 XP6 的自过期闸先红,须同批从 All 移除。
  • 只注册 Game 不注册 XPay 的宿主同样要有掩码:登记发生在模块注册委托内(不在 Build() 里无条件执行,副作用只随使用的模块发生)⇒ 若 Game 委托写成裸 s.AddGameWebApiHttpClient(),pay_sig 会随 ApiException.RequestUri 明文外泄。守卫 GM6 以「委托体文本(先登记后装载)+ 真实装配路径的运行期掩码」双向锁定:单靠运行期断言在 XP6 先跑的进程里会假绿。
  • 小游戏米大师 V2 的签名基串口径(GM3 相关,宿主侧最易错):signature = hex(hmac_sha256(session_key, post_body))、pay_sig = hex(hmac_sha256(app_key, uri + '&' + post_body)),其中 uri 必须舍去 ? 及之后部分、post_body 须与实际发出的请求体逐字节一致(补一个空格即 90010 / 90011);sig_method 官方唯一取值 hmac_sha256(是算法名而非凭据,脱敏时保留原文以利排障)。SDK 侧不计算、不缓存签名。
  • env 四档语义(2026-10-13 逐页取证,勿跨页统一):17 支只在沙箱做签名校验、13 支两档通用、submit_subscribe_pay_order 只接受生产档(传沙箱值报 -15011)、6 支正文根本没有 env 字段。四档由 XP3 以「两两不交叉 + 并集 = 37」锁定,且与 DTO 面机械耦合——6 支无 env 端点的请求体不得出现 Env 属性。
  • 错误码表三档:28 支共用域内 26849_0xx 码表、send_subscribe_pre_payment 与 submit_subscribe_pay_order 各有独立码表(前者 674690001/690000000/690000001,后者为米大师侧 -15001 ~ -15027 加 1001 ⇒ 判错不得套域内表)、7 支官方明写「此接口没有特殊错误码」。query_download_order 与 cancel_subscribe_contract 属最后一档而非共用档 ⇒ XP3 钉住。
  • 虚拟支付域官方拼写缺陷(照原文承载,「顺手修正」即与线上报文对不上):路由 bind_transfer_accout(少一个 n,XP1 反向钉住 bind_transfer_account 不得出现);协商操作类型取值 USER_COMFIRM_COMPLAINT(少 r)、MERCHANT_REFUSE_RERUND(少 f),常量名按正确语义命名、值照官方原文(XP5 锁定)。
  • 虚拟支付敏感值:代币余额、商户可提现余额、提现金额、账单/订单下载链接(url / bill_url / download_url)、cos_url(官方明示 30 分钟有效)、sign、pay_sig、signature、订单 token、投诉人 payer_phone / payer_openid ⇒ 与 permanent_code 同级处置,禁止写入日志、遥测或异常消息。
  • 发货域「录入侧 / 查询侧」字段名不同源(2026-10-13 逐页取证,照各页原文承载,勿跨页统一):定位订单的键在录入侧是 order_key(内含 mchid / out_trade_no / order_number_type / transaction_id),在查询侧是扁平的 merchant_id / sub_merchant_id / merchant_trade_no ⇒ 两套 DTO 分立、不得合并;发货时间顶层 upload_time 录入侧是字符串、查询侧记录内是 long? 时间戳;商品描述录入侧 item_desc、查询侧 goods_desc。两支 is_trade_* 共用同一请求体,但应答键一个 is_trade_managed、一个 completed。
  • 品牌申请的两支形态特例:apply 的包装键是首字母大写的 Application(官方原文如此,域内其余键全小写下划线);get_status 官方请求参数表零字段 ⇒ 无 [Body] 参数(OS3 锁定,补一个空请求体即与官方报文对不上)。
  • 发货域官方拼写缺陷(照原文承载,「顺手修正」即 404):交易类型变更申请的路由是 setwxatradetypecgi(连写且尾部带 cgi,OS1 反向钉住 set_wxa_trade_type 不得出现);特殊发货报备是 opspecialorder(连写);设置消息跳转路径的官方正文标题为 setMsgJumPpath(大小写错拼),路由仍照 set_msg_jump_path。
  • 发货录入端点全部非幂等(「一次机会」):upload_shipping_info / upload_combined_shipping_info / notify_confirm_receive / opspecialorder 官方语义为一次性上报,重复上报即报错 ⇒ 不得为「重试友好」而自动重试或吞重复码;本域官方 12 页均无端点级频率数字,只有规模限制(合单子单数、列表分页上限等)。
  • 发货域敏感值:openid、paid_amount(单位分)、contact.consignor_contact / receiver_contact(官方要求掩码传输,且明示最后 4 位数字不得打掩码)⇒ 与 permanent_code 同级处置,禁止写入日志、遥测或异常消息。本域无新增 Query 凭据(只有 access_token,已在组件词表内)⇒ 不动 SensitiveUrlKeys、不进 QT1 词表豁免。
  • SSRF 白名单零改动(MP-X8):沿用 api.weixin.qq.com,本线不得增删 AllowedBaseUrlDomains、不得自行调用 ConfigureAllowedDomains。

依赖

Mud.Wechat.Abstractions(叶层)+ Mud.Wechat.MiniProgram.Abstractions + Mud.Wechat.MiniProgram.DataModels + Mud.HttpUtils 3.0.9(.Attributes / .Generator 3.0.9,Generator 仅分析器)。跨线只允许一条边——Mud.Wechat.OfficialAccount.Abstractions(取令牌 / 多应用基座):禁止引用公众号主包 / DataModels / Callback(MP-X1 / MP-X5)。序列化上下文由 MiniProgramJsonResolverExtensions 合并进组件管线(47 个 Generated/*JsonContext,「登记进上下文」与「合并进数组」的一致性由 XP5 断言锁定)。

目标框架继承根 Directory.Build.props(netstandard2.0;net6.0;net8.0;net10.0、Version 1.2.0),可打包。

守卫

Tests/Mud.Wechat.MiniProgram.Tests/ContractGuards/:MiniProgramContractGuards(MP-X1/X2/X3/X5/X6/X7/X8/X9 契约类断言)、MiniProgramScaffoldContractGuards(形态类断言:令牌复用 / 无父接口 / 重叠路由 / 依赖隔离 / 无回调包)、MiniProgramP3RulingsContractGuards(P3 长尾四条裁决;minishop 与 broadcast 两条已按能力面收窄为清单式在册——前者店铺 / 商品管理面零声明、官方 2026-10-13 仍在小程序目录在册的投诉处理 5 条以白名单 + 清单断言锁定;后者于 2026-10-13 解除「直播不实现」裁决(依据:官方 38 页服务端 API 逐页在册,停止接入的是前端「直播插件」组件页),broadcast 前缀 34 条以六个接口文件豁免 + 清单等式锁定,白名单外文件命中前缀即红)、WxaVipContractGuards(MPV 系列:Vip 域 6 端点路由 / 令牌绑定 / 空请求体端点规则 / DTO 登记计数与 JSON 上下文)、WxaTransactionGuaranteeContractGuards(TG1~TG5:16 端点路由表与三个前缀 / GET-Query 与 POST-Body 形态(GET 端点零 [Body])/ 三接口共组 TransactionGuarantee 注册组与令牌绑定 / 41 DTO 上下文登记与命名空间清单 / 官方字段名与类型口径 + 两处共用 DTO 裁决)、WxaLiveContractGuards(LB1~LB5:38 端点路由表与两个前缀 + 同族大小写混排拼写锁 + 四支 /wxa/business/ 端点清单 + 错误拼写 broadcast/getgoodswarehouse 的反向钉住 / GET-Query 与 POST-Body 形态(7 GET 端点零 [Body],含 getkey 无业务参数)/ 六接口共组 Live 注册组与令牌绑定 + 六接口方法数之和与路由表一致自证 / 53 DTO 上下文登记与命名空间清单(六个枚举常量类放行)/ 官方字段名与类型口径 + 五处共用 DTO 裁决 + editroom 不得凭空补副号字段)、WxaVodContractGuards(DV1~DV5:32 端点路由表与 /wxa/sec/vod/ 族前缀(31)+ 播放器族 /wxadrama/setplayerdramarecmdswitch 例外(1) + 全小写连写与单复数(submitreplacedramamedias vs replacedramamedia)+ 两视角 getauthorizedobjects / getauthorizeobjects 并存 + 错误拼写 getauthorizedapps 的反向钉住 / 参数形态(全域零 [Query]、29 支单 [Body]、2 支 multipart、getauthorizeapps 零业务参数,且 GET+Body 只允许 authorizedrama 一支)/ 五接口共组 Vod 注册组与令牌绑定 + 逐接口方法数与总数自证 / 69 DTO 上下文登记与命名空间清单(21 个枚举常量类放行)+ 21 应答与端点返回类型一一对应 + 21 枚举取值集 / 官方字段名与类型口径 + 七处共用 DTO 裁决 + authorized→authorized_appid 改名裁决)、WxaXPayContractGuards(XP1~XP6:37 端点路由表与单一 /xpay/ 族前缀 + 全 POST 全小写下划线 + bind_transfer_accout 官方错拼的反向钉住 + 下载单两支与账单下载的三形态区分 / 令牌绑定与 XPay 共组注册组 + 逐接口方法数之和与路由表一致自证 + pay_sig 28 支与 signature 必传 3 支可选 2 支的参数面与 IsOptional 口径 / env 四档与错误码三档的「两两不交叉 + 并集 = 37」及 env 与 DTO Env 属性的机械耦合 / /xpay/ 路由仅在小程序线声明(跨线零声明,两支正对照防真空)/ 83 DTO 上下文登记与命名空间清单(5 枚举常量类放行)+ 27 应答与端点返回类型一一对应 + 主包合并数组与程序集上下文一一对应 + 官方字段名与类型口径与共用 DTO 裁决 + 两处官方错拼取值 / pay_sig 走登记不走词表的四道闸:自过期、词表交叉、孤儿键、真实装配路径下的运行期掩码功能断言)、WxaOrderShippingContractGuards(OS1~OS6:12 端点路由表与两个族前缀 /wxa/sec/order/(10)+ /wxa/sec/famousbrand/(2)+ 全 POST 全小写下划线 + setwxatradetypecgi / opspecialorder 官方连写的反向钉住(set_wxa_trade_type 不得出现)+ 两支发货录入端点不得合并 / 参数形态(11 支恰一个 [Body]、get_status 零 [Body] 零业务参数、全域零方法级 [Query]——本域无 pay_sig 类第二重凭据,故不进 QT1 词表豁免)/ 四接口共组 OrderShipping 注册组与令牌绑定 + 逐接口方法数 4/4/2/2 与路由表一致自证 / 官方字段名与类型口径(order_key 与 merchant_id 两套定位键分立、upload_time 两侧一 string 一 long?、item_desc vs goods_desc、Application 大写包装键、两支 is_trade_* 共用请求体而异名应答、合单顶层无发货三字段)+ 14 次逐行 JSON 名集锁定 + 敏感值抽样 / 30 DTO 上下文登记与命名空间清单(10 常量类放行)+ 十张官方取值表逐表锁定 + 5 应答与端点返回类型一一对应 + 7 支空回体直接用 WxaResponse + 主包合并数组与程序集上下文一一对应 / 开放面矩阵(云调用 7 支持 ⊍ 5 不支持、第三方 10 ⊍ 2 不支持、权限集 18+142)+ 错误码四档「两两不交 + 并集 = 12」+ 官方 12 页无频率数字的空缺留档 + setMsgJumPpath 错拼留档)、WxaCloudBaseContractGuards(TCB1~TCB7 + CBZ1/CBZ2:44 端点路由表与 /tcb/ 恰 42 支 + /wxa/getopendata / /wxa/getvoipsign 两支错配纠正 / 参数形态(4 支空体端点、[Query] 名集合 ⊆ {openid})/ 令牌绑定与四接口共组 CloudBase 注册组 / 98 DTO 上下文登记与命名空间清单 / 两套线字段格式并存(微信侧 snake_case 与腾讯云透传侧 PascalCase)+ 五支官方错拼钉住(getFuntionLink / getFuntionList / getFuntionConfig / getUploadFuntionConfig / getYploadSignature)/ 敏感值不入日志(判定要求真实调用形态并剥行内注释,防空跑与假红双向)与敏感 DTO 不重写 ToString / 九条零声明(裸发短信 2 + 压测 3 + 即将下架配置 2 + 清单错配 2)+ /componenttcb/ 归开放平台线的小程序侧零声明)、WxaGameContractGuards(GM1~GM7:20 端点路由表与三族前缀(/wxa/ 直属 7 + /wxa/business/ 6 + /wxa/game/ 7)+ 2 GET + 18 POST 的动词分布 + 同族形态不成对(set_user_storage 下划线 vs setuserinteractivedata 连写)+ 两支「英文名≠请求地址」的正向钉住与按英文名拼路径的反向钉住(setmatchidopenstate / queryorder 不得出现)/ 令牌绑定与 Game 注册组 + 接口级单 [Token](官方 20 页逐页写明不支持第三方代调用 ⇒ 不得声明第二支)+ 方法数与路由表一致自证 / 凭据参数面逐端点锁定:2 支 access_info、3 支 openid+signature+sig_method、5 支 signature+sig_method+pay_sig,其余 10 支零 [Query];三支清单两两不交且并集 == 「接口面上真的带 Query 的端点」全集,签名参数一律必填(IsOptional 为 false)/ 官方文档六处缺陷与三处共用类型裁决的留档面(用接口源码文本兜住注释丢失)+ 字段名与类型抽样(单数 key、match_id 取 string、need_room_service_info 纠正官方重复行、payfororder 全小写、b / dp_id 原文保留、set_user_storage 的 value 取 JsonElement? 而互动数据那支取 long?)/ 46 DTO 上下文登记与命名空间清单(本域无常量类 ⇒ 域内类型须全为 DTO)+ 主包合并数组与程序集上下文一一对应 / AddGameApi() 委托必须先 XPaySensitiveQueryKeys.RegisterAll() 再装载(委托体文本 + 运行期掩码双向锁定:纯运行期断言在 XP6 先跑的情况下会假绿)+ sig_method 保留原文(算法名非凭据)/ 20 条路由跨线零声明 + 敏感值不入日志(真实调用形态、剥行内注释,防空跑与假红双向))、MiniProgramNonContractRouteContractGuards(NC1~NC3:清单 D 桶 86 条的归属终判——25 条非契约在全仓 Src/ 零声明、35 条开放平台令牌面路由与 6 条线外路由(Donut / 公众号门店;原含「小游戏 20 条」,2026-10-15 P1-8 收口批解除该裁决并按取证落位本线 Game 域)在小程序线零声明;三档共用同一趟剥注释声明扫描并以已落位路由作正对照,判据与逐条证据见 .docs/MudWechat-小程序D桶归属终判留档-2026-10-13.md)。

2026-10-18 交易组件波次(224 条工作单)新增守卫:WxaShopV2ContractGuards(V2 /shop/* 五域 74 端点路由 / 17 支接口 / 注册组与令牌 / DTO 上下文计数 / 官方拼写负锁)、WxaProductV1ContractGuards(V1 /product/* 六域 74 端点 / 嵌套业务对象与端点信封的应答基类判定 / 路由字面量跨线扫描)、WxaShopFundsContractGuards、WxaProductFundsContractGuards、WxaShopSharerContractGuards(资金与分享员小域路由表 / 敏感字段不入日志 / DTO 登记)、WxaMidasCityServiceBusinessContractGuards(米大师 8 + 城市服务 5 + 行业能力 5:路由 / 令牌 / 注册组 / 字段名与类型 / 零声明四条非契约路由 + OpenPlatform 归属正对照)、WxaLeaguePromoterContractGuards 与 WxaLeagueShopContractGuards(/union/promoter/* 22 条与 /union/shop/* 10 条逐页 301 判非契约:零接口 / 零 DTO / 零注册组,继任面 /channels/ec/league/* 与 /channels/ec/promoter/* 归小店线)。合计增量 189 端点(398 → 587),零声明 14 条(联盟 32 + 城市服务人脸核身 3 + applyliveinfo 1,后两者另由跨线/零声明守卫覆盖)。


原 Mud.Wechat.MiniProgram.Abstractions 包面(2026-10 包合并并入本工程,命名空间不变)

微信小程序 SDK 抽象包:官方错误码常量与线级异常类型。体量刻意极小——小程序与公众号同属微信公众平台,令牌、多应用基座与配置面全部复用 Mud.Wechat.OfficialAccount.Abstractions,本包不重复实现任何一处。

内容

  • WxaErrorCodes——官方错误码常量 13 个(含 Success = 0)。字段名与数值照官方原文,判定器与本集合同源,避免「散落的魔法数字」。
  • WxaException : WechatApiException——小程序线统一异常(ErrorCode = 官方 errcode;构造期经基座剥离 Query 与 userinfo,不泄露令牌)。含静态入口 ThrowIfFailed<TResponse>(TResponse?, string? requestUri),约束 where TResponse : class, IWechatApiResponse ⇒ 与公众号 / 企业微信线共用同一叶层判错契约。

本包不提供配置类型:小程序应用凭据即公众号凭据(MpAppConfig:AppId / AppSecret / UseStableToken,默认节 MpApps、UseStableToken 默认 true)。新增「小程序专属配置面」会造成同一 AppId 两处注册、两套令牌缓存,属被否决形态。

为什么令牌不落在本包(关键裁决)

公众号侧 MpTokenManagerRegistry 是 internal sealed、按 MpTokenTypes.AccessToken 单槽键控。若小程序线新增一个令牌类型(如 Wechat.Wxa.AccessToken),注册表读不到该槽 ⇒ errcode 令牌恢复返回 null、静默空转且不抛异常——这是最危险的一类漂移(编译通过、运行期只表现为「令牌过期后不自愈」)。因此 MP-X2 把「复用令牌类型」锁成守卫,MP-X3 进一步锁死 [Token].Name 恒为官方 access_token。

同理,本线接口为平铺命名空间、无 IsAbstract 父接口(MP-X4):三模式(自建 / 第三方 / 代开发)差异在小程序侧不存在,父/子分面只会凭空造出一层无用抽象。

依赖

Mud.Wechat.Abstractions(叶层)+ Mud.Wechat.MiniProgram.DataModels + Mud.Wechat.OfficialAccount.Abstractions(跨线唯一允许的边)+ Mud.HttpUtils 3.0.9(.Generator 3.0.9 仅分析器,PrivateAssets=all)。

禁止引用公众号主包 / DataModels / Callback(MP-X1 / MP-X5 守卫锁定)。Mud.HttpUtils 与 .Generator 版本须全仓单一(通用守卫 G1,NU1605 视为错误)。

目标框架继承根 Directory.Build.props(netstandard2.0;net6.0;net8.0;net10.0、Version 1.0.3),可打包。

已踩陷阱

  • netstandard2.0 下无 IsExternalInit polyfill ⇒ 本线公共类型不用 init / record / with。
  • 免令牌端点(sns/jscode2session)不得声明 [Token]:生成器仍要求显式 TokenManage = nameof(IMpAppManager)(HTTPCLIENT018),但 [Token] 一旦声明就会把应用级令牌注入该请求,语义即错。

原 Mud.Wechat.MiniProgram.DataModels 包面(2026-10 包合并并入本工程,命名空间不变)

微信小程序 SDK 数据模型包(纯 DTO):官方接口出入参与 AOT 源生成序列化上下文,独立交付以便宿主不引入运行时依赖。

内容

  • 798 个标注 [HttpJsonSerializable(SerializerClassName = "<域段>")] 的类型,按域目录与接口域一一对应,命名空间恒为 Mud.Wechat.MiniProgram.DataModels.{域}(RequestModel/、ResponseModel/ 之类仅作组织,不入命名空间)。域清单:Auth 12 / Common 1 / DataAnalysis 17 / QrCodeLink 20 / Security 8 / SubscribeMessage 7 / DynamicMessage 6 / Kf 10 / HardwareDevice 14 / Operation 14 / Plugin 6 / Charge 4 / NearbyPoi 8 / Search 5 / Soter 2 / ServiceMarket 4 / RedPacketCover 3 / Student 2 / FaceVerify 5 / LaborUse 2 / Express 165 / Vip 11 / TransactionGuarantee 41 / Live 53 / Vod 69 / XPay 83 / OrderShipping 30 / Novel 50 / RealName 2 / Game 46 / CloudBase 98。

  • 统一响应基底 WxaResponse(根命名空间直属 ⇒ 归 Common 组)实现叶层判错契约 IWechatApiResponse(ErrorCode / ErrorMessage / IsSuccess),使 WxaException.ThrowIfFailed 与其余两条线共用单点判定。

  • 与公众号 MpResponse 同形但不共用(本仓既定形态,两条理由):① 硬边界——小程序线不得引用公众号 DataModels(只允许引用其 Abstractions 的令牌 / 多应用基座,MP-X1 / MP-X5 锁定);② JsonSerializerContext 按程序集生成,跨程序集复用 DTO 会让序列化元数据落错上下文。

  • 成功响应可能整体缺省 errcode(官方多页如此)⇒ ErrorCode 缺省即 0、IsSuccess 为真,不得把「字段缺失」判成失败。

  • 官方 DTO 按域落 DataModels/{域}/(2026-10 源码归类把原散在工程根的 DTO 域目录连同 Generated/ 收拢于此;只动目录、命名空间仍为 Mud.Wechat.MiniProgram.DataModels.{域}[.{子域}] 不变;该「目录 ⇔ 命名空间」双向不变式由 AB-G10 守卫锁定)。

  • DataModels/Generated/:47 个上下文文件(每域一个,含 AuthJsonContext / CommonJsonContext / DataAnalysisJsonContext / QrCodeLinkJsonContext / SecurityJsonContext / ExpressJsonContext / VipJsonContext / TransactionGuaranteeJsonContext / LiveJsonContext / VodJsonContext / XPayJsonContext / OrderShippingJsonContext / NovelJsonContext / RealNameJsonContext / GameJsonContext / CloudBaseJsonContext 等),由 scripts/GenerateJsonContext.ps1 生成,<auto-generated> 头、勿手改、须随 DTO 变更同批提交。

用法(JsonContext 生成流程)

新增 / 变更 DTO 后按序执行(脚本默认参数指向 Work 线,本线必须显式覆盖):

# 1) 补标注:SerializerClassName 取命名空间域段(根命名空间直属文件归 Common)
./scripts/AddHttpJsonSerializable.ps1 `
    -RootPath Src/MiniProgram/Mud.Wechat.MiniProgram/DataModels `
    -RootNamespace Mud.Wechat.MiniProgram.DataModels

# 2) 重生成上下文:按分组发射 DataModels/Generated/{组}JsonContext.g.cs
./scripts/GenerateJsonContext.ps1 `
    -TargetProject Src/MiniProgram/Mud.Wechat.MiniProgram/Mud.Wechat.MiniProgram.csproj `
    -OutputDir Src/MiniProgram/Mud.Wechat.MiniProgram/DataModels/Generated

# 3) AOT 严格门禁复测
dotnet build Src/MiniProgram/Mud.Wechat.MiniProgram -c Release -f net8.0 -p:AotStrictMode=true

宿主侧无需手工串联上下文:主包 MiniProgramJsonResolverExtensions 把 31 个上下文合并进组件序列化管线(仅 net8.0+;低 TFM 走反射 STJ,AOT 门禁只对 net8.0+ 生效)。上下文为 internal,经 InternalsVisibleTo 对主包、Abstractions 与测试工程直读。「DTO 已进上下文」不等于「上下文已进合并数组」——数组在主包、上下文在本包,跨包漏接时 JIT 靠反射兜住、门禁全绿,只有 Native AOT 首次调用才炸;该一致性由守卫 XP5 以「程序集内 *JsonContext 类型集 ⇔ 合并数组里的 XxxJsonContext.Default 集」双向等价锁定。

已踩陷阱

  • 字段名照官方原文,不得驼峰化(MP-X5 逐字段锁定,守卫点名的即 session_key / js_code / trace_id / page_url);其余如 begin_date / end_date / entrypage_pv / env_version / check_path 一律以 [JsonPropertyName] 显式对齐,官方 snake_case 的拼写不由我方「纠正」。

  • 小程序码三端点(getwxacode / getwxacodeunlimit / createwxaqrcode)成功响应是图片二进制,不进本包的 JSON 管线 ⇒ 只有其请求 DTO(WxaCodeRequests,4 个标注类型)在此登记,响应侧由主包 WxaCodeResult 承载。

  • netstandard2.0 下无 IsExternalInit polyfill ⇒ DTO 用可空 set,不用 init / record。

  • 虚拟支付域的三处「照官方、别纠正」(MP-B4,2026-10-13 逐页取证):① 协商操作类型的线格式值自带错拼 USER_COMFIRM_COMPLAINT(少 r)/ MERCHANT_REFUSE_RERUND(少 f),常量名按正确语义命名、值照原文;② 金额与时刻在官方两套表里类型不同源——query_user_balance 的余额是 number、query_biz_balance 的 amount 与提现单的 withdraw_amount 是 string、withdraw_success_timestamp 是 string(成功时刻可为空串),一律不得数值化「统一」;③ 缩写键照原文 sett_time / req_from / begin_ds / left_fee / cos_url,投诉人 openid 是全小写 payer_openid 而非 payer_open_id。另:6 支正文无 env 字段的端点,其请求 DTO 不得出现 Env 属性(XP3 把这一点做成机械耦合断言)。

  • 发货信息与品牌申请域的四处「照官方、别统一」(MP-B5,2026-10-13 逐页取证):① 订单定位键两侧分立——录入侧是嵌套的 order_key(mchid / out_trade_no / order_number_type / transaction_id),查询侧是扁平的 merchant_id / sub_merchant_id / merchant_trade_no,报备侧又只有 order_id,三套各承载各的 DTO;② 同名字段跨页异型——upload_time 在录入请求是 string、在查询记录是 long?,商品描述录入侧 item_desc、查询侧 goods_desc;③ 品牌申请的包装键是官方原文的首字母大写 Application(域内其余字段一律小写下划线),而 get_status 官方请求参数表零字段 ⇒ 无请求 DTO;④ 两支 is_trade_* 共用同一请求体(WxaOrderTradeManagedQueryRequest),但应答键分别是 is_managed 侧的 is_trade_managed 与 completed ⇒ 共用请求、不共用应答。另:Shipping/、Query/、Setting/、FamousBrand/ 四子目录仅作组织,命名空间恒为 ...DataModels.OrderShipping(OS5 逐类型锁定)。

依赖

Mud.Wechat.Abstractions(叶层,仅取 IWechatApiResponse)+ Mud.HttpUtils.Attributes 3.0.9(零依赖特性包)+ Mud.HttpUtils.Generator 3.0.9(仅分析器,PrivateAssets=all)。与 Mud.HttpUtils 主包版本须全仓单一(通用守卫 G1)。

目标框架继承根 Directory.Build.props(netstandard2.0;net6.0;net8.0;net10.0、Version 1.0.3),可打包;本包无 DI 入口、无令牌 / 客户端类型。

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 128 10/29/2026