Send Email

通过 SMTP 发送邮件的工具，支持 keyring 密钥管理。

功能

• ✅ 支持 SMTP 邮件发送（Gmail、QQ 邮箱、163 邮箱等）
• ✅ 支持纯文本和 HTML 格式邮件
• ✅ 支持模板渲染（使用 --template 参数，支持自定义模板）
• ✅ 支持内嵌图片（图片直接显示在邮件正文中，不是链接）
• ✅ 自动检测 Markdown 格式（含图片自动嵌入）
• ✅ 支持附件（文档、图片等）
• ✅ 支持抄送（CC）和密送（BCC）
• ✅ 配置持久化，避免重复输入
• ✅ 密钥管理：支持 keyring 安全存储密码（推荐）

密钥管理

⚠️ 重要：密码安全

本技能强制使用 keyring 管理发件人邮箱和密码，避免敏感信息暴露在命令行或上下文中。

安装 keyring

pip install keyring

如果 keyring 未安装，脚本会自动使用备用存储方案（base64 编码的本地文件）。

首次使用：保存发件人邮箱

在发送邮件前，必须先保存发件人邮箱到 keyring：

# 保存发件人邮箱（会提示输入）
python3 send_email.py username --save --email [email protected]

# 或只运行 --save，然后交互输入
python3 send_email.py username --save

保存密码

# 保存密码（会提示输入）
python3 send_email.py password --save

删除密钥

# 删除发件人邮箱
python3 send_email.py username --delete

# 删除密码
python3 send_email.py password --delete

查看密钥状态

# 查看发件人邮箱
python3 send_email.py username

# 查看密码状态
python3 send_email.py password

⚠️ 安全提醒

• 不要在命令行参数中传递邮箱或密码
• 不要使用 --email 参数直接指定发件人
• 始终通过 username --save 和 password --save 命令管理密钥
• 邮箱和密码会自动从 keyring 读取，无需每次输入
• 默认邮箱：[email protected]

快速开始

0. 安装依赖（可选）

推荐安装 markdown 库以支持 Markdown 自动转换：

pip install markdown keyring

如果不安装 markdown 库，脚本仍可正常发送纯文本和 HTML 邮件，但无法自动转换 Markdown。

1. 首次配置

cd $CLAWD/skills/send-email/scripts

# 配置 SMTP 服务器（中国移动邮箱默认配置）
python3 send_email.py smtp --host smtp.gd.chinamobile.com --port 465 --no-tls

# 配置发件人名称
python3 send_email.py sender --name "Your Name"

# 保存发件人邮箱到 keyring
python3 send_email.py username --save --email [email protected]

# 查看当前配置
python3 send_email.py config

中国移动邮箱默认配置：

重要提示： 如果使用 Gmail，需要生成「应用专用密码」（App Password），而不是使用账户密码。

2. 发送邮件

首次使用：保存密码

python3 send_email.py password --save
# 按提示输入密码

基础发送（纯文本）

python3 send_email.py send \
  --to [email protected] \
  --subject "邮件主题" \
  --body "邮件正文内容"

HTML 邮件

python3 send_email.py send \
  --to [email protected] \
  --subject "HTML 邮件" \
  --body "<h1>标题</h1><p>正文内容</p>" \
  --html

带附件的邮件

python3 send_email.py send \
  --to [email protected] \
  --subject "带附件的邮件" \
  --body "请查看附件" \
  --attachments "/path/to/file1.pdf" "/path/to/file2.png"

抄送和密送

python3 send_email.py send \
  --to [email protected] \
  --cc [email protected] [email protected] \
  --bcc [email protected] \
  --subject "多人邮件" \
  --body "邮件正文"

自动检测 Markdown + 内嵌图片（最强推荐）⭐⭐⭐

功能： 自动检测 Markdown 格式，自动提取并内嵌图片，无需手动指定！

python3 send_email.py send \
  --to [email protected] \
  --subject "Markdown 邮件（自动检测图片）" \
  --body "# 标题\n\n![图片说明](/path/to/image.png)\n\n这是正文内容"