ahang1598 邮箱收发技能（IMAP/SMTP）
通过 IMAP/SMTP 协议收发邮件，支持网易系邮箱（163、126、yeah.net 等）及其他支持标准协议的邮箱。
核心要求
- 发信用
node @skills/connector-netease-mail/scripts/smtp.bundle.js - 收信/搜索/附件用
node @skills/connector-netease-mail/scripts/imap.bundle.js - 凭证已注入环境变量：
NETEASE_EMAIL_USER（邮箱地址）和NETEASE_EMAIL_PASS（授权码）由连接器自动注入，无需手动传入。 - JSON 格式输出：所有命令输出标准 JSON，
success: true或success: false+message。
前置条件
用户需在连接器设置中填写邮箱地址和 IMAP/SMTP 授权码（非登录密码）。如果执行时提示缺少凭证，请告知用户在连接器管理中配置邮箱。
支持的邮箱
自动根据邮箱域名识别 IMAP/SMTP 服务器配置：
- 网易系：163.com、126.com、yeah.net、188.com 及其 VIP 版本
- QQ/Foxmail：qq.com、foxmail.com
- Gmail：gmail.com
- Outlook：outlook.com、hotmail.com
- 其他：sina.com、sohu.com、139.com、aliyun.com
发信命令（smtp.bundle.js）
发送邮件
node @skills/connector-netease-mail/scripts/smtp.bundle.js send \
--to "recipient@example.com" \
--subject "邮件主题" \
--body "邮件正文"
发送选项
| 参数 | 说明 |
|---|---|
--to |
必填，收件人地址 |
--subject |
必填，邮件主题 |
--body |
正文内容 |
--html |
标记为 HTML 格式（与 --body 配合） |
--body-file |
从文件读取正文（.html 后缀自动识别为 HTML） |
--cc |
抄送地址 |
--bcc |
密送地址 |
--attach |
附件路径（逗号分隔多个） |
--from |
发件人地址（默认使用配置的邮箱） |
示例
# 发送 HTML 邮件
node @skills/connector-netease-mail/scripts/smtp.bundle.js send \
--to "colleague@company.com" \
--subject "周报" \
--html \
--body "<h1>本周总结</h1><p>完成了 3 个任务</p>"
# 发送带附件的邮件
node @skills/connector-netease-mail/scripts/smtp.bundle.js send \
--to "boss@company.com" \
--subject "报告" \
--body "请查收附件" \
--attach "$HOME/Documents/report.pdf"
# 抄送密送
node @skills/connector-netease-mail/scripts/smtp.bundle.js send \
--to "a@example.com" \
--cc "b@example.com" \
--bcc "c@example.com" \
--subject "同步" \
--body "请查收"
测试连接
node @skills/connector-netease-mail/scripts/smtp.bundle.js test
收信命令（imap.bundle.js）
查看收件箱
node @skills/connector-netease-mail/scripts/imap.bundle.js check \
--limit 10 --recent 2h
| 参数 | 说明 |
|---|---|
--limit |
返回邮件数量（默认 10） |
--recent |
时间范围：30m（分钟）、2h（小时）、7d（天） |
--unseen |
仅显示未读邮件 |
--mailbox |
邮箱文件夹（默认 INBOX） |
搜索邮件
node @skills/connector-netease-mail/scripts/imap.bundle.js search \
--subject "发票" --recent 7d --limit 20
| 参数 | 说明 |
|---|---|
--subject |
按主题搜索 |
--from |
按发件人搜索 |
--recent |
时间范围 |
--unseen |
仅未读 |
--seen |
仅已读 |
--limit |
结果数量（默认 20） |
获取邮件详情
node @skills/connector-netease-mail/scripts/imap.bundle.js fetch 12345
参数为邮件 UID（从 check/search 结果中获取）。
下载附件
node @skills/connector-netease-mail/scripts/imap.bundle.js download 12345 \
--dir "$HOME/Downloads" --file "report.pdf"
| 参数 | 说明 |
|---|---|
| 第一个参数 | 邮件 UID |
--dir |
保存目录（默认 ~/Downloads） |
--file |
指定附件文件名（可选，不填则下载全部） |
标记已读/未读
node @skills/connector-netease-mail/scripts/imap.bundle.js mark-read 12345 12346
node @skills/connector-netease-mail/scripts/imap.bundle.js mark-unread 12345
列出邮箱文件夹
node @skills/connector-netease-mail/scripts/imap.bundle.js list-mailboxes
错误处理
- 凭证缺失（error_code: 2）：提醒用户在连接器设置中配置邮箱地址和授权码
- 认证失败：提醒用户检查授权码是否正确、是否在网页端开启了 IMAP/SMTP 服务
- 连接超时：网络波动或邮箱服务器限流，建议稍后重试
- 授权码过期/失效：告知用户在邮箱网页端重新生成授权码，然后在连接器管理中断开重连并输入新授权码
安全说明
- 所有连接使用 TLS 加密（IMAP:993 / SMTP:465）
- 凭证由环境变量注入，禁止在输出中暴露完整授权码
- 附件读写受目录白名单限制（默认 ~/Downloads, ~/Documents）