IMAP/SMTP 电子邮件工具

通过 IMAP 协议读取、搜索和管理电子邮件。通过 SMTP 发送电子邮件。支持 Gmail、Outlook、163.com、vip.163.com、126.com、vip.126.com、188.com、vip.188.com 以及任何标准的 IMAP/SMTP 服务器。

配置

运行设置脚本以配置您的电子邮件账户：

bash setup.sh

配置存储在~/.config/imap-smtp-email/.env（配置在技能更新后仍会保留）。如果在此处未找到配置，技能将回退到技能目录中的.env文件（为了向后兼容）。

配置文件格式

# 默认账户（无前缀）
IMAP_HOST=imap.gmail.com
IMAP_PORT=993
IMAP_USER=your@email.com
IMAP_PASS=your_password
IMAP_TLS=true
IMAP_REJECT_UNAUTHORIZED=true
IMAP_MAILBOX=INBOX

SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your@email.com
SMTP_PASS=your_password
SMTP_FROM=your@email.com
SMTP_REJECT_UNAUTHORIZED=true

# 文件访问白名单（安全）
ALLOWED_READ_DIRS=~/Downloads,~/Documents
ALLOWED_WRITE_DIRS=~/Downloads

多账户

您可以在同一个配置文件中配置额外的电子邮件账户。每个账户在所有变量上使用一个名称前缀（大写）。

添加账户

运行设置脚本并选择"添加新账户"：

bash setup.sh

或者手动将带前缀的变量添加到~/.config/imap-smtp-email/.env：

# 工作账户（WORK_ 前缀）
WORK_IMAP_HOST=imap.company.com
WORK_IMAP_PORT=993
WORK_IMAP_USER=me@company.com
WORK_IMAP_PASS=password
WORK_IMAP_TLS=true
WORK_IMAP_REJECT_UNAUTHORIZED=true
WORK_IMAP_MAILBOX=INBOX
WORK_SMTP_HOST=smtp.company.com
WORK_SMTP_PORT=587
WORK_SMTP_SECURE=false
WORK_SMTP_USER=me@company.com
WORK_SMTP_PASS=password
WORK_SMTP_FROM=me@company.com
WORK_SMTP_REJECT_UNAUTHORIZED=true

使用命名账户

在命令前添加--account <名称>：

node scripts/imap.js --account work check
node scripts/smtp.js --account work send --to foo@bar.com --subject Hi --body Hello

若未指定--account，则使用默认（无前缀）账户。

账户命名规则

• 仅限字母和数字（例如：work、163、personal2）
• 不区分大小写：work与WORK指向同一账户
• 在.env文件中的前缀始终为大写（例如：WORK_IMAP_HOST）
• ALLOWED_READ_DIRS和ALLOWED_WRITE_DIRS在所有账户间共享（始终无前缀）

常见邮件服务器

Gmail重要提示：

• Gmail不接受您的常规账户密码
• 您必须生成一个应用专用密码：https://myaccount.google.com/apppasswords
• 将生成的16位应用专用密码用作IMAP_PASS/SMTP_PASS
• 要求谷歌账户已启用两步验证

163.com重要提示：

• 使用授权码，而非账户密码
• 请先在网页设置中启用IMAP/SMTP

IMAP命令（接收邮件）

check

检查新的/未读邮件。

node scripts/imap.js [--account <name>] check [--limit 10] [--mailbox INBOX] [--recent 2h]

选项：

• --limit <n>：最大结果数（默认：10）
• --mailbox <name>：要检查的邮箱（默认：INBOX）
• --recent <time>：仅显示最近 X 时间内的邮件（例如：30m、2h、7d）

fetch

通过 UID 获取完整的邮件内容。

node scripts/imap.js [--account <name>] fetch <uid> [--mailbox INBOX]

download

下载邮件中的所有附件，或特定附件。

node scripts/imap.js [--account <name>] download <uid> [--mailbox INBOX] [--dir <path>] [--file <filename>]

选项：

• --mailbox <name>：邮箱（默认：INBOX）
• --dir <path>：输出目录（默认：当前目录）
• --file <filename>：仅下载指定的附件（默认：下载所有）

search

使用筛选条件搜索邮件。

node scripts/imap.js [--account <name>] 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）

mark-read / mark-unread

将邮件标记为已读或未读。

node scripts/imap.js [--account <name>] mark-read <uid> [uid2 uid3...]
node scripts/imap.js [--account <name>] mark-unread <uid> [uid2 uid3...]

列出邮件箱

列出所有可用的邮件箱/文件夹。

node scripts/imap.js [--account <名称>] list-mailboxes

列出账户

列出所有已配置的电子邮件账户。

node scripts/imap.js list-accounts
node scripts/smtp.js list-accounts

显示账户名称、电子邮件地址、服务器地址和配置状态。

SMTP 命令（发送电子邮件）

发送

通过 SMTP 发送电子邮件。

node scripts/smtp.js [--account <名称>] send --to <邮箱> --subject <文本> [选项]

必需参数：

• --to <邮箱>：收件人（多个收件人用逗号分隔）
• --subject <文本>：邮件主题，或--subject-file <文件>

可选参数：

• --body <文本>：纯文本正文
• --html：以 HTML 格式发送正文
• --body-file <文件>：从文件中读取正文
• --html-file <文件>：从文件中读取 HTML
• --cc <邮箱>: 抄送收件人
• --bcc <邮箱>: 密送收件人
• --attach <文件>: 附件 (逗号分隔)
• --from <邮箱>: 覆盖默认发件人

示例:

# 简单文本邮件
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"

测试

通过向自己发送测试邮件来测试 SMTP 连接。

node scripts/smtp.js [--account <名称>] test

依赖项

npm install

安全须知

• 配置文件存储在~/.config/imap-smtp-email/.env权限为600(仅所有者可读/写)
• 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=false或SMTP_REJECT_UNAUTHORIZED=false