折腾了一个邮件群发系统，彻底告别手动复制粘贴

原创：ByronMann | 公众号：Byron的小窝 | 个人网站（Google搜索）：一只爱写代码的懒羊

一、为什么要折腾这个程序？

作为一个经常要和客户、社群成员打交道的“工具人”，我曾被邮件管理折磨得不轻：

📌 群发之痛

给几百号人发通知，手动复制粘贴到怀疑人生，还没发完手先抽筋了。

📌 付费之坑

市面上的群发工具，要么按封计费贵得离谱，要么模板僵硬限制多。

📌 门槛之高

想找个开源系统，结果还要先装 MySQL 数据库、配环境、建表……

对于只想“开箱即用”的我来说，门槛实在太高了。

📌 协作之难

想让同事帮忙发邮件，又怕他乱动服务器配置，市面上简单的工具大多缺少权限控制。

我就想：能不能做一个 简单、轻量、数据直接存 Excel 里、还支持团队协作 的群发系统？

带着这个想法，我拉上 AI，开始了一段有趣的“结对编程”之旅。

二、核心哲学：什么是“XLSX 原生”系统？

本系统基于 Node.js + React 构建，最大的特点就是：彻底抛弃传统数据库。

🚀 零数据库存储方案

数据全部存在 backend/data/ 目录下的 Excel 文件中：

users.xlsx：存储用户信息与角色
contacts.xlsx：存储联系人、分组及标签
email_templates.xlsx：存储你的个性化 HTML 模板
email_logs.xlsx：每一封邮件的发送记录
settings.xlsx：SMTP/IMAP 以及 AI 的配置信息

这样做的好处：

不需要安装任何 SQL 软件
数据完全透明，直接打开 Excel 就能修改
备份方便，只需复制整个文件夹

三、功能详解：全栈办公闭环

1️⃣ 邮件群发：支持“私人定制”变量

支持自定义收件人、从通讯录勾选、或按分组（如“客户组”）一键发送。支持变量替换：你在模板里写 Hi, {{name}}，系统会自动替换成对方的真实姓名，让每一封邮件都像“私人定制”。

2️⃣ 收件箱：同步与管理

支持 IMAP 协议 同步邮件，支持星标标记、邮件搜索（按主题、发件人、内容）以及已读/未读筛选，方便你高效管理收件信息。

3️⃣ 联系人管理：无缝衔接 Excel 工作流

支持批量导入 Excel，自动识别 name/姓名、email/邮箱 等字段。你可以自由设置标签和分组，管理数千名联系人也游刃有余。

4️⃣ AI 模板生成：你的私人撰稿人

系统接入 DeepSeek、GPT-3.5 等大模型。管理员配置 API Key 后，只需输入一句话需求，系统即可生成排版精美的 HTML 邮件模板，大幅节省内容创作时间。

四、深度硬核：权限体系与 API 架构

虽然是轻量工具，但在安全性上参考了企业级标准，实现了 路由级 + 菜单级 + API 级 三重防护。

1️⃣ 角色定义与权限对比

系统分为 管理员 (Admin) 和 普通用户 (User) 两种角色：

功能	普通用户	管理员	备注
控制台 / 邮件发送 / 收件箱	✅	✅	核心业务功能
联系人管理 / 邮件模板	✅	✅	包含 AI 生成功能
用户管理	❌	✅	创建/删除用户
系统设置	❌	✅	SMTP/IMAP/AI 配置
系统日志	❌	✅	查看全局操作记录

2️⃣ 标准化的 API 接口文档

后端通过 RESTful API 进行交互，所有敏感接口均需 JWT 认证。

认证接口：POST /api/auth/login
联系人接口：支持 batch-delete（批量删除）和 import（Excel 导入）
邮件接口：POST /api/emails/send 实现变量替换与群发
设置接口：POST /api/settings/smtp/test 提供配置连通性即时测试

五、保姆级教程：如何跑起来？

为了让非技术人员也能部署，我把步骤精简到了极致：

1️⃣ 准备“发动机” (Node.js)

因为系统是用 Node.js 写的，所以你的电脑需要先安装 Node.js 环境。

操作：前往 Node.js 官网下载最新稳定版本，安装时一直点击“下一步”即可。

2️⃣ 克隆项目并安装依赖

打开终端（Windows 可用 PowerShell / macOS 可用 Terminal）：

git clone <项目地址>
cd <项目目录>/backend
npm install

cd ../frontend
npm install

3️⃣ 配置邮箱与 AI

编辑项目根目录下的 .env 文件，填写 SMTP、IMAP、AI Key 等信息。

小提示：如果是 QQ 邮箱，需要生成授权码并开启 IMAP/SMTP 服务。

4️⃣ 启动服务

打开两个终端窗口：

# 后端
cd backend
npm run dev

# 前端
cd frontend
npm run dev

5️⃣ 访问系统

浏览器打开 http://localhost:3000，使用默认管理员账号登录：

邮箱：admin@example.com
密码：admin123456

登录后请先完成：

修改默认密码
配置 SMTP 邮箱
配置 AI 接口
导入联系人

六、与 AI 结对编程的真实感受

这是我第一次全程借助 AI 开发产品，感触颇深：

AI 负责“速度”：代码框架、API 设计、排错、技术文档，它把效率提升了 5-10 倍。
我负责“方向”：为什么用 XLSX 存数据？权限怎么分层？这些核心决策和“手感”打磨，依然需要人来拍板。

七、适用场景

小型企业/工作室：内部通知、客户维护
培训机构/社群：课程通知、资料分发
活动组织者：报名确认、日程提醒
电商/微商：促销推送、售后回访
个人站长/博主：newsletter 订阅

八、写在最后

你不需要是全能的技术大牛，但你需要有清晰的产品思维。AI 把你的愿景变成代码，而你决定它能走多远。希望这款系统能帮你解决实际办公中的邮件难题！

这个工具写完后对于我来说已经够用了，如果有别的需求可以提出来哦，如果我觉得ok也可以加上去

源码放这了目前我就只有百度云云盘有其他盘的大佬可以帮忙在评论区发出来

此内容需要 [链接登录后可见] 并刷新页面可见

开源地址：[链接登录后可见]

By ByronMann 希望对大家有用这个工具完完全全本地使用