名称： imap-smtp-email
描述： 通过 IMAP/SMTP 协议读取和发送邮件。支持检查新邮件/未读邮件、获取邮件内容、搜索邮箱、标记已读/未读，以及发送带附件的邮件。兼容 Gmail、Outlook、163.com、vip.163.com、126.com、vip.126.com、188.com、vip.188.com 等任何标准 IMAP/SMTP 服务器。
通过 IMAP 协议读取、搜索和管理邮件，通过 SMTP 协议发送邮件。支持 Gmail、Outlook、163.com、vip.163.com、126.com、vip.126.com、188.com、vip.188.com 等任何标准 IMAP/SMTP 服务器。
在技能文件夹中创建 .env 文件或设置环境变量：
# IMAP 配置（接收邮件）
IMAP_HOST=imap.gmail.com # 服务器主机名
IMAP_PORT=993 # 服务器端口
IMAP_USER=your@email.com
IMAP_PASS=your_password
IMAP_TLS=true # 使用 TLS/SSL 连接
IMAP_REJECT_UNAUTHORIZED=true # 对于自签名证书，可设置为 false
IMAP_MAILBOX=INBOX # 默认邮箱
# SMTP 配置（发送邮件）
SMTP_HOST=smtp.gmail.com # SMTP 服务器主机名
SMTP_PORT=587 # SMTP 端口（587 用于 STARTTLS，465 用于 SSL）
SMTP_SECURE=false # SSL 连接设为 true（端口 465），STARTTLS 设为 false（端口 587）
SMTP_USER=your@gmail.com # 你的邮箱地址
SMTP_PASS=your_password # 你的密码或应用专用密码
SMTP_FROM=your@gmail.com # 默认发件人邮箱（可选）
SMTP_REJECT_UNAUTHORIZED=true # 对于自签名证书，可设置为 false
| 服务商 | 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 邮箱 | imap.qq.com | 993 | smtp.qq.com | 587 |
163.com 重要提示：
- 请使用授权码，而非账户密码
- 需先在网页设置中启用 IMAP/SMTP 服务
检查新邮件或未读邮件。
node scripts/imap.js check [--limit 10] [--mailbox INBOX] [--recent 2h]
选项：
- --limit <n>: 最大返回结果数（默认：10）
- --mailbox <name>: 要检查的邮箱（默认：INBOX）
- --recent <time>: 仅显示最近 X 时间内的邮件（例如：30m、2h、7d）
根据 UID 获取完整的邮件内容。
node scripts/imap.js fetch <uid> [--mailbox INBOX]
下载邮件中的所有附件，或指定附件。
node scripts/imap.js download <uid> [--mailbox INBOX] [--dir <path>] [--file <filename>]
选项：
- --mailbox <name>: 邮箱（默认：INBOX）
- --dir <path>: 输出目录（默认：当前目录）
- --file <filename>: 仅下载指定附件（默认：下载全部）
使用筛选条件搜索邮件。
node scripts/imap.js search [options]
选项：
--unseen 仅未读邮件
--seen 仅已读邮件
--from <email> 发件人地址包含
--subject <text> 邮件主题包含
--recent <time> 最近 X 时间内的邮件（例如：30m、2h、7d）
--since <date> 指定日期之后（YYYY-MM-DD）
--before <date> 指定日期之前（YYYY-MM-DD）
--limit <n> 最大结果数（默认：20）
--mailbox <name> 要搜索的邮箱（默认：INBOX）
将邮件标记为已读或未读。
node scripts/imap.js mark-read <uid> [uid2 uid3...]
node scripts/imap.js mark-unread <uid> [uid2 uid3...]
列出所有可用的邮箱/文件夹。
node scripts/imap.js list-mailboxes
通过 SMTP 发送邮件。
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>: 覆盖默认发件人
示例：
# 简单文本邮件
node scripts/smtp.js send --to recipient@example.com --subject "你好" --body "世界"
# HTML 邮件
node scripts/smtp.js send --to recipient@example.com --subject "新闻稿" --html --body "<h1>欢迎</h1>"
# 带附件的邮件
node scripts/smtp.js send --to recipient@example.com --subject "报告" --body "请查收附件" --attach report.pdf
# 多个收件人
node scripts/smtp.js send --to "a@example.com,b@example.com" --cc "c@example.com" --subject "更新" --body "团队更新"
通过向自己发送测试邮件来检查 SMTP 连接。
node scripts/smtp.js test
npm install
.env 文件中（并将其加入 .gitignore）连接超时：
- 确认服务器正在运行且可访问
- 检查主机/端口配置
认证失败：
- 确认用户名正确（通常为完整邮箱地址）
- 检查密码是否正确
- 163.com：请使用授权码，而非账户密码
- Gmail：若启用了双重验证，请使用应用专用密码
TLS/SSL 错误：
- 确保 IMAP_TLS/SMTP_SECURE 设置与服务器要求匹配
- 对于自签名证书：将 IMAP_REJECT_UNAUTHORIZED 或 SMTP_REJECT_UNAUTHORIZED 设置为 false