---
name: mengya-mail-skill
description: 使用萌芽邮箱 API 发送邮件、列出邮件、读取邮件或测试邮箱连通性。优先用于脚本化收发件和自动化通知。
---

# 萌芽邮箱 Skill

优先使用下面这个本地脚本：

```bash
python3 /shumengya/project/skills/mengya-mail-skill/scripts/mengya-mail-api.py --help
```

## 常用场景

- `send-email`：发送邮件
- `send-template`：发送模板邮件
- `test-connection`：检查 SMTP / IMAP 连通性
- `list-emails`：列出邮件
- `read-email`：读取邮件
- `templates`：查看可用模板

## 示例

```bash
python3 /shumengya/project/skills/mengya-mail-skill/scripts/mengya-mail-api.py test-connection
python3 /shumengya/project/skills/mengya-mail-skill/scripts/mengya-mail-api.py send-email --to mail@smyhub.com --subject "问候" --text-body "你好，我是树萌芽。" --from-name "通知"
python3 /shumengya/project/skills/mengya-mail-skill/scripts/mengya-mail-api.py list-emails --criteria UNSEEN --limit 10
python3 /shumengya/project/skills/mengya-mail-skill/scripts/mengya-mail-api.py read-email --uid 12345
python3 /shumengya/project/skills/mengya-mail-skill/scripts/mengya-mail-api.py send-template --template birthday --to mail@example.com --var name=小王 --var sender=树萌芽 --from-name "生日通知"
```

## 说明

- 脚本默认读取 `/shumengya/project/python/mengya-mail-api/.env`
- 真正的业务实现放在 `/shumengya/project/python/mengya-mail-api/src/mengya_mail_api/`，skill 目录里的脚本只是入口
- 发送邮件时优先直接传 `--to`、`--subject`、`--text-body`
- 结果默认输出 JSON，便于后续处理
- 如果只是给人看，可以加 `--format md`