---
name: email
description: 通过 QQ 或 163 邮箱发送和接收邮件。支持发送普通邮件、带附件邮件、接收邮件、检查新邮件。当用户要求发送邮件、查看邮件、检查新邮件时使用。
homepage: https://github.com/countbot-ai/CountBot
---

# 邮件管理

通过 QQ 或 163 邮箱发送和接收邮件。

## 配置

编辑 `skills/email/scripts/config.json`，填写邮箱地址和授权码（非登录密码）。

授权码获取：
- QQ 邮箱：设置 > 账户 > 开启 IMAP/SMTP > 生成授权码
- 163 邮箱：设置 > POP3/SMTP/IMAP > 开启服务 > 设置授权密码

可通过 `default_mailbox` 字段设置默认邮箱（`"qq"` 或 `"163"`）。

## 命令行调用

```bash
# 发送邮件
python3 skills/email/scripts/mail.py send --to user@example.com --subject "主题" --content "内容"

# 发送带附件
python3 skills/email/scripts/mail.py send --to user@example.com --subject "报告" --content "请查收" --attach report.pdf

# 接收最新邮件
python3 skills/email/scripts/mail.py receive --limit 5

# 接收邮件（JSON 输出，推荐 AI 使用）
python3 skills/email/scripts/mail.py receive --limit 5 --json

# 检查新邮件（最近 N 天）
python3 skills/email/scripts/mail.py check-new --since 1

# 检查新邮件（JSON 输出）
python3 skills/email/scripts/mail.py check-new --since 1 --json

# 删除邮件（移到已删除文件夹，QQ邮箱可恢复）
python3 skills/email/scripts/mail.py delete --ids 123

# 批量删除
python3 skills/email/scripts/mail.py delete --ids 123 124 125

# 彻底删除（不可恢复）
python3 skills/email/scripts/mail.py delete --ids 123 --permanent

# 指定邮箱类型
python3 skills/email/scripts/mail.py --mailbox 163 send --to user@example.com --subject "测试"
```

## 删除邮件说明

- QQ 邮箱（IMAP）：默认移到「已删除」文件夹，可以从已删除中恢复。加 `--permanent` 彻底删除。
- 163 邮箱（POP3）：POP3 协议不支持文件夹操作，删除始终是永久的，不可恢复。