Shipeng.Expand.Thirdparty
4.1.1
dotnet add package Shipeng.Expand.Thirdparty --version 4.1.1
NuGet\Install-Package Shipeng.Expand.Thirdparty -Version 4.1.1
<PackageReference Include="Shipeng.Expand.Thirdparty" Version="4.1.1" />
<PackageVersion Include="Shipeng.Expand.Thirdparty" Version="4.1.1" />
<PackageReference Include="Shipeng.Expand.Thirdparty" />
paket add Shipeng.Expand.Thirdparty --version 4.1.1
#r "nuget: Shipeng.Expand.Thirdparty, 4.1.1"
#:package Shipeng.Expand.Thirdparty@4.1.1
#addin nuget:?package=Shipeng.Expand.Thirdparty&version=4.1.1
#tool nuget:?package=Shipeng.Expand.Thirdparty&version=4.1.1
Shipeng.Expand.Thirdparty
Shipeng.Expand.Thirdparty 是第三方平台集成包,包含邮件、短信、微信、小程序订阅消息、企业微信/钉钉相关模型与辅助封装。它适合业务系统需要快速接入常见外部平台,但又不希望这些 SDK 留在核心 Foundation 包中的场景。
安装
dotnet add package Shipeng.Expand.Thirdparty
适用场景
- 发送邮件、验证码短信、通知短信。
- 接入微信小程序登录、手机号获取、订阅消息模板。
- 接入企业微信成员、消息或常量模型。
- 历史项目需要兼容钉钉相关模型或源码资源。
主要类型
Mail、MailAccount、MailModel、MailFile:邮件发送账号、正文和附件模型。Sms、SmsModel、SmsMessageModel:短信发送入口和参数模型。WeChat、WechatConstants:微信平台辅助入口和常量。Code2SessionParamter、Code2SessionResult:小程序登录 code 换 session 相关模型。GetPhoneNumberResult、PhoneInfo、Watermark:小程序手机号解密/返回模型。SubscribeMessageSendParamter、SubscribeMessageSendResult:订阅消息发送模型。QYMemberModel、UserInfo、Gender:企业微信成员相关模型。Ding*系列模型:钉钉相关兼容模型。
基本用法
using Shipeng.Foundation.Expand.Thirdparty;
var sms = new Sms();
// var result = sms.SendSmsByTencent(new SmsModel { ... });
var mail = new Mail();
// await mail.SendAsync(new MailModel { ... });
使用建议
- 第三方平台密钥必须放入密钥系统或环境变量,不要写入源码和 README。
- 短信和邮件发送建议加限流、重试、失败日志和幂等控制。
- 外部 SDK 失败时不要吞异常,业务侧至少记录平台返回码和 requestId。
- 钉钉源码资源目前以包资源方式保留,正式使用前应按项目需要确认启用范围。
API Reference / API 索引
nuget.org 当前只会直接渲染包的 README 和 Release Notes,不会把包内 docs/API_REFERENCE.md 自动显示成一个独立页面标签。完整公开 API 索引已经随 NuGet 包打入 docs/API_REFERENCE.md,也可以在源码仓库中查看。
如果你正在 NuGet 页面阅读本文,请优先看本 README 的“主要类型”和示例;下载包后可在包内容中打开 docs/API_REFERENCE.md 查看完整公开类型、方法、属性和构造函数签名。
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | 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. |
-
net10.0
- aliyun-net-sdk-core (>= 1.6.2)
- MailKit (>= 4.17.0)
- Mapster (>= 10.0.10)
- Newtonsoft.Json (>= 13.0.4)
- Senparc.Weixin.Work (>= 3.31.0)
- Shipeng.Foundation (>= 4.1.1)
- TencentCloudSDK.Sms (>= 3.0.1435)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
4.1.1 / 2026-06-30
English:
- Split the original monolithic foundation library into focused Shipeng.* NuGet packages so applications can reference only the capabilities they actually need.
- Added Shipeng.DatabaseMaintenance for SQL Server and MongoDB database maintenance. It supports non-destructive cleanup preview, SqlSugar entity scanning, MongoDB collection scanning from configuration or source declarations, keep lists, ignored prefixes, empty-scan protection, missing table preview, controlled SqlSugar CodeFirst table creation, SQL Server schema difference preview, safe missing-column creation, safe changed-column synchronization, explicit execution switches, and confirmation-code protected destructive/schema-changing execution.
- Improved Shipeng.Payment with a unified payment abstraction for WeChat, Alipay, UnionPay, Cloud QuickPass, bank gateways, and profit-sharing scenarios. WeChat Pay V3 remains the concrete built-in implementation; other channels expose stable provider contracts and explicit placeholders so applications can add real vendor SDK implementations without changing business code.
- Centralized common NuGet metadata in Directory.Build.props: target framework, version, authors, repository, license, README, XML documentation, warning policy, and release notes.
- Every package includes README.md, XML IntelliSense documentation, and docs/API_REFERENCE.md inside the generated nupkg.
- Updated README files to explain that nuget.org renders README and Release Notes directly but does not expose packaged docs/API_REFERENCE.md as a separate page tab.
- Release build validation: all projects build and pack successfully for net10.0 with 0 warnings and 0 errors.
中文:
- 将早期单体基础库拆分为职责更清晰的 Shipeng.* NuGet 包,业务项目可以按需引用认证、MongoDB、SqlSugar、EF Core、数据库索引、数据库维护、第三方集成、日志、映射、支付和混合分页能力。
- 新增 Shipeng.DatabaseMaintenance,用于 SQL Server 和 MongoDB 数据库维护。支持冗余表/集合预览清理、SqlSugar 实体扫描、MongoDB 配置集合扫描、源码集合声明扫描、保留名单、忽略前缀、空扫描保护、缺失表预览、受控 CodeFirst 自动建表、SQL Server 结构差异预览、缺失字段补齐、安全字段同步、显式执行开关和确认码保护。
- 增强 Shipeng.Payment,新增统一支付抽象,覆盖微信、支付宝、银联、云闪付、银行网关和分账场景。微信支付 V3 是当前内置可用实现;其他通道提供稳定 Provider 契约和明确占位实现,方便业务项目接入真实厂商 SDK。
- 将公共 NuGet 元数据统一集中到 Directory.Build.props,避免各项目 PropertyGroup 重复和不一致。
- 每个包都打入 README.md、XML IntelliSense 文档和 docs/API_REFERENCE.md。
- 所有 README 都补充说明:nuget.org 会直接显示 README 和 Release Notes,但不会把包内 docs/API_REFERENCE.md 自动显示为独立标签页。
- 已验证 Release 构建和打包,目标框架 net10.0,0 警告,0 错误。