折腾了一个邮件群发系统，彻底告别手动复制粘贴
原创：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 希望对大家有用 这个工具完完全全本地使用
