Email Manager

腾讯企业邮箱 IMAP/SMTP 客户端，通过 Python 脚本管理邮件。

环境要求

Python 3.8+（标准库即可，无需额外安装依赖）
所有命令前需设置编码：

$env:PYTHONIOENCODING='utf-8'

命令

查看邮件列表

python {baseDir}/scripts/email_client.py list [--folder INBOX] [--unread] [--limit 20] [--days 7]

读取邮件

python {baseDir}/scripts/email_client.py read --id <message_id>

发送邮件

python {baseDir}/scripts/email_client.py send --to "[email protected],[email protected]" --subject "标题" --body "正文" [--cc "[email protected]"] [--html] [--attachment "path1,path2"]

回复邮件

python {baseDir}/scripts/email_client.py reply --id <message_id> --body "回复内容" [--all]

转发邮件

python {baseDir}/scripts/email_client.py forward --id <message_id> --to "[email protected]" [--body "转发说明"]

标记邮件

python {baseDir}/scripts/email_client.py mark --id <message_id> [--read] [--unread] [--star] [--unstar]

搜索邮件

python {baseDir}/scripts/email_client.py search [--query "关键词"] [--from "[email protected]"] [--since "2026-03-01"] [--before "2026-03-13"] [--limit 20]

列出文件夹

python {baseDir}/scripts/email_client.py folders

邮箱统计

python {baseDir}/scripts/email_client.py stats

输出

所有命令输出 JSON 格式，可直接解析。

安装配置（首次使用必读）

安装后需要修改配置文件 {baseDir}/config/email-config.json，填入你自己的邮箱账号和密码：

{
  "imap": {
    "host": "imap.exmail.qq.com",
    "port": 993,
    "ssl": true
  },
  "smtp": {
    "host": "smtp.exmail.qq.com",
    "port": 465,
    "ssl": true
  },
  "account": {
    "username": "你的邮箱地址",
    "password": "你的邮箱密码或应用专用密码"
  }
}

host/port：根据你的邮箱服务商修改（默认为腾讯企业邮箱）
username：你的邮箱地址
password：邮箱密码或应用专用密码（推荐使用应用专用密码）

常见邮箱服务商配置： | 服务商 | IMAP Host | SMTP Host | IMAP Port | SMTP Port | |--------|-----------|-----------|-----------|-----------| | 腾讯企业邮箱 | imap.exmail.qq.com | smtp.exmail.qq.com | 993 | 465 | | QQ 邮箱 | imap.qq.com | smtp.qq.com | 993 | 465 | | 163 邮箱 | imap.163.com | smtp.163.com | 993 | 465 | | Gmail | imap.gmail.com | smtp.gmail.com | 993 | 465 |

qq-email-manager

Installation