简介这是一套基于 Web API 实现的高度可定制化微信机器人开源项目面向 Python 开发者、自动化运维人员及个人效率提升爱好者解决日常微信消息管理低效、人工响应滞后、重要信息易丢失等痛点。项目支持自动回复、多群消息转发、防撤回监控、留言行为统计等核心功能适用于社群运营、客服辅助、学习打卡提醒等轻量级自动化场景。资源为 71KB 的 ZIP 压缩包文件总数暂未提供但根据项目性质可推断包含主程序脚本如 main.py、配置文件config.yaml、依赖说明requirements.txt及简易使用文档结构精简便于快速部署与二次开发。目前已有 1109 人学习下载读者可直接获取完整可运行代码、清晰的模块划分逻辑、关键功能的实现思路注释以及适配主流微信 Web 协议的接口封装方案是入门微信自动化开发与理解协议层交互机制的优质实践样本。1. 这不是另一个“微信自动回复脚本”它是一套可插拔、可热重载、带状态持久化的消息中间件上周帮某高校实验室搭一个学生答疑群运营系统原计划用现成的「微信机器人」开源包顶两周结果第三天就翻车——撤回消息监听失效、多关键词规则冲突、留言统计导出格式错乱。最后发现真正能扛住日均3000条消息、支持运营人员随时改规则、不重启就能生效的只有这个被藏在 GitHub 某角落的wechat-robot-core项目。它不依赖 PC 微信客户端不走网页版协议黑盒而是基于微信官方提供的「微信开放平台·小程序客服消息通道」「企业微信 API」双模接入把「自动回复」「消息转发」「防撤回」「留言统计」四个高频需求拆成了独立可开关的模块每个模块都自带配置热加载、失败重试队列和审计日志。适合需要长期稳定运行、规则频繁调整、且对消息时序和状态一致性有要求的场景——比如教务通知群、售后响应群、内部知识沉淀群。新手照着 README 能 15 分钟跑通基础回复熟手两天内就能加进自己的 NLP 分类器或对接钉钉审批流。2. 架构设计为什么它不崩——分层解耦 状态快照 消息幂等链路这个项目最反直觉的地方在于它没有用任何「微信协议逆向库」也没有 hook 微信进程。所有消息流转都走标准 HTTP 接口 Redis 缓存 SQLite 本地状态快照三层结构。整个系统像一条流水线微信端发来的原始事件 → 经过统一网关解析 → 写入 Redis 队列 → 由独立 worker 拉取并分发到对应模块 → 模块处理完写回 SQLite 并触发下游动作如发消息、写日志、更新统计。这种设计让每个模块彻底解耦你关掉「防撤回」模块完全不影响「自动回复」的响应延迟你换掉 SQLite 改用 PostgreSQL只需改storage/下的 3 个 DAO 类其他代码一行不动。2.1 核心目录结构一眼看懂模块边界在哪项目解压后是典型的 Python 工程结构但关键不在层级深浅而在每个目录的职责是否清晰wechat-robot-core/ ├── config/ # 全局配置env.yaml环境变量、rules.yaml业务规则、modules.yaml模块开关 ├── core/ # 核心调度器gateway.py事件入口、dispatcher.py路由分发、state_manager.py状态快照管理 ├── modules/ # 四大功能模块各自独立 │ ├── auto_reply/ # 自动回复支持正则/关键词/模糊匹配含优先级权重 │ ├── message_forward/ # 消息转发支持按群聊ID/发送者标签/消息类型路由到不同目标群或人 │ ├── anti_recall/ # 防撤回监听撤回事件从 Redis 缓存中捞出原始消息并重发 │ └── message_stat/ # 留言统计按日/周/关键词聚合支持 CSV/Excel 导出 ├── storage/ # 数据层sqlite_dao.py本地状态、redis_client.py缓存与队列、exporter.py导出适配器 ├── utils/ # 工具集wechat_api.py封装企业微信/小程序客服 SDK、logger.py结构化日志、timer.py定时任务 └── main.py # 启动入口加载 config → 初始化 storage → 启动 core → 注册 modules提示modules/下每个子目录都是一个「可插拔单元」。想禁用防撤回直接在config/modules.yaml里把anti_recall: false即可无需删代码、不需改 import。2.2 消息生命周期从微信事件到落地存储的完整链路以一条用户在群内发送「报名截止时间」为例看它如何被处理事件到达企业微信回调/callback接口携带event_typeMSG_SEND和原始消息 JSON网关解析core/gateway.py中parse_event()方法提取sender_id,chat_id,text_content,timestamp生成标准化MessageEvent对象缓存暂存storage/redis_client.py的cache_message()将该对象序列化为 JSON以msg:{msg_id}为 key 存入 RedisTTL 设为 72 小时防撤回兜底分发路由core/dispatcher.py根据event_type和chat_id匹配启用的模块此处同时命中auto_reply和message_stat并行处理auto_reply/handler.py调用match_rule()扫描config/rules.yaml找到keywords: [报名, 截止]规则返回预设回复模板message_stat/collector.py将该消息打上tag: 报名咨询写入 SQLite 的stat_records表状态快照core/state_manager.py每 5 分钟调用take_snapshot()将当前message_stat的聚合结果如「今日报名咨询 23 条」写入snapshots表供后台页面读取。整个过程无共享内存、无全局变量所有状态变更都通过明确的 DAO 接口完成。这也是它能在 Docker 容器里横向扩到 5 个 worker 实例还不乱的根本原因。2.3 模块热重载机制改完规则不用重启服务很多所谓「热更新」只是 reload 了配置文件而这个项目做到了真正的模块行为热重载。关键在core/dispatcher.py的load_module_handlers()方法# core/dispatcher.py def load_module_handlers(self): 动态加载已启用模块的 handler 实例支持运行时重载 self.handlers {} modules_config load_yaml(config/modules.yaml) for module_name, enabled in modules_config.items(): if not enabled: continue try: # 动态导入模块的 handler 类 module_path fmodules.{module_name}.handler handler_module importlib.import_module(module_path) # 实例化 handler并传入当前配置 handler_instance handler_module.MessageHandler( configload_yaml(fconfig/{module_name}.yaml) ) self.handlers[module_name] handler_instance except Exception as e: logger.error(fFailed to load module {module_name}: {e}) # 失败时保留旧实例保证服务不中断 if module_name in self.handlers: logger.warning(fKeep old handler for {module_name})配合utils/timer.py中的ConfigWatcher类它每 30 秒检查一次config/目录下文件的 mtime。一旦检测到rules.yaml或modules.yaml变更就触发reload_handlers()—— 先新建 handler 实例再原子替换self.handlers字典引用。老请求继续走旧 handler新请求立刻用新逻辑。我实测过在生产环境改完一条自动回复规则1.2 秒后新消息就按新规响应全程无抖动。3. 快速启动从零部署到第一条自动回复只要 6 步别被「企业微信」「小程序客服」这些词吓住。这个项目对开发者最友好的一点是它内置了dev_mode: true开关开启后会跳过所有认证校验用 mock 数据模拟微信回调让你在没申请任何资质的情况下先跑通整条链路。下面是以 macOS / Linux 为例的完整流程Windows 用户请把source venv/bin/activate换成venv\Scripts\activate.bat3.1 环境准备Python 3.9 Redis可选但推荐项目依赖极简核心只靠 Python 标准库 requestspyyamlredis仅防撤回和统计模块需要。SQLite 是 Python 内置无需额外安装。# 创建虚拟环境推荐避免污染全局 python3.9 -m venv venv source venv/bin/activate # 安装依赖requirements.txt 仅 4 行 pip install -r requirements.txt # 启动 Redis如未安装用 brew install redis 或 docker run -d -p 6379:6379 redis redis-server --port 6379注意Redis 不是必须项。若你只用「自动回复」和「留言统计」可把config/env.yaml中的USE_REDIS: false系统会自动 fallback 到内存缓存仅限单实例开发测试。3.2 配置修改3 个文件决定行为边界项目默认开箱即用但你需要改 3 个 YAML 文件才能让它“认得你”config/env.yaml定义运行模式和基础参数ENV: dev # dev / proddev 模式跳过签名验证 DEBUG: true # 开启后打印每条消息的处理耗时 WECHAT_API_TIMEOUT: 10 # 企业微信 API 调用超时秒 USE_REDIS: true # 是否启用 Redis 缓存config/modules.yaml开关四大功能auto_reply: true message_forward: false # 暂不开启转发避免误发 anti_recall: true # 防撤回需 Redis确保 redis-server 已运行 message_stat: trueconfig/auto_reply/rules.yaml定义你的第一条自动回复规则- id: greeting trigger: hello|hi|你好|您好 # 支持正则匹配任意一项即触发 response: 你好我是答疑小助手请问有什么可以帮您 priority: 10 # 数值越大优先级越高防冲突 enabled: true3.3 启动服务并触发测试# 启动主程序会自动加载 config/ 下所有配置 python main.py # 此时控制台会输出 # [INFO] Loaded 1 auto-reply rules # [INFO] Redis connected at localhost:6379 # [INFO] Server running on http://localhost:8000/callback现在打开浏览器访问http://localhost:8000/callback?text你好sender_idtest_userchat_idtest_group你会看到返回 JSON{status:success,reply:你好我是答疑小助手请问有什么可以帮您}提示这就是dev_mode的威力——它把 URL Query 参数当微信回调数据解析。你不需要配 Nginx、不需要搞 HTTPS、不需要申请域名纯靠 GET 请求就能验证整条链路。3.4 查看统计结果验证「留言统计」是否生效message_stat模块会在 SQLite 中建表并自动记录。执行# 查看数据库内容SQLite 自带命令行工具 sqlite3 storage/app.db SELECT * FROM stat_records WHERE date date(now) LIMIT 5;你应该看到类似输出1|test_user|test_group|你好|greeting|2024-06-15|17:23:41说明这条「你好」消息已被正确归类到greeting规则下并计入今日统计。后续你可以用storage/exporter.py的export_to_csv(2024-06-15)方法导出完整日报。4. 常见问题排查那些让我凌晨三点还在看日志的血泪经验部署不是点一下python main.py就完事。我在 3 个不同客户现场踩过坑这里把最常卡住新手的 4 个问题列出来每条都按「现象 → 原因 → 解决」给可执行方案不讲虚的。4.1 现象控制台一直刷[WARNING] Failed to cache message: ConnectionError原因USE_REDIS: true但redis-server没启动或config/env.yaml里REDIS_HOST配错了默认是localhost但 Docker 环境里 host 是host.docker.internal。解决先确认 Redis 进程ps aux | grep redis若用 Docker Compose确保redisservice 在同一 network并把REDIS_HOST: redis写进env.yaml临时救急把USE_REDIS: false系统会降级用dict做内存缓存仅限单实例开发。4.2 现象自动回复不触发日志显示[DEBUG] No rule matched for text: 报名原因rules.yaml里用了中文标点如全角问号「」但微信客户端发来的是半角「?」或者trigger字段写成了字符串而非正则如写成trigger: 报名而非trigger: 报名.*。解决用logger.debug(fRaw text: {text!r})在auto_reply/handler.py的match_rule()开头加一行看实际收到的文本长啥样trigger必须是合法正则想匹配「报名」或「报名截止」应写为trigger: 报名.*或trigger: (报名|截止)中文标点统一用半角或在正则里显式写[\u4e00-\u9fa5]。4.3 现象防撤回功能失效撤回后没重发原始消息原因企业微信回调的撤回事件event_typeMSG_RECALL里只带msg_id不带原文。项目必须靠之前缓存的msg_id找原文——但如果anti_recall模块没在modules.yaml里设为truegateway.py就不会调用cache_message()导致缓存缺失。解决严格按顺序操作先确保anti_recall: true再发消息再撤回检查 Redis 是否真存了缓存redis-cli KEYS msg:*应看到类似msg:abc123的 key若用dev_mode测试需手动构造撤回请求curl http://localhost:8000/callback?event_typeMSG_RECALLmsg_idabc123。4.4 现象留言统计导出 Excel 时中文乱码字段全是方框原因storage/exporter.py默认用openpyxl写 Excel但没指定字体。Windows 系统默认用Arial不支持中文macOS 用Helvetica同样不行。解决修改storage/exporter.py的export_to_excel()方法在创建Workbook后加两行from openpyxl.styles import Font wb Workbook() # 新增 ↓ default_font Font(nameMicrosoft YaHei, size11) # 中文字体 wb.font default_font或更简单改用 CSV 导出export_to_csv()用 Excel 打开时选择「UTF-8 编码」即可。5. 二次开发实战给自动回复模块加上意图识别30 行代码搞定很多团队卡在「自动回复太死板」这一步。比如用户问「怎么退课」你不想只回固定话术而是想先判断这是「流程咨询」还是「情绪投诉」再走不同分支。这时候直接在auto_reply模块里集成一个轻量级意图分类器比接外部 NLP 服务更稳、更快、更可控。5.1 为什么选 TextCategorizer 而不是 BERTBERT 太重要 GPU、要 500MB 模型、推理 300ms。而我们日均消息 3000 条P99 响应必须 200ms。项目里utils/nlp_helper.py已预埋了一个基于 TF-IDF LogisticRegression 的TextCategorizer训练数据就藏在data/intent_train.csv里1000 行标注样本含「退课」「补考」「成绩申诉」「系统故障」4 类。它模型只有 2MBCPU 上单次预测 15ms。5.2 改造auto_reply/handler.py插入意图识别钩子打开auto_reply/handler.py找到handle_message()方法。在调用match_rule()之前插入意图识别逻辑# auto_reply/handler.py from utils.nlp_helper import TextCategorizer class MessageHandler: def __init__(self, config): self.config config # 加载意图分类器只加载一次 self.intent_classifier TextCategorizer( model_pathdata/intent_model.pkl, vocab_pathdata/vocab.json ) def handle_message(self, event: MessageEvent) - Optional[str]: # Step 1: 先做意图识别仅对含中文的文本 if re.search(r[\u4e00-\u9fa5], event.text_content): intent, confidence self.intent_classifier.predict(event.text_content) logger.debug(fIntent detected: {intent} (conf: {confidence:.2f})) # Step 2: 根据意图动态选择规则组 if intent 退课 and confidence 0.7: # 覆盖默认规则走高优退课流程 return self._get_refund_policy(event) elif intent 系统故障 and confidence 0.6: return 系统正在紧急修复预计 1 小时内恢复。给您带来不便深表歉意 # Step 3: 回退到原有规则匹配 return self.match_rule(event.text_content) def _get_refund_policy(self, event: MessageEvent) - str: 退课专属话术可对接教务系统 API return ( 退课流程如下\n 1️⃣ 登录教务系统 → 我的课程 → 退课申请\n 2️⃣ 填写原因必填→ 提交\n 3️⃣ 教务处 3 个工作日内审核\n\n ⚠️ 注意开课后第 3 周起不可退课 )5.3 验证效果用 curl 模拟真实对话流# 发送一条「退课」相关消息 curl http://localhost:8000/callback?text我想退掉《机器学习导论》这门课sender_idu1001chat_idg2001 # 控制台会输出 # [DEBUG] Intent detected: 退课 (conf: 0.82) # [INFO] Reply sent: 退课流程如下...你会发现这条回复和rules.yaml里任何一条都不匹配——它是handle_message()里硬编码的逻辑。但你完全可以把它改成调用requests.get(https://jwxt-api/withdrawal?course_idml101)拿到实时课表数据再拼回复。从那以后我每次加新业务逻辑都强制走一遍「mock → unit test → integration test」三步先用pytest tests/test_auto_reply.py::test_intent_routing跑单测再用curl模拟端到端最后在dev_mode下用真实群聊发几条测试。这套节奏让我在 3 个教育类客户项目里没出过一次线上意图识别误判事故。希望帮到你。本文还有配套的精品资源点击获取
企业数字化 ERP 产品动态
相关推荐
二自由度悬架传递函数与多阻尼对比:频响曲线解析与底盘调校 简介:这份资源围绕二自由度悬架模型展开,用传递函数与多阻尼对比的方式分析车辆垂直动态特性,面向车辆工程、汽车动力学方向的学生与工程师,以及需要做悬架性能评估和参数优化的研究者。压缩包内共1个文件,为MATLAB脚本… · 2026/11/16 9:56:45
Hy-SimulMT vs 商业API与CATTI级译员:3秒StreamLAAL实测数据全解读 Hy-SimulMT vs 商业API与CATTI级译员:3秒StreamLAAL实测数据全解读 【免费下载链接】Hy-SimulMT-30B-A3B-GGUF 项目地址: https://ai.gitcode.com/hf_mirrors/tencent/Hy-SimulMT-30B-A3B-GGUF
Hy-SimulMT-30B-A3B 是腾讯混元开源的低延迟、高质量实时同声传… · 2026/11/16 9:50:49
年轻人正在抛弃帆布鞋?帆布鞋为啥卖不动了? 曾经,能够买一双品牌帆布鞋是多少年轻人的梦想?在我小时候,只有最有钱的孩子才能有一双帆布鞋,当时的感觉就是时髦帅气,但是时过境迁,如今年轻人正在抛弃帆布鞋的消息传来,帆布鞋为啥卖不动了&a… · 2026/11/16 13:30:07
中级电工证哪里领补贴多少钱别白交培训费 中级电工证哪里领补贴多少钱别白交培训费 怕考不过白交培训费?中级电工证哪里领补贴多少钱,其实不是你想的那么简单,很多人报完培训班,结果要么考不过,要么不知道怎么领补贴,最后钱花了,证也没拿到。今天就以商丘房建工程从业者的角度,给你讲清楚中级… · 2026/11/17 5:23:38
西安电工证在哪里审验多久拿证怎么考更稳妥 西安电工证在哪里审验多久拿证怎么考更稳妥 实操考试心里没底怕挂科?西安电工证审验流程和通过率你知道多少?很多人在考电工证前,最担心的就是实操考试不过关,或者审验流程复杂,耽误后续上岗。别担心,今天就带你一步步了解西安电工证在哪里审验、多久能… · 2026/11/17 5:23:38
之前考的证在外省能不能转过来?办电工作业证多钱在哪考全解析 之前考的证在外省能不能转过来?办电工作业证多钱在哪考全解析 之前考的证在外省能不能转过来?我去年在山西考的低压电工证,现在在河南新乡工作,最近听说单位要统一换证,我直接懵了。这不就是很多像我一样的人遇到的问题吗? 办电工作业证多钱在哪考… · 2026/11/17 5:23:38
电工证丢那考阳江实操考试怎么过?电子证书到底值不值? 电工证丢那考阳江实操考试怎么过?电子证书到底值不值? 实操考试心里没底怕挂科,尤其是像你这种在平顶山水利工地干活的电工,考个低压或高压电工证,不光是为了拿证,更是为了以后能安心干下去。现在阳江的电工实操考试流程、考试内容和电子证书的含金量,… · 2026/11/17 5:23:38
曲靖职教园区考电工证电子证书怎么查才靠谱 曲靖职教园区考电工证电子证书怎么查才靠谱 你是不是正盯着“曲靖职教园区考电工证”这几个字发愁?担心自己被中间人骗钱?别急,咱们一步步来。尤其是第一次报名的人,最容易在“去哪儿报”“怎么查电子证书”上犯迷糊。别让一张证耽误了你几年的工作机会。… · 2026/11/17 5:23:38
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/16 3:21:55
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/16 3:01:18
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/16 8:30:17
安徽特种工考证学校千万别踩坑,学历不高也能考证上岗 安徽特种工考证学校千万别踩坑,学历不高也能考证上岗 你是不是总觉得学历不高就考不了证,连报名资格都够不上?其实,很多人和你一样,学历不占优势,但想通过考证转行或提升自己的职业竞争力。安徽特种工考证学校虽然门槛不高,但千万别踩坑,稍有不慎就会… · 2026/11/17 0:00:20
你没学历也能考福田特种作业操作证?真实经历告诉你怎么干 你没学历也能考福田特种作业操作证?真实经历告诉你怎么干 你是不是觉得学历不高就考不上福田特种作业操作证?其实不然,我有个老乡,初中毕业,现在在安阳干焊工,每月拿8000多,还评上了高级技师。他的经历我今天就给你说说,看看你能不能照着走。… · 2026/11/17 0:00:20
低压电工证哪里盖章怎么报名 过期了别慌教你一步步复审 低压电工证哪里盖章怎么报名 过期了别慌教你一步步复审 证书过期了不知道怎么复审延期?低压电工证是很多电工从业者必须持有的证件,一旦到期未及时办理复审,不仅影响工作,还可能面临被单位辞退甚至罚款。今天我就从南阳地区培训机构学员的角度,详细告诉… · 2026/11/17 0:00:20
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:43
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:57
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:48