# 通用 SMTP 邮件插件

这是一个兼容清云互联通知插件系统的通用 SMTP 邮件插件。

## 插件信息

- 插件 ID：`e`
- 插件类型：`email`
- 插件入口：`mode.email.e.provider:create_provider`
- 支持协议：SMTP SSL、STARTTLS、无加密 SMTP
- 支持认证：用户名/密码认证，也支持关闭认证用于内网 SMTP 中继

## 打包结构

上传到后台时，zip 内必须保持以下结构：

```text
e.zip
  e/
    __init__.py
    provider.py
    plugin.json
    README.md
```

## 常见配置

QQ 邮箱示例：

```text
SMTP 服务器：smtp.qq.com
SMTP 端口：465
加密方式：ssl
启用 SMTP 认证：开启
SMTP 用户名：你的 QQ 邮箱
SMTP 密码/授权码：QQ 邮箱授权码
发件邮箱：你的 QQ 邮箱
```

Gmail 示例：

```text
SMTP 服务器：smtp.gmail.com
SMTP 端口：587
加密方式：starttls
启用 SMTP 认证：开启
SMTP 用户名：你的 Gmail 邮箱
SMTP 密码/授权码：应用专用密码
发件邮箱：你的 Gmail 邮箱
```

自建内网 SMTP 中继示例：

```text
SMTP 服务器：mail.internal.local
SMTP 端口：25
加密方式：none
启用 SMTP 认证：关闭
发件邮箱：no-reply@example.com
```

## 安装方式

1. 将 `e` 目录压缩为 `e.zip`。
2. 进入后台 `系统 -> 通知插件`。
3. 点击 `上传插件`。
4. 预览插件信息后确认安装。
5. 点击该插件右侧 `配置`，填写 SMTP 信息。
6. 点击 `测试`，确认邮件能正常发送。
7. 启用该插件。

## 注意事项

- 不会在日志中输出 SMTP 密码和验证码。
- 如果使用公网邮箱，通常必须使用授权码而不是登录密码。
- 如果 `加密方式` 填写错误，测试发送会失败。
- `smtp_security` 只能填写：`ssl`、`starttls`、`none`。

