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）

### 发送邮件

```bash
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` | 发件人地址（默认使用配置的邮箱） |

#### 示例

```bash
# 发送 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 "请查收"
```

### 测试连接

```bash
node @skills/connector-netease-mail/scripts/smtp.bundle.js test
```

## 收信命令（imap.bundle.js）

### 查看收件箱

```bash
node @skills/connector-netease-mail/scripts/imap.bundle.js check \
  --limit 10 --recent 2h
```

| 参数 | 说明 |
|------|------|
| `--limit` | 返回邮件数量（默认 10） |
| `--recent` | 时间范围：`30m`（分钟）、`2h`（小时）、`7d`（天） |
| `--unseen` | 仅显示未读邮件 |
| `--mailbox` | 邮箱文件夹（默认 INBOX） |

### 搜索邮件

```bash
node @skills/connector-netease-mail/scripts/imap.bundle.js search \
  --subject "发票" --recent 7d --limit 20
```

| 参数 | 说明 |
|------|------|
| `--subject` | 按主题搜索 |
| `--from` | 按发件人搜索 |
| `--recent` | 时间范围 |
| `--unseen` | 仅未读 |
| `--seen` | 仅已读 |
| `--limit` | 结果数量（默认 20） |

### 获取邮件详情

```bash
node @skills/connector-netease-mail/scripts/imap.bundle.js fetch 12345
```

参数为邮件 UID（从 check/search 结果中获取）。

### 下载附件

```bash
node @skills/connector-netease-mail/scripts/imap.bundle.js download 12345 \
  --dir "$HOME/Downloads" --file "report.pdf"
```

| 参数 | 说明 |
|------|------|
| 第一个参数 | 邮件 UID |
| `--dir` | 保存目录（默认 ~/Downloads） |
| `--file` | 指定附件文件名（可选，不填则下载全部） |

### 标记已读/未读

```bash
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
```

### 列出邮箱文件夹

```bash
node @skills/connector-netease-mail/scripts/imap.bundle.js list-mailboxes
```

## 错误处理

- **凭证缺失**（error_code: 2）：提醒用户在连接器设置中配置邮箱地址和授权码
- **认证失败**：提醒用户检查授权码是否正确、是否在网页端开启了 IMAP/SMTP 服务
- **连接超时**：网络波动或邮箱服务器限流，建议稍后重试
- **授权码过期/失效**：告知用户在邮箱网页端重新生成授权码，然后在连接器管理中断开重连并输入新授权码

## 安全说明

- 所有连接使用 TLS 加密（IMAP:993 / SMTP:465）
- 凭证由环境变量注入，禁止在输出中暴露完整授权码
- 附件读写受目录白名单限制（默认 ~/Downloads, ~/Documents）