Python SMTP邮件发送技能：支持HTML、附件、模板和主流邮箱

send-email by wangyendt/wayne-skills

171 周安装量

2 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/wangyendt/wayne-skills --skill send-email

Python Web框架开发自动化

🇨🇳中文介绍

发送邮件

使用 Python 通过 SMTP 发送邮件，支持纯文本、HTML 格式、文件附件和基于模板的邮件。

主要特性

默认发件人邮箱 : 当未指定发件人时，自动使用 agent_skill_test@126.com
自动 Markdown 转 HTML : 检测 Markdown 内容并转换为美观的 HTML 样式
多种邮件提供商 : 支持 Gmail、Outlook、QQ 邮箱、163/126 邮箱和自定义 SMTP
文件附件 : 为邮件附加多个文件
邮件模板 : 使用带有变量替换的模板文件

交互式邮件发送流程

此技能将逐步引导您完成邮件发送过程。

步骤 1：收集基本邮件信息

向用户询问以下必需信息。如果缺少任何信息，提示用户提供：

信息	描述	示例
收件人 (`--to`)	要发送到的电子邮件地址	`user@example.com`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

步骤 2：识别邮件提供商并收集凭据

根据发件人邮箱地址的域名，识别邮件提供商并请求相应的凭据。

邮件提供商检测

@gmail.com, @googlemail.com   → Gmail
@outlook.com, @hotmail.com, @live.com, @office365.com → Outlook/Office 365
@qq.com, @vip.qq.com          → QQ Mail
@163.com, @126.com            → NetEase Mail
@aliyun.com, @aliyun-inc.com  → Aliyun Mail
@sendgrid.net, @*.sendgrid.net → SendGrid
@*.mailgun.org                → Mailgun
Other domains                  → Custom SMTP (ask for server, port, username, password)

提供商特定的凭据要求

Gmail (@gmail.com, @googlemail.com)

密码类型 : 应用密码 (非账户密码)
前提条件 : 必须启用双重身份验证 (2FA)
如何获取应用密码 :
1. 访问 https://myaccount.google.com/apppasswords
2. 登录您的 Google 账户
3. 选择 "Mail" 和 "Other (Custom name)" → 输入一个名称，如 "SMTP Script"
4. 点击 "Generate" → 复制 16 位字符的密码
SMTP 服务器 : smtp.gmail.com
端口 : 587 (TLS) 或 465 (SSL)
用户名 : 您的完整 Gmail 地址

Outlook / Office 365 (@outlook.com, @hotmail.com, @live.com, @office365.com)

密码类型 : 账户密码 (与网页登录相同)
SMTP 服务器 : smtp.office365.com
端口 : 587 (TLS)
用户名 : 您的完整 Outlook/Office 365 邮箱地址

QQ 邮箱 (@qq.com, @vip.qq.com)

密码类型 : SMTP 授权码 (非账户密码)
如何获取授权码 :
1. 登录 QQ 邮箱 https://mail.qq.com
2. 点击 "设置" → "账户"
3. 找到 "POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV 服务"
4. 开启 "POP3/SMTP 服务" 或 "IMAP/SMTP 服务"
5. 点击 "生成授权码"
6. 通过短信验证身份 → 复制生成的授权码
SMTP 服务器 : smtp.qq.com
端口 : 587 (TLS) 或 465 (SSL)
用户名 : 您的完整 QQ 邮箱地址

网易 163 邮箱 (@163.com)

密码类型 : SMTP 授权码 (非账户密码)
如何获取授权码 :
1. 登录 163 邮箱 https://mail.163.com
2. 点击 "设置" → "POP3/SMTP/IMAP"
3. 点击 "IMAP/SMTP 服务" 旁边的 "开启"
4. 验证身份 → 点击 "获取授权码"
5. 复制 16 位字符的授权码
SMTP 服务器 : smtp.163.com
端口 : 465 (SSL) 或 994 (IMAP)
用户名 : 您的完整 163 邮箱地址

网易 126 邮箱 (@126.com)

密码类型 : SMTP 授权码 (非账户密码)
如何获取授权码 :
1. 登录 126 邮箱 https://mail.126.com
2. 点击 "设置" → "POP3/SMTP/IMAP"
3. 启用 "IMAP/SMTP 服务"
4. 复制显示的授权密码
SMTP 服务器 : smtp.126.com
端口 : 465 (SSL) 或 25 (SSL)
用户名 : 您的完整 126 邮箱地址

密码类型 : API 密钥 (作为密码)
如何获取 API 密钥 :
1. 登录 SendGrid https://app.sendgrid.com
2. 前往 Settings → API Keys
3. 点击 "Create API Key"
4. 设置权限 → 点击 "Create & View"
5. 复制 API 密钥 (仅显示一次)
SMTP 服务器 : smtp.sendgrid.net
端口 : 587 (TLS) 或 465 (SSL)
用户名 : apikey (字面意思就是这个字符串)

密码类型 : 仪表板中的 SMTP 凭据
如何获取凭据 :
1. 登录 Mailgun https://app.mailgun.com
2. 前往 Sending → Domains
3. 选择您的域名
4. 从页面复制 SMTP 用户名和密码
SMTP 服务器 : smtp.mailgun.org
端口 : 587 (TLS)
用户名 : 来自 Mailgun 仪表板

自定义 SMTP (其他域名) 请用户提供：

SMTP 服务器地址
SMTP 端口
用户名
密码

步骤 3：自动检测和处理 Markdown 内容

脚本通过查找常见模式自动检测邮件内容是否为 Markdown 格式：

标题 (#, ##, ###)
粗体/斜体文本 (**bold**, *italic*)
列表 (- item 或 1. item)
代码块 (```)
链接 ([text](url))

如果检测到 Markdown，内容将自动转换为美观的 HTML 样式，包括：

专业的排版和间距
颜色编码的标题
样式化的表格和代码块
针对邮件客户端的响应式设计

您无需为 Markdown 内容手动指定--content-type html - 它会自动处理！

步骤 4：收集可选信息 (如果需要)

--from-name: 发件人的显示名称 (例如，"John Doe")
--content-type html: 用于 HTML 格式的邮件 (默认为纯文本，但会自动转换 Markdown)
--attach: 要附加的文件路径 (可指定多个)
--template: 使用模板文件而不是内容
--template-vars: 模板变量的 JSON 字符串

步骤 5：确认并发送

发送前，与用户确认：

Ready to send:
From: [Sender Email]
To: [Recipient Email]
Subject: [Subject]
Content Type: [Plain/HTML]
Attachments: [List of attachments or None]

Proceed to send? (y/n)

如果确认，则使用所有收集的参数执行 send_email.py 脚本。

示例 1：基本的 Gmail 邮件

用户 : Send an email to john@example.com with subject "Hello"

技能 : I can help you send that email. I need a few more details:

Content : What should the email body contain?
Sender Email : What email address should I send from?

用户 : The content is "Hi John, just saying hello!" and send from myemail@gmail.com

技能 : I detected you're using Gmail. For Gmail, you need an App Password (not your regular password).

To get your App Password:

Go to https://myaccount.google.com/apppasswords
Sign in and create an App Password for "Mail"
Copy the 16-character password

Please provide your Gmail App Password:

用户 : abcd efgh ijkl mnop

技能 : Ready to send:

From: myemail@gmail.com
To: john@example.com
Subject: Hello
Content: Hi John, just saying hello!

Proceed to send? (y/n)

示例 2：使用默认发件人的 Markdown 内容

用户 : 发一封邮件给 manager@company.com,主题是"AR眼镜行业分析",内容是 [用户提供的 Markdown 报告]

技能 : 我来帮您发送这封邮件。检测到您没有指定发件人邮箱,我将使用默认邮箱 agent_skill_test@126.com 发送。

同时,我发现您的内容是 Markdown 格式,将自动转换为美观的 HTML 格式,让报告更易读。

为了使用 126 邮箱发送,我需要您提供 SMTP 授权码 。

获取授权码步骤:

登录 126 邮箱 → 设置 → POP3/SMTP/IMAP
启用 "IMAP/SMTP 服务"
复制显示的授权密码

请提供agent_skill_test@126.com 的授权码:

用户 : [提供授权码]

技能 : 准备发送邮件:

发件人: agent_skill_test@126.com
收件人: manager@company.com
主题: AR眼镜行业分析
格式: Markdown → HTML (自动转换)
内容预览: 包含标题、列表、表格等格式化内容

示例 3：使用默认发件人但缺少内容

用户 : 发邮件给 user@company.com，主题是项目报告

技能 : 我需要收集邮件内容：

邮件正文是什么？

用户 : 项目已完成，所有里程碑都已达成。

技能 : 我将使用默认邮箱 agent_skill_test@126.com 发送。

为了使用 126 邮箱发送，我需要您提供 SMTP 授权码 。

获取授权码步骤：

登录 126 邮箱 → 设置 → POP3/SMTP/IMAP
启用 "IMAP/SMTP 服务"
复制显示的授权密码

请提供agent_skill_test@126.com 的授权码：

用户 : [提供授权码]

技能 : 准备发送邮件：

发件人: agent_skill_test@126.com
收件人: user@company.com
主题: 项目报告
内容: 项目已完成，所有里程碑都已达成。

确认发送？(y/n)

示例 4：用户指定自定义发件人邮箱

用户 : Send a report to boss@company.com from myname@outlook.com about Q4 results, with attachment /home/user/q4_report.pdf

技能 : I'll help you send that email. Please provide the email content:

What should the email say about the Q4 results?

用户 : Please find attached the Q4 financial report. Let me know if you have any questions.

技能 : I see you're using Outlook. You'll need your Outlook account password (same as web login).

Please provide your Outlook password:

用户 : mypassword123

技能 : Ready to send:

From: myname@outlook.com
To: boss@company.com
Subject: Q4 results
Content: Please find attached the Q4 financial report. Let me know if you have any questions.
Attachment: /home/user/q4_report.pdf

Proceed to send? (y/n)

示例 5：自定义 SMTP

用户 : Send email to test@domain.com from my@domain.com

技能 : I need to gather some information:

Subject : What is the email subject?
Content : What is the email body?

用户 : Subject is Test Email, content is Hello World

技能 : Since you're using a custom domain (my@domain.com), I'll need your SMTP configuration:

SMTP Server : What is your SMTP server address?
SMTP Port : What port should I use?
Username : What is your SMTP username?
Password : What is your SMTP password?

用户 : Server is smtp.mydomain.com, port 587, username is my@domain.com, password is secret

技能 : Ready to send:

From: my@domain.com
To: test@domain.com
Subject: Test Email
Content: Hello World
SMTP Server: smtp.mydomain.com:587

Proceed to send? (y/n)

收集所有信息后，使用适当的参数执行脚本：

python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Email Subject" \
  --content "Email body content" \
  --smtp-server smtp.gmail.com \
  --smtp-port 587 \
  --username your@email.com \
  --password your-password-or-app-password

python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Email Subject" \
  --content "<h1>Hello</h1><p>HTML content</p>" \
  --content-type html \
  --smtp-server smtp.gmail.com \
  --smtp-port 587 \
  --username your@email.com \
  --password your-password

python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Email Subject" \
  --content "Email body" \
  --attach /path/to/file1.pdf \
  --attach /path/to/file2.csv \
  --smtp-server smtp.gmail.com \
  --smtp-port 587 \
  --username your@email.com \
  --password your-password

使用模板的邮件

python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Email Subject" \
  --template assets/simple-notification.html \
  --template-vars '{"title":"Notification","message":"Your report is ready!"}' \
  --content-type html \
  --smtp-server smtp.gmail.com \
  --smtp-port 587 \
  --username your@email.com \
  --password your-password

SSL 连接 (代替 TLS)

python3 scripts/send_email.py \
  --to recipient@example.com \
  --subject "Email Subject" \
  --content "Email body" \
  --smtp-server smtp.gmail.com \
  --smtp-port 465 \
  --use-ssl \
  --username your@email.com \
  --password your-password

SMTP 服务器配置参考

提供商	SMTP 服务器	端口	加密	密码类型	用户名
Gmail	smtp.gmail.com	587	TLS	应用密码	完整邮箱地址
Gmail	smtp.gmail.com	465	SSL	应用密码	完整邮箱地址
Outlook	smtp.office365.com	587	TLS	账户密码	完整邮箱地址
QQ 邮箱	smtp.qq.com	587	TLS	授权码	完整邮箱地址
QQ 邮箱	smtp.qq.com	465	SSL	授权码	完整邮箱地址
163 邮箱	smtp.163.com	465	SSL	授权码	完整邮箱地址
163 邮箱	smtp.163.com	994	SSL	授权码	完整邮箱地址
126 邮箱	smtp.126.com	465	SSL	授权码	完整邮箱地址
126 邮箱	smtp.126.com	25	SSL	授权码	完整邮箱地址
SendGrid	smtp.sendgrid.net	587	TLS	API 密钥	`apikey`
SendGrid	smtp.sendgrid.net	465	SSL	API 密钥	`apikey`
Mailgun	smtp.mailgun.org	587	TLS	SMTP 密码	来自仪表板

在使用此技能之前，请安装所需的 Python 依赖项：

pip install -r requirements.txt

这将安装 markdown 库 (版本 ≥3.4.0)，这是自动 Markdown 转 HTML 转换所必需的。

scripts/send_email.py

用于发送邮件的主要 Python 脚本。支持：

纯文本和 HTML 内容
多个文件附件
带有变量替换的邮件模板
TLS 和 SSL 加密
自定义发件人名称

references/smtp-servers.md

常见的 SMTP 服务器配置，包括 Gmail、Outlook、126、QQ、163、SendGrid、Mailgun 和 Aliyun。

simple-notification.html - 基本通知模板
report-summary.html - 带有指标网格的专业报告模板

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

152,900 周安装

Python SMTP邮件发送技能：支持HTML、附件、模板和主流邮箱

🇨🇳中文介绍

发送邮件

主要特性

交互式邮件发送流程

步骤 1：收集基本邮件信息

相关 Skills

步骤 2：识别邮件提供商并收集凭据

邮件提供商检测

提供商特定的凭据要求

步骤 3：自动检测和处理 Markdown 内容

步骤 4：收集可选信息 (如果需要)

步骤 5：确认并发送

示例对话

示例 1：基本的 Gmail 邮件

示例 2：使用默认发件人的 Markdown 内容

示例 3：使用默认发件人但缺少内容

示例 4：用户指定自定义发件人邮箱

示例 5：自定义 SMTP

脚本命令参考

基本命令

HTML 邮件

带附件的邮件

使用模板的邮件

SSL 连接 (代替 TLS)

SMTP 服务器配置参考

安装

资源

scripts/send_email.py

references/smtp-servers.md

assets/

最新 Skills