介绍
# IMAP/SMTP Email Tool
通过 IMAP 协议读取、搜索和管理邮件。通过 SMTP 发送邮件。支持 Gmail、Outlook、163.com、vip.163.com、126.com、vip.126.com、188.com、vip.188.com 以及任何标准 IMAP/SMTP 服务器。
## 配置
在技能文件夹中创建 `.env` 文件或设置环境变量：
```bash # IMAP Configuration (receiving email) IMAP_HOST=imap.gmail.com # Server hostname IMAP_PORT=993 # Server port [email protected] IMAP_PASS=your_password IMAP_TLS=true # Use TLS/SSL connection IMAP_REJECT_UNAUTHORIZED=true # Set to false for self-signed certs IMAP_MAILBOX=INBOX # Default mailbox
# SMTP Configuration (sending email) SMTP_HOST=smtp.gmail.com # SMTP server hostname SMTP_PORT=587 # SMTP port (587 for STARTTLS, 465 for SSL) SMTP_SECURE=false # true for SSL (465), false for STARTTLS (587) [email protected] # Your email address SMTP_PASS=your_password # Your password or app password [email protected] # Default sender email (optional) SMTP_REJECT_UNAUTHORIZED=true # Set to false for self-signed certs ```
## 常用邮件服务器
| 提供商 | IMAP 主机 | IMAP 端口 | SMTP 主机 | SMTP 端口 | |----------|-----------|-----------|-----------|-----------| | 163.com | imap.163.com | 993 | smtp.163.com | 465 | | vip.163.com | imap.vip.163.com | 993 | smtp.vip.163.com | 465 | | 126.com | imap.126.com | 993 | smtp.126.com | 465 | | vip.126.com | imap.vip.126.com | 993 | smtp.vip.126.com | 465 | | 188.com | imap.188.com | 993 | smtp.188.com | 465 | | vip.188.com | imap.vip.188.com | 993 | smtp.vip.188.com | 465 | | yeah.net | imap.yeah.net | 993 | smtp.yeah.net | 465 | | Gmail | imap.gmail.com | 993 | smtp.gmail.com | 587 | | Outlook | outlook.office365.com | 993 | smtp.office365.com | 587 | | QQ Mail | imap.qq.com | 993 | smtp.qq.com | 587 |
**关于 163.com 的重要提示：** - 使用 **授权码** (授权码)，而非账户密码 - 需先在网页设置中启用 IMAP/SMTP
## IMAP 命令（接收邮件）
### check 检查新邮件或未读邮件。
```bash node scripts/imap.js check [--limit 10] [--mailbox INBOX] [--recent 2h] ```
选项： - `--limit <n>`：最大结果数（默认：10） - `--mailbox <name>`：要检查的邮箱（默认：INBOX） - `--recent <time>`：仅显示最近 X 时间内的邮件（例如：30m, 2h, 7d）
### fetch 通过 UID 获取完整邮件内容。
```bash node scripts/imap.js fetch <uid> [--mailbox INBOX] ```
### download 下载一封邮件的所有附件或特定附件。
```bash node scripts/imap.js download <uid> [--mailbox INBOX] [--dir <path>] [--file <filename>] ```
选项： - `--mailbox <name>`：邮箱（默认：INBOX） - `--dir <path>`：输出目录（默认：当前目录） - `--file <filename>`：仅下载指定附件（默认：下载全部）
### search 使用筛选器搜索邮件。
```bash node scripts/imap.js search [options]
Options: --unseen Only unread messages --seen Only read messages --from <email> From address contains --subject <text> Subject contains --recent <time> From last X time (e.g., 30m, 2h, 7d) --since <date> After date (YYYY-MM-DD) --before <date> Before date (YYYY-MM-DD) --limit <n> Max results (default: 20) --mailbox <name> Mailbox to search (default: INBOX) ```
### mark-read / mark-unread 将邮件标记为已读或未读。
```bash node scripts/imap.js mark-read <uid> [uid2 uid3...] node scripts/imap.js mark-unread <uid> [uid2 uid3...] ```
### list-mailboxes 列出所有可用的邮箱/文件夹。
```bash node scripts/imap.js list-mailboxes ```
## SMTP 命令（发送邮件）
### send 通过 SMTP 发送邮件。
```bash node scripts/smtp.js send --to <email> --subject <text> [options] ```
**必需：** - `--to <email>`：收件人（多个收件人用逗号分隔） - `--subject <text>`：邮件主题，或 `--subject-file <file>`
**可选：** - `--body <text>`：纯文本正文 - `--html`：将正文作为 HTML 发送 - `--body-file <file>`：从文件读取正文 - `--html-file <file>`：从文件读取 HTML - `--cc <email>`：抄送收件人 - `--bcc <email>`：密送收件人 - `--attach <file>`：附件（逗号分隔） - `--from <email>`：覆盖默认发件人
**示例：** ```bash # Simple text email node scripts/smtp.js send --to [email protected] --subject "Hello" --body "World"
# HTML email node scripts/smtp.js send --to [email protected] --subject "Newsletter" --html --body "<h1>Welcome</h1>"
# Email with attachment node scripts/smtp.js send --to [email protected] --subject "Report" --body "Please find attached" --attach report.pdf
# Multiple recipients node scripts/smtp.js send --to "[email protected],[email protected]" --cc "[email protected]" --subject "Update" --body "Team update" ```
### test 通过向自己发送测试邮件来测试 SMTP 连接。
```bash node scripts/smtp.js test ```
## 依赖项
```bash npm install ```
## 安全说明
- 将凭据存储在 `.env` 中（添加到 `.gitignore`） - 对于 Gmail：如果启用了双重验证 (2FA)，请使用应用专用密码 - 对于 163.com：使用授权码 (授权码)，而非账户密码
## 故障排除
**连接超时：** - 验证服务器是否正在运行且可访问 - 检查主机/端口配置
**身份验证失败：** - 验证用户名（通常是完整电子邮件地址） - 检查密码是否正确 - 对于 163.com：使用授权码，而非账户密码 - 对于 Gmail：如果启用了双重验证，请使用应用专用密码
**TLS/SSL 错误：** - 将 `IMAP_TLS`/`SMTP_SECURE` 设置与服务器要求匹配 - 对于自签名证书：设置 `IMAP_REJECT_UNAUTHORIZED=false` 或 `SMTP_REJECT_UNAUTHORIZED=false`