netease-mail

name	netease-mail
description	通过 IMAP/SMTP 连接邮箱，支持收发邮件、搜索、附件下载。支持 163、126、yeah.net 等网易邮箱及其他标准 IMAP/SMTP 邮箱。触发关键词：邮件、邮箱、发邮件、收件箱、163、126、email、inbox、send mail。
description_zh	通过 IMAP/SMTP 连接邮箱，支持收发邮件、搜索、附件下载。支持 163、126、yeah.net 等网易邮箱及其他标准 IMAP/SMTP 邮箱。触发关键词：邮件、邮箱、发邮件、收件箱、163、126、email、inbox。
description_en	Connect to email via IMAP/SMTP. Supports sending, receiving, searching, and downloading attachments. Works with 163, 126, yeah.net and other standard IMAP/SMTP email providers.
version	1.0.0

邮箱收发技能（IMAP/SMTP）

通过 IMAP/SMTP 协议收发邮件，支持网易系邮箱（163、126、yeah.net 等）及其他支持标准协议的邮箱。

核心要求

1. 发信用 node @skills/connector-netease-mail/scripts/smtp.bundle.js
2. 收信/搜索/附件用 node @skills/connector-netease-mail/scripts/imap.bundle.js
3. 凭证已注入环境变量：NETEASE_EMAIL_USER（邮箱地址）和 NETEASE_EMAIL_PASS（授权码）由连接器自动注入，无需手动传入。
4. 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 "[e-mail]" \
  --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 "[e-mail]" \
  --subject "周报" \
  --html \
  --body "<h1>本周总结</h1><p>完成了 3 个任务</p>"

# 发送带附件的邮件
node @skills/connector-netease-mail/scripts/smtp.bundle.js send \
  --to "[e-mail]" \
  --subject "报告" \
  --body "请查收附件" \
  --attach "$HOME/Documents/report.pdf"

# 抄送密送
node @skills/connector-netease-mail/scripts/smtp.bundle.js send \
  --to "[e-mail]" \
  --cc "[e-mail]" \
  --bcc "[e-mail]" \
  --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）