email

1# 邮件管理
2
3通过 QQ 或 163 邮箱发送和接收邮件。
4
5## 配置
6
7编辑 `skills/email/scripts/config.json`，填写邮箱地址和授权码（非登录密码）。
8
9授权码获取：
10- QQ 邮箱：设置 > 账户 > 开启 IMAP/SMTP > 生成授权码
11- 163 邮箱：设置 > POP3/SMTP/IMAP > 开启服务 > 设置授权密码
12
13可通过 `default_mailbox` 字段设置默认邮箱（`"qq"` 或 `"163"`）。
14
15## 命令行调用
16
17```bash
18# 发送邮件
19python3 skills/email/scripts/mail.py send --to user@example.com --subject "主题" --content "内容"
20
21# 发送带附件
22python3 skills/email/scripts/mail.py send --to user@example.com --subject "报告" --content "请查收" --attach report.pdf
23
24# 接收最新邮件
25python3 skills/email/scripts/mail.py receive --limit 5
26
27# 接收邮件（JSON 输出，推荐 AI 使用）
28python3 skills/email/scripts/mail.py receive --limit 5 --json
29
30# 检查新邮件（最近 N 天）
31python3 skills/email/scripts/mail.py check-new --since 1
32
33# 检查新邮件（JSON 输出）
34python3 skills/email/scripts/mail.py check-new --since 1 --json
35
36# 删除邮件（移到已删除文件夹，QQ邮箱可恢复）
37python3 skills/email/scripts/mail.py delete --ids 123
38
39# 批量删除
40python3 skills/email/scripts/mail.py delete --ids 123 124 125
41
42# 彻底删除（不可恢复）
43python3 skills/email/scripts/mail.py delete --ids 123 --permanent
44
45# 指定邮箱类型
46python3 skills/email/scripts/mail.py --mailbox 163 send --to user@example.com --subject "测试"
47```
48
49## 删除邮件说明
50
51- QQ 邮箱（IMAP）：默认移到「已删除」文件夹，可以从已删除中恢复。加 `--permanent` 彻底删除。
52- 163 邮箱（POP3）：POP3 协议不支持文件夹操作，删除始终是永久的，不可恢复。