Email Toolkit Free

跨平台邮件发送与附件管理工具，支持多邮箱服务商

邮件工具箱免费版

版本: 1.0.0 适用对象: 个人用户、独立开发者、一人公司 核心定位: 跨平台邮件发送与附件管理基础工具

---

概述

邮件工具箱免费版是一款轻量级的跨平台邮件发送工具，通过 Python 实现邮件自动化发送。工具支持 Gmail、Outlook、Yahoo、QQ邮箱等主流邮箱服务商，以及自定义 SMTP 服务器，提供纯文本与 HTML 邮件、多附件发送、抄送密送等核心功能。

工具采用 TLS/SSL 加密连接确保邮件传输安全，支持配置文件与环境变量两种配置方式，适配不同使用场景。同时提供命令行与 Python API 两种调用方式，方便集成到自动化脚本与工作流中。免费版聚焦个人用户的邮件发送需求，配置简单、调用便捷。

---

核心能力

邮件发送

• 纯文本邮件: 简单快捷的文本邮件发送
• HTML 邮件: 支持富文本格式邮件
• 命名收件人: 支持"姓名 <邮箱>"格式
• 抄送与密送: 支持 CC 与 BCC 收件人

输入: 用户提供邮件发送所需的指令和必要参数。 处理: 按照skill规范执行邮件发送操作,遵循单一意图原则。 输出: 返回邮件发送的执行结果,包含操作状态和输出数据。

附件管理

• 单附件发送: 发送带单个附件的邮件
• 多附件发送: 一次性发送多个附件
• 多种格式: 支持 PDF、Excel、图片、代码文件等各类格式

输入: 用户提供附件管理所需的指令和必要参数。 处理: 按照skill规范执行附件管理操作,遵循单一意图原则。 输出: 返回附件管理的执行结果,包含操作状态和输出数据。

多服务商支持

• Gmail（smtp.gmail.com）
• Outlook/Office365（smtp.office365.com）
• Yahoo（smtp.mail.yahoo.com）
• QQ邮箱（smtp.qq.com）
• 自定义 SMTP 服务器

输入: 用户提供多服务商支持所需的指令和必要参数。 处理: 按照skill规范执行多服务商支持操作,遵循单一意图原则。 输出: 返回多服务商支持的执行结果,包含操作状态和输出数据。

安全特性

• TLS 加密连接（端口 587）
• SSL 加密连接（端口 465）
• 应用专用密码支持（Gmail）
• 环境变量凭证存储

输入: 用户提供安全特性所需的指令和必要参数。 处理: 按照skill规范执行安全特性操作,遵循单一意图原则。 输出: 返回安全特性的执行结果,包含操作状态和输出数据。

测试功能

• 发送测试邮件验证配置
• 连接测试
• 配置文件验证

---

输入: 用户提供测试功能所需的指令和必要参数。 处理: 按照skill规范执行测试功能操作,遵循单一意图原则。 输出: 返回测试功能的执行结果,包含操作状态和输出数据。 技术参数：使用input_params和output_format参数控制执行行为,支持json/text/csv输出格式。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：跨平台邮件发送与、附件管理工具、支持多邮箱服务商、邮件工具箱免费版、是一款面向个人用、户的跨平台邮件发、送工具、Python、实现邮件、自动化发送、邮箱等主流服务商、Use、when、需要消息发送、通知推送、邮件短信、通信集成时使用、不适用于垃圾信息、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：发送简单文本邮件

快速发送一封纯文本邮件给同事。

bash

# 发送简单邮件
python email_sender.py --to "[e-mail]" --subject "会议提醒" --body "明天上午10点会议室A开会，请准时参加。"

输出示例：

text

✅ 邮件发送成功!
   收件人: [e-mail]
   主题: 会议提醒
   格式: 纯文本

场景二：发送带附件的工作邮件

向团队发送包含报告和数据文件的工作邮件。

bash

# 发送带多个附件的邮件
python email_sender.py \
  --to "[e-mail]" \
  --subject "项目周报 - 2026年7月第三周" \
  --body "您好，附件为本周项目进展报告与数据文件，请查收。" \
  --attachment "report.pdf" \
  --attachment "data.xlsx"

场景三：发送 HTML 格式通知邮件

发送格式化的 HTML 通知邮件，带抄送。

bash

python email_sender.py \
  --to "[e-mail]" \
  --cc "[e-mail]" \
  --subject "系统维护通知" \
  --body '<h1>系统维护通知</h1><p>系统将于本周六凌晨2点-4点进行维护升级，届时服务将暂停。</p><p>请提前做好相关准备。</p>'

---

快速开始

第一步：创建配置文件

在工作目录创建 email_config.json：

json

{
  "smtp_server": "smtp.gmail.com",
  "smtp_port": 587,
  "username": "[e-mail]",
  "password": "your-app-password",
  "sender_name": "邮件助手",
  "use_tls": true,
  "use_ssl": false
}

第二步：Gmail 用户配置（推荐）

Gmail 用户需使用应用专用密码：

1. 在 Google 账户开启两步验证
2. 访问 https://myaccount.google.com/security
3. 在"登录 Google"中选择"应用密码"
4. 为"邮件"生成新的应用密码
5. 将16位密码填入配置文件

第三步：发送测试邮件

bash

# 发送测试邮件验证配置
python email_sender.py --to "[e-mail]" --test

第四步：正式使用

bash

# 发送普通邮件
python email_sender.py --to "[e-mail]" --subject "你好" --body "这是一封测试邮件"

# 发送带附件的邮件
python email_sender.py --to "[e-mail]" --subject "报告" --body "请查收" --attachment "report.pdf"

---

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

各邮箱服务商配置

服务商	SMTP 服务器	端口	TLS	SSL
Gmail	smtp.gmail.com	587	是	-
Outlook/Office365	smtp.office365.com	587	是	-
Yahoo	smtp.mail.yahoo.com	587	是	-
QQ邮箱	smtp.qq.com	587	是	-
163邮箱	smtp.163.com	465	-	是
自定义	your.smtp.server	587/465	按配置	按配置

环境变量配置

也可以使用环境变量替代配置文件：

bash

# Linux/macOS
export SMTP_SERVER=smtp.gmail.com
export SMTP_PORT=587
export EMAIL_USERNAME=[e-mail]
export EMAIL_PASSWORD=your-app-password
export EMAIL_SENDER_NAME="邮件助手"

# Windows PowerShell
$env:SMTP_SERVER="smtp.gmail.com"
$env:SMTP_PORT="587"
$env:EMAIL_USERNAME="[e-mail]"
$env:EMAIL_PASSWORD="your-app-password"
$env:EMAIL_SENDER_NAME="邮件助手"

SSL 配置（163邮箱）

json

{
  "smtp_server": "smtp.163.com",
  "smtp_port": 465,
  "username": "[e-mail]",
  "password": "your_auth_code",
  "sender_name": "邮件助手",
  "use_tls": false,
  "use_ssl": true
}

---

最佳实践

Python API 调用

python

from email_sender import EmailSender

# 初始化发送器
sender = EmailSender("email_config.json")

# 发送带附件的邮件
result = sender.send_email(
    to_email="[e-mail]",
    subject="重要文档",
    body="请审阅附件中的文档。",
    attachments=["document.pdf", "data.csv"]
)

if result["success"]:
    print(f"邮件发送成功，附件数: {result['attachments']}")
else:
    print(f"发送失败: {result['error']}")

安全规范

• 绝不提交凭证到版本控制: 将 email_config.json 加入 .gitignore
• 使用环境变量: 生产环境优先使用环境变量
• 定期更换密码: 定期轮换应用专用密码
• 专用邮箱: 自动化场景建议使用专用邮箱账户

bash

# .gitignore 中添加
echo "email_config.json" >> .gitignore

附件大小管理

• 单个附件建议不超过 25MB（大多数服务商限制）
• 多附件总大小建议不超过 50MB
• 大文件建议使用云存储链接替代

bash

# 检查文件大小
ls -lh report.pdf

# 大文件使用链接替代
python email_sender.py --to [e-mail] --subject "大文件" --body "文件链接: https://drive.google.com/xxx"

---

常见问题

问题1：认证失败

text

Error: Authentication Failed

原因: 用户名或密码错误，或 Gmail 未使用应用专用密码。

解决:

• 确认用户名与密码正确
• Gmail 用户必须使用应用专用密码（非登录密码）
• 确认已开启两步验证

问题2：连接被拒绝

text

Error: Connection Refused

原因: SMTP 服务器地址或端口错误，或防火墙拦截。

解决:

• 验证 SMTP 服务器与端口
• 检查防火墙设置
• 尝试切换端口（465 SSL / 587 TLS）

bash

# 测试端口连通性
telnet smtp.gmail.com 587
telnet smtp.gmail.com 465

问题3：附件过大

text

Error: Attachment Too Large

解决:

• 压缩文件后再发送
• 拆分大文件为多个小文件
• 使用云存储链接替代

bash

# 压缩文件
zip -s 20m archive.zip large_file.pdf

问题4：SSL/TLS 配置错误

解决: 根据服务商选择正确的加密方式：

bash

# TLS (端口 587) - Gmail/Outlook
"use_tls": true, "use_ssl": false

# SSL (端口 465) - 163邮箱
"use_tls": false, "use_ssl": true

问题5：中文乱码

解决: 确保 Python 脚本使用 UTF-8 编码，邮件主题与正文使用 UTF-8 编码发送。

---

命令参考速查

参数	功能	示例
--to	收件人	--to "[e-mail]"
--cc	抄送	--cc "[e-mail]"
--bcc	密送	--bcc "[e-mail]"
--subject	主题	--subject "邮件主题"
--body	正文	--body "邮件内容"
--attachment	附件	--attachment "file.pdf"
--test	测试邮件	--test

---

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Python版本: 3.7 及以上
• 网络环境: 需可访问对应邮箱的 SMTP 服务器

依赖详情

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供
Python	运行时	必需	官方网站下载安装
Python 标准库	运行库	必需	Python 自带（smtplib, email）
邮箱账户	账户	必需	注册主流邮箱服务商
应用专用密码	凭证	必需	邮箱安全设置页生成

API Key 配置

• 本工具使用邮箱 SMTP 认证，无需额外 API Key
• Gmail 用户需生成应用专用密码（16位）
• 其他邮箱用户使用授权码或应用密码
• 凭证通过配置文件或环境变量提供

可用性分类

• 分类: MD+EXEC（纯Markdown指令，部分功能需要 exec 命令行执行能力）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行 Python 脚本，完成邮件发送与附件管理任务

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

已知限制

• 需要API Key，无Key环境无法使用