modbender 139邮箱IMAP/POP3操作技能
概述
本技能通过IMAP/POP3协议直接连接139邮箱服务器，实现高效的邮件管理功能。
重要：首次使用需配置账号和授权码
安装依赖
本技能需要安装第三方依赖库：
pip install imapclient
依赖说明：
imapclient：用于IMAP协议连接139邮箱服务器- 标准库：
smtplib,email,json,argparse（Python内置）
SSL/TLS 安全说明
由于139邮箱服务器使用的是较旧版本的TLS协议（TLS 1.0/1.1），本技能使用兼容模式连接。 安全建议：
- 兼容模式会降低SSL安全性，建议仅在受信任的网络环境中使用
首次使用流程
当用户首次请求操作139邮箱时：
第1步：环境检查（推荐）
运行环境检查脚本，确保所有依赖就绪：
python scripts/check_env.py
此脚本会检查：
- Python版本 >= 3.8
- OpenSSL版本 >= 1.1.1
- imapclient模块已安装
- SSL兼容性设置
- 配置文件是否存在
第2步：安装依赖
pip install imapclient
第3步：开启IMAP服务并获取授权码
- 前往 https://mail.10086.cn/ 登录邮箱
- 进入 设置 → 账户 → IMAP/POP3服务
- 开启 IMAP/SMTP服务
- 获取授权码（16位字符串，不是登录密码！）
⚠️ 重要：授权码只显示一次，请务必保存！
第4步：保存配置
python scripts/config_manager.py save --username 136xxxxxxxxx@139.com --password 你的授权码
第5步：测试连接
python scripts/check_mail.py --limit 5
如果显示邮件列表，说明配置成功！
快速开始（一步完成）
# 1. 安装依赖
pip install imapclient
# 2. 运行环境检查
python scripts/check_env.py
# 3. 配置账号（替换为你的账号和授权码）
python scripts/config_manager.py save --username 136xxxxxxxxx@139.com --password xxxxxxxxxxxxxxxx
# 4. 查看邮件
python scripts/check_mail.py --unread
配置管理
脚本：scripts/config_manager.py
命令：
python scripts/config_manager.py check- 检查是否已配置python scripts/config_manager.py save --username <账号> --password <授权码>- 保存配置python scripts/config_manager.py show- 显示当前配置（隐藏授权码）
配置文件：config/139mail.conf
配置文件格式（JSON）：
{
"username": "136xxxxxxxxx@139.com",
"password": "授权码",
"imap_server": "imap.139.com",
"imap_port": 993,
"smtp_server": "smtp.139.com",
"smtp_port": 465
}
项目结构
skills/139mail/
├── SKILL.md # 本文件 - 使用文档
├── config/ # 配置目录
│ └── 139mail.conf # 账号配置文件（自动创建）
├── references/ # 参考资料
│ ├── credentials.md # 服务器配置信息
│ └── imap_guide.md # IMAP操作指南
└── scripts/ # 核心脚本
├── check_env.py # ⭐ 环境检查脚本（新手先用）
├── config_manager.py # 配置管理
├── check_mail.py # 查看邮件
├── view_mail.py # 查看邮件详情
├── send_mail.py # 发送邮件
├── search_mail.py # 搜索邮件
├── manage_mail.py # 邮件管理（标记/删除）
└── move_mail.py # 邮件分拣
核心功能
1. 查看收件箱/未读邮件
触发场景："查看139邮箱"、"有没有新邮件"
流程：
- 检查配置是否存在（
config_manager.py check） - 如无配置，执行首次使用流程
- 调用
scripts/check_mail.py --unread
命令示例：
python scripts/check_mail.py --limit 10
python scripts/check_mail.py --unread
2. 查看指定邮件详情
脚本：scripts/view_mail.py <邮件ID>
示例：
python scripts/view_mail.py 123
3. 发送邮件
脚本：scripts/send_mail.py <收件人> <主题> <正文>
示例：
python scripts/send_mail.py "recipient@example.com" "主题" "正文内容"
4. 搜索邮件
脚本：scripts/search_mail.py <关键词>
示例：
python scripts/search_mail.py "工作汇报"
5. 管理邮件
脚本：scripts/manage_mail.py
常用命令：
# 列出邮件
python scripts/manage_mail.py --list
# 列出已删除邮件
python scripts/manage_mail.py --list-trash
# 标记已读/未读
python scripts/manage_mail.py --mark-read <ID>
python scripts/manage_mail.py --mark-unread <ID>
# 删除邮件（移动到已删除文件夹）
python scripts/manage_mail.py --delete <ID>
# 恢复邮件（从已删除文件夹恢复）
python scripts/manage_mail.py --restore <ID>
# 彻底删除（永久删除，不可恢复）
python scripts/manage_mail.py --permanent-delete <ID>
6. 邮件分拣
脚本：scripts/move_mail.py
示例：
# 列出所有文件夹
python scripts/move_mail.py --list-folders
# 移动邮件
python scripts/move_mail.py --move <邮件ID> --to <目标文件夹>
错误处理与故障排除
常见错误及解决方案
1. SSL握手失败
错误信息：
[SSL: SSLV3_ALERT_HANDSHAKE_FAILURE] sslv3 alert handshake failure
原因：
- 139邮箱使用较旧的TLS 1.0/1.1协议
- Python 3.10+ 默认OpenSSL安全级别过高
解决方案： 本技能已自动配置兼容性设置，无需手动修改。如仍失败：
# 检查Python版本
python --version # 需要 >= 3.8
# 检查OpenSSL版本
python -c "import ssl; print(ssl.OPENSSL_VERSION)" # 需要 >= 1.1.1
2. 登录失败
错误信息：
imapclient.exceptions.LoginError
检查清单：
- 账号格式正确：
136xxxxxxxxx@139.com（不是纯手机号） - 使用的是授权码，不是登录密码
- 已在网页版开启 IMAP 服务
- 授权码未过期（如过期需重新获取）
3. 找不到模块
错误信息：
ModuleNotFoundError: No module named 'imapclient'
解决：
pip install imapclient
4. 中文显示乱码
现象：邮件主题/发件人显示为乱码
原因：Windows终端编码问题
解决：
- 使用 VS Code 终端（推荐）
- 或设置 Windows 使用 UTF-8：
chcp 65001
调试模式
如需详细调试信息，可在运行脚本前设置环境变量：
set PYTHONHTTPSVERIFY=0
python scripts/check_mail.py --limit 5
首次使用提示模板
当检测到用户未配置时，使用以下提示：
首次使用139邮箱功能，需要您先完成以下设置：
1. 安装依赖：
pip install imapclient
2. 登录 https://mail.10086.cn/
3. 进入 设置 → 账户 → IMAP/POP3服务
4. 开启 IMAP/POP3 服务
5. 获取授权码（不是登录密码！）
请提供：
- 139邮箱账号（如 136xxxxxxxxx@139.com）
- 授权码：______
安全说明
- 配置文件权限：配置文件
config/139mail.conf保存时设置权限为 600（仅所有者可读写） - SSL/TLS：使用兼容模式连接139邮箱。由于139邮箱使用较旧TLS协议，此模式会降低SSL安全性，建议仅在受信任的网络环境中使用。
- 授权码保护：授权码仅保存在本地配置文件，不会上传到任何外部服务器。
- 使用完成后：如不再使用，建议删除配置文件并撤销邮箱授权码。
参考文档
- IMAP操作指南：参见 references/imap_guide.md
- 服务器配置：参见 references/credentials.md