invite-mailer

批量个性化邀请 / 通知邮件工具：从 Excel 或 CSV 读收件人，按人替换变量后发送；支持 HTML、附件、个性化邀请函、演练预览、断点续发和 SMTP 临时失败自动重试。

来自他人仓库 FrRay/bulk_invite_mailer_clean，本仓库在此基础上整理与改进。

快速开始

第 1 步：确认已安装 Python

需要 Python 3.9 或更高版本。

在 PowerShell 中执行：

python --version

若提示找不到命令，请先从 python.org 安装，安装时勾选 Add python.exe to PATH。也可试：

py -3 --version

第 2 步：下载本仓库

git clone https://gitlink.org.cn/Beckylu/invite-mailer.git

若未安装 Git，也可在仓库页面点击「下载」解压到本地文件夹。

第 3 步：进入项目目录

cd invite-mailer

请确认当前目录下能看到 bulk_invite_mailer.py、requirements.txt。

第 4 步：安装依赖

python -m pip install -r requirements.txt

会安装 openpyxl（读 Excel）和 Pillow（生成邀请函）。若 python 不可用，可改用：

py -3 -m pip install -r requirements.txt

第 5 步：启动图形界面

python bulk_invite_mailer.py --gui

也可以直接双击项目里的 start_gui.vbs 或 start_gui.bat（适合不想敲命令的情况）。

第 6 步：第一次使用建议

按下面顺序在界面里走一遍即可；需要细节时点对应链接。

步骤	做什么	说明
1	配置发件人并保存	连通自己的邮箱
2	读取示例收件人并预览	收件人与变量 · demo.csv
3	填写标题与正文	邮件正文 · body.html
4	（可选）配置个性化邀请函	个性化邀请函 · 配置示例
5	先演练发送，检查输出邮件	发送与续发
6	取消演练后真实发送	—

更多内容见 使用说明（附件、本地打印、续发等）。

命令行（可选）

# 演练（默认不发送）
python bulk_invite_mailer.py --excel examples/demo.csv --subject "{{姓名}}，活动邀请" --body-file examples/body.html --html --sender-profile "默认发件人"

# 真实发送 / 续发
python bulk_invite_mailer.py ... --send --delay 5
python bulk_invite_mailer.py ... --send --output-dir app_data/outputs/某次目录

# 测试
python -m unittest tests_mailer.py

更多参数见 python bulk_invite_mailer.py --help。