qq-email-manager（QQ 邮箱管理器）

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 "a@b.com,c@d.com" --subject "标题" --body "正文" [--cc "e@f.com"] [--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 "a@b.com" [--body "转发说明"]

标记邮件

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

搜索邮件

python {baseDir}/scripts/email_client.py search [--query "关键词"] [--from "sender@example.com"] [--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：邮箱密码或应用专用密码（推荐使用应用专用密码）

常见邮箱服务商配置：