邮箱助手

Files (9)

• SKILL.md
• credential_cache.py · scripts/
• email_analyzer.py · scripts/
• email_drafter.py · scripts/
• fetch_emails.py · scripts/
• fetch_with_cache.py · scripts/
• imap_client.py · scripts/
• imap_client_batch.py · scripts/
• send_email.py · scripts/

SKILL.md (first lines)

# 邮箱助手

智能邮箱管理助手，自动化处理邮件收发、阅读、分析和回复拟稿。

## 安全特性

- **加密存储**: 凭据使用 AES-256-GCM 加密存储
- **用户隔离**: 与 LaborAny 用户ID绑定，不同用户凭据完全隔离
- **自动过期**: 凭据30天自动过期，需要重新验证
- **机器绑定**: 密钥基于用户ID和机器指纹派生，防止凭据文件被挪用

## 工作流程

```
连接邮箱 → 获取未读 → AI分析总结 → 识别待办/会议 → 辅助拟稿 → [发送邮件]
```

发送邮件功能已集成凭据缓存，使用已保存的凭据自动发送。

## 快速开始

### Step 1: 连接邮箱并获取未读邮件

**方式一：自动模式（推荐，用于 AI 调用）**

自动使用缓存的凭据，无需用户交互：

```bash
# 自动使用第一个缓存的凭据
python scripts/fetch_with_cache.py <用户ID> --auto
```

**方式二：带缓存的智能模式**

自动保存凭据，下次无需重复登录，与用户绑定安全加密：

```bash
# 首次使用 - 需要提供邮箱和密码
python scripts/fetch_with_cache.py <用户ID>

# 指定邮箱（首次或更换邮箱）
python scripts/fetch_with_cache.py <用户ID> example@163.com
```

> **注意**: `<用户ID>` 应该是 LaborAny 的当前用户ID，用于隔离不同用户的凭据。
> `--auto` 参数启用非交互模式，直接使用第一个缓存的凭据，无需用户确认。

**方式二：命令行模式**

```bash
# 获取未读邮件
python scripts/fetch_emails.py <邮箱地址> <密码/授权码> [数量]

# 示例
python scripts/fetch_emails.py example@163.com YOUR_AUTH_CODE
```

**方式三：批处理模式**

```bash
python scripts/imap_client_batch.py <邮箱地址> <密码/授权码> [数量] [--all]

# 示例
python scripts/imap_client_batch.py example@163.com YOUR_AUTH_CODE 50
```

**方式四：交互式模式**

```bash
python scripts/imap_client.py
```

邮件会自动保存到 `emails.json`。

### Step 2: 分析邮件内容

```bash
python scripts/email_analyzer.py emails.json
```

查看摘要:

```bash
python scripts/email_analyzer.py --summary emails_analyzed.json
```

## 支持的邮箱服务

| 邮箱 | IMAP服务器 | SMTP服务器 | 特殊要求 |
|------|-----------|-----------|---------|
| Gmail | imap.gmail.com:993 | smtp.gmail.com:587 | 需应用专用密码 |
| Outlook | outlook.office365.com:993 | smtp.office365.com:587 | - |
| QQ邮箱 | imap.qq.com:993 | smtp.qq.com:587 | 需开启SMTP服务 |
| 163邮箱 | imap.163.com:993 | smtp.163.com:465 | 需授权码 + IMAP ID |
| 126邮箱 | imap.126.com:993 | smtp.126.com:465 | 需授权码 + IMAP ID |
| Yahoo | imap.mail.yahoo.com:993 | smtp.mail.yahoo.com:587 | - |

## 重要提示

### 163/126邮箱特殊说明

网易邮箱要求客户端发送 **IMAP ID** 信息，否则会报 "Unsafe Login" 错误。

本技能已在所有脚本中添加了 IMAP ID 支持，但使用时仍需注意：

1. **必须使用授权码**，不是登录密码
2. 开启IMAP服务：设置 → POP3/SMTP/IMAP
3. 如果仍报错，尝试在网页端邮箱设置中重新生成授权码

### Gmail 专用密码

1. 访问 https://myaccount.google.com/apppasswords
2. 生成应用专用密码
3. 使用该密码而非Google账号密码

### QQ邮箱

1. 进入邮箱设置
2. 开启IMAP服务

From laborany/laborany, MIT.

More from laborany/laborany