nonebot-adapter-mail 1.0.0a5

Mail adapter for nonebot2

NoneBot-Adapter-Mail

✨ Mail Adapter ✨

配置

修改 .env 或 .env.* 文件以配置 Mail 适配器。

MAIL_BOTS

• id: 电子邮件地址
• name: 显示名称
• password: 登录密码
• subject: 默认邮件主题
• imap: IMAP 配置
  • host: IMAP 主机
  • port: IMAP 端口
  • tls: 是否使用 TLS
• smtp: SMTP 配置
  • host: SMTP 主机
  • port: SMTP 端口
  • tls: 是否使用 TLS

配置示例：

MAIL_BOTS='
[
  {
    "id": "[e-mail]",
    "name": "Name",
    "password": "p4ssw0rd",
    "subject": "Sent by NoneBot",
    "imap": {
      "host": "imap.example.com",
      "port": 993,
      "tls": true
    },
    "smtp": {
      "host": "smtp.example.com",
      "port": 465,
      "tls": true
    }
  }
]
'

适配器默认行为

• 邮件主题按以下优先级解析：
  1. 调用发送时传入的 subject 参数
  2. 消息中的 MessageSegment.subject 段
  3. 回复时使用 Re: 原邮件主题
  4. 使用配置中的默认 subject
• 发送函数可选参数：
  • cc: 抄送列表
  • bcc: 密送列表
  • subject: 邮件主题
  • in_reply_to: 所回复的邮件的 Message ID
  • references: 邮件线程中的邮件 Message ID 列表
  • reply_to: 接收方回复邮件时的默认地址列表
• 发送函数中未指定 references 但已指定 in_reply_to 时，references 默认设置为 in_reply_to
• 快捷发送函数 bot.send 的 reply=True 时的配置：
  • subject 未指定时使用 Re: 原邮件主题
  • in_reply_to 未指定时使用原邮件的 Message ID
  • references 未指定时使用原邮件的 Message ID
• 消息中含有多个 MessageSegment.subject 或 MessageSegment.reply 时，只取第一个