139Mail

# ⚠️ 重要声明

> **本技能非 139 邮箱官方发布**
> 
> 本技能由 139 邮箱发烧友基于标准 IMAP/POP3 协议开发，旨在为 OpenClaw 用户提供便捷的 139 邮箱访问方式。
> 
> **注意事项：**
> - 本技能为**非官方**第三方工具
> - 使用本技能产生的风险与 139 邮箱官方无关
> - 请用户谨慎使用，妥善保管账号密码
> - 建议定期更换邮箱授权码以确保安全
> 
> **使用前请确保：**
> 1. 您已了解并接受上述声明
> 2. 您已开启 139 邮箱的 IMAP/POP3 服务
> 3. 您已生成邮箱授权码（非登录密码）

---
---
name: 139mail
description: 139邮箱IMAP/POP3操作技能。支持通过IMAP/POP3协议查看收件箱/未读邮件、发送邮件、搜索邮件、管理邮件、邮件分拣。首次使用需配置账号和授权码。当用户需要操作139邮箱（mail.10086.cn）时触发此技能。
---

# 139邮箱IMAP/POP3操作技能

## 概述

本技能通过IMAP/POP3协议直接连接139邮箱服务器，实现高效的邮件管理功能。

**重要：首次使用需配置账号和授权码**

## 安装依赖

本技能需要安装第三方依赖库：

```bash
pip install imapclient
```

**依赖说明**：
- `imapclient`：用于IMAP协议连接139邮箱服务器
- 标准库：`smtplib`, `email`, `json`, `argparse`（Python内置）

## SSL/TLS 安全说明

由于139邮箱服务器使用的是较旧版本的TLS协议（TLS 1.0/1.1），本技能使用兼容模式连接。
**安全建议**：
- 兼容模式会降低SSL安全性，建议仅在受信任的网络环境中使用

## 首次使用流程

当用户首次请求操作139邮箱时：

### 第1步：环境检查（推荐）

运行环境检查脚本，确保所有依赖就绪：

```bash
python scripts/check_env.py
```

此脚本会检查：
- Python版本 >= 3.8
- OpenSSL版本 >= 1.1.1
- imapclient模块已安装
- SSL兼容性设置
- 配置文件是否存在

### 第2步：安装依赖

```bash
pip install imapclient
```

### 第3步：开启IMAP服务并获取授权码

1. 前往 https://mail.10086.cn/ 登录邮箱
2. 进入 **设置 → 账户 → IMAP/POP3服务**
3. 开启 **IMAP/SMTP服务**
4. 获取**授权码**（16位字符串，不是登录密码！）

⚠️ **重要**：授权码只显示一次，请务必保存！

### 第4步：保存配置

```bash
python scripts/config_manager.py save --username 136xxxxxxxxx@139.com --password 你的授权码
```

### 第5步：测试连接

```bash
python scripts/check_mail.py --limit 5
```

如果显示邮件列表，...

# 139mail Skill 快速入门

## 🚀 5分钟快速开始

### 第1步：环境检查
```bash
python scripts/check_env.py
```

### 第2步：安装依赖
```bash
pip install imapclient
```

### 第3步：获取授权码
1. 登录 https://mail.10086.cn/
2. 设置 → 账户 → IMAP/POP3服务 → 开启
3. 复制16位授权码（**不是登录密码！**）

### 第4步：配置账号
```bash
python scripts/config_manager.py save --username 136xxxxxxxxx@139.com --password 你的授权码
```

### 第5步：查看邮件
```bash
python scripts/check_mail.py --limit 5
```

---

## 📋 常用命令速查

| 功能 | 命令 |
|------|------|
| 查看最新邮件 | `python scripts/check_mail.py --limit 5` |
| 查看未读邮件 | `python scripts/check_mail.py --unread` |
| 查看邮件详情 | `python scripts/view_mail.py <邮件ID>` |
| 发送邮件 | `python scripts/send_mail.py "收件人@example.com" "主题" "正文"` |
| 搜索邮件 | `python scripts/search_mail.py "关键词"` |
| 列出邮件 | `python scripts/manage_mail.py --list` |
| 删除邮件 | `python scripts/manage_mail.py --delete <ID>` |
| 标记已读 | `python scripts/manage_mail.py --mark-read <ID>` |

---

## ⚠️ 常见问题

### SSL握手失败
**症状**：`[SSL: SSLV3_ALERT_HANDSHAKE_FAILURE]`

**原因**：139邮箱使用较旧TLS协议，Python 3.10+默认安全策略太严格

**解决**：本skill已自动处理，如仍失败运行 `python scripts/check_env.py` 诊断

### 登录失败
- 账号格式：`136xxxxxxxxx@139.com`（不是纯手机号）
- 必须使用**授权码**，不是登录密码
- 授权码可能过期，需要重新获取

### 中文乱码
Windows终端编码问题，建议使用 VS Code 终端

---

## 📖 详细文档

参见 [SKILL.md](SKILL.md)

## 🔒 安全提示

- 配置文件保存在本地 `config/139mail.conf`
- 使用兼容模式连接（降低SSL安全级别）
- 建议在受信任网络使用
- 用完可撤销邮箱授权码