跳转到内容

XiHan.Framework.Bot.Email

邮件通道:MailKit 集成

  • NuGetXiHan.Framework.Bot.Email
  • 模块类XiHanBotEmailModule
  • 所在层:基础设施层

这是什么

这个包为 XiHan.Framework.Bot 提供邮件发送通道,基于 MailKit 实现 SMTP 发信。它把邮件封装成一个标准的 IBotProvider,接入统一的 Bot 调度体系——你依旧通过 IBotClient 发消息,本包负责把消息投递为邮件。

何时使用

  • 需要通过 SMTP 发送通知邮件(支持 HTML 正文、抄送 / 密送)
  • 想让邮件与短信、IM 等其它通道走同一套发送策略与管道

安装

bash
dotnet add package XiHan.Framework.Bot.Email

启用

csharp
[DependsOn(typeof(XiHanBotEmailModule))]
public class MyModule : XiHanModule { }

模块依赖 XiHanBotModule。在 BotBuilder 上调用 UseEmail(configure) 注册邮件提供者,并绑定 EmailOptions(发件人、默认收件人 / 抄送 / 密送、是否 HTML 正文)。SMTP 连接配置由 IEmailConfigStore 提供,默认实现为 DefaultEmailConfigStore,应用层可覆盖为数据库来源。

核心能力

  • SMTP 发信EmailBotProvider 实现 IBotProvider,经 EmailBot 用 MailKit 发送邮件
  • 可插拔连接配置IEmailConfigStore 抽象 SMTP 连接来源,默认 DefaultEmailConfigStore,应用层可换 store 化实现
  • 发信选项EmailOptions 支持发件人、默认收件人 / 抄送 / 密送、HTML 正文开关

主要类型

类型说明
EmailBotProvider邮件通道提供者(IBotProvider 实现)
EmailBot基于 MailKit 的 SMTP 发信封装
IEmailConfigStore / DefaultEmailConfigStore邮件连接配置来源抽象与默认实现
EmailOptions邮件提供者配置(发件人 / 收件人 / 正文格式)

依赖模块

相关模块

Released under The MIT License.