# email-manager

**Repository Path**: xuehaolun/email-manager

## Basic Information

- **Project Name**: email-manager
- **Description**: 一个超轻量的邮件批量发送工具，根据Excel文件内容发送&抄送邮件，并添加附件。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-14
- **Last Updated**: 2026-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# email-manager

#### 使用方法

1. 下载exe发行版，最好放在独立文件夹中。
2. **准备好Excel工作表**。
   - 工作表必须在第一行包含**序号、公司名、邮箱、抄送**三列。
   - 序号：必须不为空。必须为整数。不要在数字前使用0补位。
     - 该序号将用来查找附件。详见步骤3。
   - 公司名：必须不为空。如果需要在发送邮件时，在邮件正文内容中提到公司名，可以在邮件正文中插入【{{name}}】，邮件发送时，将把【{{name}}】替换为对应的公司名。
   - 邮箱：必须不为空。程序会检查邮箱格式（但不会确认邮箱是否真实存在）。
   - 抄送：可以为空。可以填写一个邮箱。也可以填写多个邮箱。填写多个邮箱时，以英文分号（**;**）间隔。
3. **准备好附件**，放在一个文件夹内。
   - 附件的文件名必须形如**前缀_序号**。下划线【_】不能省略。序号需要和工作表中的序号相对应。
4. **填写配置信息**：以阿里邮箱为例
   - SMTP服务器：阿里邮箱请填写【smtp.qiye.aliyun.com:465】。
   - 用户名：填写自己的邮箱地址即可。
   - 密码：对于阿里邮箱，建议使用第三方密码。详见[什么是三方客户端安全密码,如何使用该密码_阿里邮箱(Alibaba Mail)-阿里云帮助中心](https://help.aliyun.com/document_detail/444269.html)
   - 附件前缀：填写附件文件的前缀。
   - 快速发送：不建议勾选。勾选后将会提高发信速度，但发件箱中的顺序可能被打乱。
   - 填写配置后可以点击【保存配置】，将会在程序所在目录生成配置文件email_config.json。**请妥善保管配置文件，其中包含密码明文。**
   - 可以将保存后的配置文件修改成其他名称（但必须保持.json格式），以后可以在页面的最上方选择不同的配置文件。
5. **选择Excel文件，并选择数据所在的工作表名**。此时将会检查工作表内容。出现【验证通过】后，可确认数据行数（即发送的邮件数）。
6. **选择附件文件夹，并点击检查附件**。此时将会检查附件是否存在。
7. **点击发送邮件**。

#### 打包

使用 `.spec` 文件打包，支持单文件/文件夹两种模式：

```bash
# 文件夹打包（默认）
pyinstaller --clean email-manager.spec
# 输出: dist/email-manager/

# 单文件打包
pyinstaller --clean email-manager.spec -- --onefile
# 输出: dist/email-manager.exe
```

**输出说明：**
- **文件夹打包**：在 `dist/email-manager/` 目录中，包含 `email-manager.exe` 和所有依赖文件
- **单文件打包**：生成单个 `dist/email-manager.exe` 文件

**可选优化：**
- 安装 [UPX](https://upx.github.io/) 可减小打包文件大小约 30%
- PyInstaller 会自动检测环境中是否有 UPX 和 strip 工具，如有则自动使用