一个让微信批量发送消息，定时自动发送消息的小工具🚀

✅自动发送消息：自动检查时间并在对应时刻发送消息🤖（基于cron表达式，可精确到分钟）

✅循环发送消息：cron表达式可设置任意循环作业🔄

✅群发消息：一次性向多个好友发送不同的消息👥

✅全平台支持，轻松部署在服务器上，服务端部署在win平台接受客户端的请求，客户端可部署到任意平台🌍

本项目分为2部分，服务端和客户端：

服务端是一个轻量的服务器，和微信一起安装在win上，接受客户端的网络请求并对微信进行自动化操作

• /ping：检查服务端是否正常运行，返回'status': 'pong'
• /send_message/：发送消息，接受json格式的数据name、text，并对微信进行自动化操作

服务端有消息队列和互斥锁，只需要把消息发送给服务端，服务端会自动处理消息队列，保证消息依次发送

客户端是一个轻量的前端，可以在任意平台上运行，通过网络请求发送消息给服务端

• 首页：连接服务器ip，导入导出数据库，启动定时任务
• 发送消息管理：批量发送消息
• 定时任务管理：定时发送消息
• 数据管理界面：管理数据库内容，编辑发送消息

为了简化服务端配置，请把微信安装在C:/Program Files/Tencent/WeChat/WeChat.exe，这个位置是默认的微信安装位置，如果你微信安装在其他地方，请创建一个快捷方式在这里

• 在release界面找到最新的版本，下载YuYuWechatV2_Server.exe和YuYuWechatV2_Server_run.bat

• 两个文件放在同一个目录下，双击YuYuWechatV2_Server_run.bat即可运行

• cd到YuYuWechatV2_Server目录下

• 安装依赖pip install -r requirements.txt

• 运行python manage.py runserver 0.0.0.0:8000

上一步安装并运行服务端后，可以用简单的命令测试服务端是否成功运行

打开终端（powershell）：

curl http://127.0.0.1:8000/wechat/ping

正常会返回

StatusCode        : 200
StatusDescription : OK
Content           : {"status": "pong"}
RawContent        : HTTP/1.1 200 OK
                    Vary: origin
                    X-Frame-Options: DENY
                    X-Content-Type-Options: nosniff
                    Referrer-Policy: same-origin
                    Cross-Origin-Opener-Policy: same-origin
                    Content-Length: 18
                    Content-Type: applicat...
Forms             : {}
Headers           : {[Vary, origin], [X-Frame-Options, DENY], [X-Content-Type-Options, nosniff], [Referrer-Policy, same
                    -origin]...}
Images            : {}
InputFields       : {}
Links             : {}
Links             : {}                                                                                                  ParsedHtml        : System.__ComObject                                                                                  RawContentLength  : 18

$jsonData = '{"name": "文件传输助手", "text": "hi"}'
Invoke-WebRequest -Uri http://127.0.0.1:8000/wechat/send_message/ -Method Post -Headers @{"Content-Type"="application/json"} -Body $jsonData -ContentType "application/json; charset=utf-8"

这个命令会给文件传输助手发送一条消息hi

我已经编译好了x86和arm的docker镜像，Windows/mac/Linux的x86和arm架构均可运行

• 在release界面找到最新的版本，下载docker-compose.yml文件
• 运行docker-compose up即可运行

如果你想自定义数据库结构和增���功能，可以从源码运行

• cd到YuYuWechatV2_Client目录下
• 安装依赖pip install -r requirements.txt
• 运行python manage.py runserver 127.0.0.1:7500

客户端的定时功能需要celery和redis支持，这两个库编译成exe非常困难，所以exe版本没有定时功能

exe版本由GitHub Action自动编译，虽然源码有单元测试，但是并没有对编译后的exe进行测试，所以不保证可靠性

• 在release界面找到最新的版本，下载YuYuWechatV2_Client.exe和YuYuWechatV2_Client_run.bat
• 两个文件放在同一个目录下，双击YuYuWechatV2_Client_run.bat即可运行

• 首先需要连接服务器，输入服务器的ip地址和端口，如192.168.50.1:8000，然后点击ping测试服务器是否连通，连通后，点击保存服务器ip即可持久化保存到数据库，下次不需要再配置服务器ip
• 数据库导入导出功能可以方便备份和还原
• 点击启动定时任务，才会启动定时发送任务

其他功能在侧边栏点击即可跳转到对应的界面，前端网页只涉及对数据库的查看和发送操作，对用户和消息内容的增加，删除，修改均需要在后台管理界面进行，这样可以保证数据的安全性

在client_app里是客户端的数据，可以看到有4个数据表

• Messages：发送消息管理的数据表
• Scheduled messages：定时任务管理的数据表
• Server configs：服务端配置
• Wechat users：微信用户数据表

• Username：微信好友名字或者备注名，必须在搜索结果中排名第一（必填）
• Wechatid：微信号（非必填）
• Date added：好友添加日期（非必填）
• Group:：好友分组，前端网页可以根据分组筛选好友，方便分组管理（非必填）

• Is active：本条消息是否激活，激活后才会定时发送，默认是激活的
• User：选择在上一步增加的微信用户（必填）
• Text：发送的���息内容（必填）
• Cron expression：cron表达式，定时发送的时间，格式为* * * * *，分别代表分 时 日 月 周（必填）
• Execution count:：消息的执行次数，0为不执行，每次执行后会减一，直到为0，这样可以控制消息的发送次数（需要手动设置次数）
• Execution skip：消息的跳过次数，默认为0。若设置为1，则下次不会执行任务，下下次才会，若设置为2，则会跳过两次任务，以此类推，这样可以控制定时发送消息的开始（非必填）

通过cron表达式和消息的执行次数和消息的跳过次数，即可实现消息的任意时刻开始，结束，在任意时间发送消息，循环发送消息

关于cron表达式，本程序是5段式的cron表达式，精确到分钟，请不要和7段式搞混
网上有在线生成器或者ChatGPT生成也可以 以下是一些例子

* * * * *：每分钟执行一次
0 * * * *：每小时执行一次
0 0 * * *：每天执行一次
0 0 * * 1：每周一执行一次


*/10 * * * * # 每10分钟执行一次
0 0 */2 * * # 每隔一天午夜12点执行
0 0 * * 1    # 每周一午夜12点执行
0 0 1 * *    # 每月1日午夜12点执行
0 0 * * 1 [ "$(date +\%d)" -le 7 ]    # 每个月的第一个周一午夜12点执行

本项目部署了单元测试，GitHub Action测试以及人工测试，最大程度避免bug的产生，但是仍然可能存在未知的bug，如果遇到问题欢迎提issue👏

easyChat YuYuWechatV2_Server的核心就是easyChat，请支持它

如果这个小工具正好对你有帮助，欢迎点个star⭐，谢谢！