| 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 等）及其他支持标准协议的邮箱。
核心要求
- 发信用
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 | 发件人地址（默认使用配置的邮箱） |
示例
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）
