邮件工具箱免费版

版本: 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中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

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

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

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

输出示例：

✅ 邮件发送成功!
   收件人: colleague@example.com
   主题: 会议提醒
   格式: 纯文本

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

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

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

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

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

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

快速开始

第一步：创建配置文件

在工作目录创建 email_config.json：

{
  "smtp_server": "smtp.gmail.com",
  "smtp_port": 587,
  "username": "your-email@gmail.com",
  "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位密码填入配置文件

第三步：发送测试邮件

# 发送测试邮件验证配置
python email_sender.py --to "your-email@gmail.com" --test

第四步：正式使用

# 发送普通邮件
python email_sender.py --to "friend@example.com" --subject "你好" --body "这是一封测试邮件"

# 发送带附件的邮件
python email_sender.py --to "friend@example.com" --subject "报告" --body "请查收" --attachment "report.pdf"

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

示例

各邮箱服务商配置

环境变量配置

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

# Linux/macOS
export SMTP_SERVER=smtp.gmail.com
export SMTP_PORT=587
export EMAIL_USERNAME=your-email@gmail.com
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="your-email@gmail.com"
$env:EMAIL_PASSWORD="your-app-password"
$env:EMAIL_SENDER_NAME="邮件助手"

SSL 配置（163邮箱）

{
  "smtp_server": "smtp.163.com",
  "smtp_port": 465,
  "username": "your-email@163.com",
  "password": "your_auth_code",
  "sender_name": "邮件助手",
  "use_tls": false,
  "use_ssl": true
}

最佳实践

Python API 调用

from email_sender import EmailSender

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

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

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

安全规范

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

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

附件大小管理

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

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

# 大文件使用链接替代
python email_sender.py --to x@y.com --subject "大文件" --body "文件链接: https://drive.google.com/xxx"

常见问题

问题1：认证失败

Error: Authentication Failed

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

解决:

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

问题2：连接被拒绝

Error: Connection Refused

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

解决:

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

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

问题3：附件过大

Error: Attachment Too Large

解决:

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

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

问题4：SSL/TLS 配置错误

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

# 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 编码发送。

命令参考速查

依赖说明

运行环境

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

依赖详情

API Key 配置

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

可用性分类

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

错误处理

已知限制

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