Email Skill

English | 中文

🎯 让 AI Agent 一键发送邮件、只读查看收件箱的 skill，兼容 Coremail 校园/企业邮箱系统。

✨ 功能

• ✅ SMTP 邮件发送（SSL 加密）
• ✅ IMAP 只读收信：读取最新/未读邮件，使用 BODY.PEEK[]，不标记已读、不发送、不删除
• ✅ 命令行参数：指定收件人、主题、正文、读取数量等
• ✅ 多附件支持：自动识别 PDF、图片、Office 文档等 MIME 类型
• ✅ BCC 抄送/密送：自动 BCC（密送）一份到自己收件箱，方便网页端查看发送记录，收件人不可见
• ✅ Coremail 兼容：支持开启了二次验证（2FA）的校园/企业邮箱，使用备用密码

📁 仓库结构

email/
├── SKILL.md                       # Skill 元数据与详细文档
├── README.md                      # 本文件
├── README.en.md                   # 英文说明
├── LICENSE.txt
└── scripts/
    ├── send_csu_email.py          # 现成可运行的发信脚本
    └── read_csu_email.py          # 只读读取收件箱脚本

⚡ 快速开始

1. 配置脚本

编辑 scripts/send_csu_email.py，填入你自己的邮箱信息：

# ============== 配置区域 ==============
SENDER_EMAIL = "your_id@edu.cn"               # 你的邮箱地址
CLIENT_PASSWORD = "YOUR_ALTERNATIVE_PASSWORD" # 客户端备用密码
SMTP_SERVER = "mail.edu.cn"                   # 你学校的 SMTP 服务器
SMTP_PORT = 465                               # SSL 端口
# =======================================

关于备用密码（Alternative Password） 如果你的邮箱开启了二次验证（2FA），需要在网页邮箱里生成“客户端专用密码”用于 SMTP/IMAP 登录。 路径通常为：邮箱设置 → Two-Factor Authentication → Configure Alternative Password。

2. 发送邮件

# 基础发送
python scripts/send_csu_email.py

# 指定收件人
python scripts/send_csu_email.py --target recipient@example.com

# 完整自定义
python scripts/send_csu_email.py \
  --target boss@company.com \
  --subject "周报" \
  --body "请查收本周工作报告。"

# 带附件（自动识别 PDF、图片、Office 等 MIME 类型）
python scripts/send_csu_email.py \
  --target team@example.com \
  --attach report.pdf photo.jpg data.xlsx

也可以使用短参数：

python scripts/send_csu_email.py -t boss@company.com -s "周报" -b "请查收" -a report.pdf

3. 只读查看收件箱

read_csu_email.py 默认复用 send_csu_email.py 中的 SENDER_EMAIL 和 CLIENT_PASSWORD，也可用环境变量覆盖。

# 读取最新 5 封邮件正文
python scripts/read_csu_email.py -n 5

# 只读取未读邮件
python scripts/read_csu_email.py --unread -n 10

# 只看发件人、时间、主题，不读取正文
python scripts/read_csu_email.py --summary-only -n 10

该脚本使用 IMAP 只读模式和 BODY.PEEK[]，不会发送邮件、删除邮件、移动邮件或标记已读。

🛠️ 安装

OpenCode

git clone https://github.com/smithyyang/email-skill.git \
  ~/.config/opencode/skills/email

之后，当对话中出现以下关键词时，OpenCode 会自动加载此 skill：

"send email", "发邮件", "SMTP", "邮箱发送", "read email", "读邮箱", "查看邮件", "收件箱", "IMAP"

Claude Code

git clone https://github.com/smithyyang/email-skill.git \
  ~/.claude/skills/email

之后，当对话中出现以上关键词时，Claude Code 会自动加载此 skill。

CLI / Shell 脚本

此仓库自带可直接运行的 Python 脚本，无需 AI Agent 也可独立使用：

python scripts/send_csu_email.py --help
python scripts/read_csu_email.py --help

📚 常见 SMTP / IMAP 配置参考

邮箱类型	SMTP 服务器	SMTP 端口	IMAP 服务器	IMAP 端口	密码说明
中南大学	mail.csu.edu.cn	465	mail.csu.edu.cn	993	备用密码（2FA 开启时）
Gmail	smtp.gmail.com	587	imap.gmail.com	993	App Password
Outlook	smtp.office365.com	587	outlook.office365.com	993	App Password / OAuth
QQ 邮箱	smtp.qq.com	465	imap.qq.com	993	授权码（非 QQ 密码）
163	smtp.163.com	465	imap.163.com	993	授权码

🤝 贡献

欢迎 PR 和 Issue！例如：

• 支持更多邮箱的现成脚本
• 添加 HTML 邮件模板
• 添加 --config 多邮箱配置文件支持

📄 License

MIT License - 详见 LICENSE.txt