serejaris IMAP/SMTP 邮件工具
通过 IMAP 协议收取、搜索和管理邮件，通过 SMTP 协议发送邮件。支持 Gmail、Outlook、163.com、vip.163.com、126.com、vip.126.com、188.com、vip.188.com 以及任何标准 IMAP/SMTP 服务器。
配置
在 skill 文件夹中创建 .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 |
Gmail 注意事项：
- Gmail 不接受常规账号密码
- 你必须生成应用专用密码（App Password）：https://myaccount.google.com/apppasswords
- 将生成的 16 位应用专用密码用作
IMAP_PASS/SMTP_PASS - 需要开启 Google 账号的两步验证
163.com 注意事项：
- 使用授权码，而非账号密码
- 需先在网页端设置中开启 IMAP/SMTP 服务
IMAP 命令（收取邮件）
check
检查新邮件/未读邮件。
node scripts/imap.js check [--limit 10] [--mailbox INBOX] [--recent 2h]
选项：
--limit <n>：最大返回数量（默认：10）--mailbox <name>：要检查的邮箱文件夹（默认：INBOX）--recent <time>：仅显示最近一段时间内的邮件（如 30m、2h、7d）
fetch
根据 UID 获取邮件完整内容。
node scripts/imap.js fetch <uid> [--mailbox INBOX]
download
下载邮件的所有附件，或下载指定附件。
node scripts/imap.js download <uid> [--mailbox INBOX] [--dir <path>] [--file <filename>]
选项：
--mailbox <name>：邮箱文件夹（默认：INBOX）--dir <path>：输出目录（默认：当前目录）--file <filename>：仅下载指定附件（默认：下载全部）
search
按条件搜索邮件。
node scripts/imap.js search [options]
选项：
--unseen 仅未读邮件
--seen 仅已读邮件
--from <email> 发件人包含
--subject <text> 主题包含
--recent <time> 最近一段时间内（如 30m、2h、7d）
--since <date> 该日期之后（YYYY-MM-DD）
--before <date> 该日期之前（YYYY-MM-DD）
--limit <n> 最大结果数（默认：20）
--mailbox <name> 要搜索的邮箱文件夹（默认：INBOX）
mark-read / mark-unread
将邮件标记为已读或未读。
node scripts/imap.js mark-read <uid> [uid2 uid3...]
node scripts/imap.js mark-unread <uid> [uid2 uid3...]
list-mailboxes
列出所有可用的邮箱文件夹。
node scripts/imap.js list-mailboxes
SMTP 命令（发送邮件）
send
通过 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 "Hello" --body "World"
# 发送 HTML 邮件
node scripts/smtp.js send --to recipient@example.com --subject "Newsletter" --html --body "<h1>Welcome</h1>"
# 带附件的邮件
node scripts/smtp.js send --to recipient@example.com --subject "Report" --body "Please find attached" --attach report.pdf
# 多个收件人
node scripts/smtp.js send --to "a@example.com,b@example.com" --cc "c@example.com" --subject "Update" --body "Team update"
test
测试 SMTP 连接，向自己发送一封测试邮件。
node scripts/smtp.js test
依赖安装
npm install
安全注意事项
- 将凭据存储在
.env文件中（并添加到.gitignore） - Gmail：不支持常规密码登录——请在 https://myaccount.google.com/apppasswords 生成应用专用密码
- 163.com：使用授权码，而非账号密码
常见问题排查
连接超时：
- 确认服务器正在运行且可访问
- 检查主机名和端口配置是否正确
认证失败：
- 确认用户名是否正确（通常为完整邮箱地址）
- 检查密码是否正确
- 163.com：使用授权码，而非账号密码
- Gmail：不支持常规密码——请在 https://myaccount.google.com/apppasswords 生成应用专用密码
TLS/SSL 错误：
- 确保
IMAP_TLS/SMTP_SECURE设置与服务器要求匹配 - 如使用自签名证书：将
IMAP_REJECT_UNAUTHORIZED或SMTP_REJECT_UNAUTHORIZED设为false