微信UI自动化项目对比:wxauto / wechatauto-replica / WXAUTO_SE / WeChatAuto.SDK / wechat-automation-api

调研日期:2026-08-31 | 数据来源:GitHub API(星标/归档状态/issue/release 实测)、PyPI(pypistats 下载量实测)、各仓库 README
目录定位:微信 PC 客户端 UI 自动化(UIAutomation/RPA,非 hook、非协议) 路线的自动回复/机器人方案统一收在此文件。与 AI社交项目对比(聊天应用层)互补。

⚠️ 背景知识:微信 4.x 是分水岭(2026 年格局)

  • UI 自动化原理:用 Windows UIAutomation/键鼠模拟操作”真人微信客户端”,官方风控视角最接近真人操作,是当前个人微信号风险最低的自动化路线(hook 注入 dll 的路线已集体退场:WeChatFerry 6797★、NGCBot 3302★ 均已归档)。
  • 版本分水岭:微信 4.x 客户端改用自绘渲染,抛弃了 UIA 无障碍树,导致经典 wxauto 一代方案整体失效。4.x 时代的存活方案要么走”本地数据库解密(SQLCipher4) + UIA/OCR 混合发送”(wechatauto-replica),要么靠厂商持续适配新版本(WeChatAuto.SDK)。
  • 封号共识:个人微信号任何非官方自动化都有风险;UI 自动化最低但不是零。社区共识是用小号、控制频率、勿群发加粉。

一句话对比

项目 星标 下载/月 License 微信版本 定位 活跃度 上手
A. wxauto 7286★ · 1382 fork PyPI 135(转官网分发) Apache-2.0 仅 3.9.x UI 自动化事实标准,生态最大 🔴 开源版 2025 冻结转商业 低
B. wechatauto-replica 134★ PyPI 6882 Apache-2.0 4.1.12+ wxauto 的 4.x 兼容替代品 🟢 极活跃(当日发版) 中
C. WeChatBot_WXAUTO_SE 879★ - - 3.9.x 成品”微信AI自动回复”应用(wxauto+LLM) 🔴 停止维护 中(当模板抄)
D. WeChatAuto.SDK 255★ - MIT(80%开源) 3.9.12.x + 4.1.11.x .NET 微信 RPA SDK 🟢 很活跃(当日提交) 中(需.NET)
E. wechat-automation-api 171★ - 无(未声明) 4.0+ 给 AI Agent 用的”发微信”Skill/HTTP API 🟡 维护中 低

📌 定位区分:A/B/D 是库(自己写代码)、C 是现成应用(装上就能 AI 自动回复)、E 只管发送不管接收(Agent 主动推送场景)。收+发+AI 回复的完整闭环:3.9.x 选 C 的代码/A 自己写,4.x 选 B。


A. wxauto —— 微信 UI 自动化事实标准(生态最大,已冻结转商业)

背景简介

  • ⭐ 7286★ · 1382 fork · Apache-2.0 · Python · 2021-08-15 创建 · 最后推送 2026-04-13(开源版冻结,README 自标 “2021-2025”)
  • 仓库:https://github.com/cluic/wxauto | 官网 https://wxauto.org | 文档 https://docs.wxauto.org
  • 定位:Windows 微信客户端(非网页版)UIAutomation 自动化库,发消息、收消息、简单机器人——本领域 star 最多、下游生态最大的”事实标准”

怎么用·依赖·配置·上手难度(低)

  • 环境:Windows 10/11/Server2016+ · 微信 3.9.X(需降级安装指定版本,README 附百度网盘)· Python 3.9+
  • pip install wxauto(公共 PyPI 包已停更,现走官网/文档渠道分发);几行代码即可发消息、监听新消息
  • 上手极低:初始化 WeChat 对象 → SendMsg/Listen,中文文档和教程全网最多

核心能力

  • 发送文本/图片/文件、@群成员、监听新消息、获取会话列表与联系人、自动回复示例
  • 大量下游生态(见文末”wxauto 生态”):HTTP API 封装、管理面板、群聊 AI 总结、AstrBot 桥接等

对用户的价值

  • 教程最全、踩坑资料最多,微信 3.9.x 下五分钟跑通自动回复
  • 纯 UI 自动化(不注入、不碰协议),封号风险在所有路线里最低

能力边界

  • ❌ 只支持微信 3.9.x:4.x 自绘渲染后 UIA 树失效,官方 wxauto4 适配尝试已标”停止更新”
  • ❌ 开源版冻结:作者重心转向付费版 wxautox(专业版 pip 包月下载 764,付费解锁)
  • ⚠️ README 免责声明”禁止用于实际生产项目和商业用途”
  • ⚠️ PyPI 公共包月下载仅 135 次、issue 区最新一条停留在 2024-12——社区已迁移,靠存量教程续命

B. wechatauto-replica —— 微信 4.x 接班者(DB 解密 + UIA/OCR 混合)

背景简介

  • ⭐ 134★ · 月下载 6882(PyPI 实测) · Apache-2.0 · Python · 2026-08-07 创建 · 极活跃(2026-08-30 当天发 v1.2.0,一周内 5 个 release)
  • 仓库:https://github.com/fanyuantaier/wechatauto-replica
  • 定位:wxauto 的 微信 4.x 兼容替代品(drop-in 风格):经典 wxauto 依赖的 UIA 树被 4.x 抛弃后,本项目改用”读消息走本地 SQLCipher4 数据库解密,发消息走 UIA + OCR 混合驱动(自动降级)“

怎么用·依赖·配置·上手难度(中)

  • 环境:Windows 10/11 · 微信 4.1.12+ · Python 3.9+(3.12 验证)· pip install wechatauto-replica
  • 读消息/导历史无需额外操作(直接读 xwechat_files/.../db_storage/ 加密库);发送路径可选装 OCR 依赖(winsdk + pypinyin)
  • 提供 GUIDE.md 双语使用指南,API 风格对 wxauto 用户友好

核心能力

  • 实时消息监听(增量轮询 + 每会话工作线程)、表情消息截图捕获
  • 全量历史导出(JSON/SQLite)、媒体下载(图片 v2 AES 解密、SILK 语音、原图触发下载)
  • 朋友圈读取(直接读 sns.db,README 称 3382 条 feed 实测)、多账号管理
  • 发送:文本/文件/图片/引用回复/@成员;语音通话、拍一拍(UIA 按钮 + OCR 菜单兜底)
  • UIA 树热激活:向 Weixin.dll 写入 Qt 无障碍开关后也能用标准 UIA

对用户的价值

  • 当前唯一活跃维护、功能完整的微信 4.x 自动化开源方案,且是 PyPI 实际下载量最大的本领域包
  • 读(DB 解密,稳定全量)+ 发(UIA/OCR,拟人)混合架构,绕开了 4.x 无障碍树缺失的死局

能力边界

  • ❌ 太新:2026-08 才创建、2 位贡献者、单人主导,长期维护风险未知
  • ⚠️ 读消息本质是数据库解密——依赖本机登录态可拿到密钥,属于”本地数据分析”边界玩法
  • ⚠️ 发送走坐标 + OCR 兜底,稳定性受分辨率/主题/弹窗干扰影响
  • ⚠️ star 少(134),社区沉淀尚薄,遇坑主要靠 issue 直连作者

C. WeChatBot_WXAUTO_SE —— 成品”微信AI自动回复”应用(已停更,最佳模板)

背景简介

  • ⭐ 879★ · Python · 基于 wxauto(收发)+ LLM API 聚合(大脑)· v3.25.1 · README 首行即【停止维护】
  • 仓库:https://github.com/iwyxdxl/WeChatBot_WXAUTO_SE (改自 KouriChat 生态,上游 KouriChat 3239★)
  • 定位:开箱即用的微信 AI 自动回复/陪伴机器人成品——UI 自动化路线里功能清单最全的完整应用

怎么用·依赖·配置·上手难度(中)

  • 微信 3.9.x + Python + 自备任意 LLM API(聚合多模型);WebUI 完成启动/改配置/管理 Prompt
  • 作为应用直接部署可用;更适合当模板抄:把它的监听/回复/记忆框架嫁接到自己的代码上

核心能力

  • 智能自动回复:多用户/群聊并发,每用户或群聊独立 Prompt
  • 图片与表情包识别、情绪识别并回表情包、消息内链接网页内容获取、联网搜索
  • AI 时间感知(年月日星期时分秒)、主动发消息、多条消息合并处理
  • 记忆功能:AI 总结聊天记录存入 Prompt 或独立核心记忆文件
  • 定时任务(”15 分钟后提醒我出门””每天早上六点叫我起床”,支持语音通话提醒)
  • 前端 WebUI;接收语音消息

对用户的价值

  • 想快速拥有”微信小号=AI 女友/客服”的完整参考实现,功能设计可直接借鉴
  • 所有”AI 自动回复产品”该有的细节(独立人设、记忆、主动消息、情绪)都已实现过一遍

能力边界

  • ❌ 已停止维护(明确声明),issue 不再处理
  • ❌ 上游 KouriChat 明确【禁止接入微信、QQ 等腾讯系软件】——法律与合规态度暧昧
  • ⚠️ 依赖 wxauto,仅支持微信 3.9.x;⚠️ 项目声明仅供学习 LLM 交流,勿用于生产

D. WeChatAuto.SDK —— .NET 生态微信 RPA SDK(新旧版本通吃)

背景简介

  • ⭐ 255★ · MIT · C#/.NET 6+(附官方 Python SDK,要求 Python 3.13+)· 2026-08-30 当天仍在提交
  • 仓库:https://github.com/scottfly189/WeChatAuto.SDK
  • 定位:面向 AI 集成场景的微信 RPA 自动化框架,基于 .NET UI 自动化技术,同时兼容微信 3.9.12.x 与 4.1.11.x 并持续适配新版

怎么用·依赖·配置·上手难度(中)

  • .NET 6+ 环境(NuGet 引入),或用官方 Python SDK(3.13+)跨语言调用
  • 支持”纯软件自动化”与”硬件键鼠模拟器”双方案,按业务风险等级选择更稳妥的执行方式

核心能力

  • 消息:发文字/表情/文件、@提醒、转发、消息监听
  • 社交:群管理、朋友圈操作、通讯录管理
  • 架构:多微信实例管理 + 分布式(WebSocket 长连接,一台应用控制多台机器的多微信)
  • 重要接口均覆盖单元测试

对用户的价值

  • .NET 技术栈下几乎唯一的微信自动化选择;新旧版本通吃且在持续适配
  • 多实例+分布式设计适合需要同时挂多个小号的业务形态(如客服矩阵)

能力边界

  • ⚠️ 80% 开源(20% API 属 VIP 独有),深度功能需付费
  • ⚠️ 项目年轻(255★)、社区小,文档以视频+中文为主
  • ⚠️ Python 侧要求 3.13+,对环境有额外要求

E. wechat-automation-api —— 给 AI Agent 用的”发微信” Skill

背景简介

  • ⭐ 171★ · 41 fork · 未声明 License · 2025-10-31 创建 · 2026-06-01 推送
  • 仓库:https://github.com/LAVARONG/wechat-automation-api
  • 定位:微信 Windows 版自动化发送服务(支持 4.0+):Flask + uiautomation 封装成 HTTP API,核心卖点是Agent Skill 入口——用自然语言指挥智能体发微信

怎么用·依赖·配置·上手难度(低)

  • 三种入口:Skill(推荐,”请帮我安装部署这个 skill…”一句指令让智能体自己装好并试发)、CLI(单次执行即退)、HTTP API(Flask 后台,适合外部系统长期集成/批量/队列)
  • 环境:Windows 10/11 · Python 3.7+ · 微信 PC 端已登录
  • 不使用 Hook、不接入微信协议,只操作本机微信窗口

核心能力

  • 发送文本、图片 URL、本地文件
  • 自然语言玩法示例:查新闻→整理→发到指定联系人;下载图片→转发;报告 xlsx→发送
  • 与 ZCode/Codex 这类 Agent 工作流天然契合(SKILL.md 标准格式)

对用户的价值

  • “AI 主动给我发消息”场景的最快实现:让 Agent 把任务结果、监控告警、日报通过微信推送到手机
  • 支持 4.0+,无需降级微信

能力边界

  • ❌ 只发不收:没有消息监听/自动回复能力,做不了完整客服闭环
  • ⚠️ 未声明 License(默认保留所有权利),商用需联系作者
  • ⚠️ 171★ 小项目,单人维护

📊 五者对比总结

维度 A. wxauto B. wechatauto-replica C. WXAUTO_SE D. WeChatAuto.SDK E. wechat-automation-api
形态 Python 库 Python 库 成品应用 .NET SDK Skill/CLI/HTTP
微信版本 3.9.x 4.1.12+ 3.9.x 3.9.12.x+4.1.11.x 4.0+
收+发闭环 ✅ ✅ ✅(应用级) ✅ ❌ 只发
星标 7286 134 879 255 171
实际热度 官网分发+存量教程 PyPI 6882/月 模板被大量fork 当日仍在提交 中
维护状态 🔴 冻结转商业 🟢 当日发版 🔴 停更 🟢 活跃(80%开源) 🟡 维护中
技术路线 纯 UIA DB解密+UIA/OCR wxauto+LLM UIA+硬件模拟 纯 UIA
二次开发自由度 高 高 中(抄代码) 高(20% VIP) 高

怎么选:

  • 微信已升级 4.x、Python 技术栈、要完整收发 → wechatauto-replica(唯一活跃的 4.x 方案,接受其年轻风险)
  • 愿意锁死微信 3.9.x、要最多教程 → wxauto(接受冻结与免责条款)
  • 要现成 AI 自动回复成品/找实现模板 → 抄 WXAUTO_SE 代码(不建议原样上线:停更+上游禁微信)
  • .NET 技术栈 / 多号矩阵 / 风控敏感 → WeChatAuto.SDK
  • 只要 AI 主动推送消息(日报/告警/任务结果) → wechat-automation-api
  • 商用稳定优先 → 不碰个人微信自动化,走企业微信/公众号官方接口(CowAgent 等框架的官方通道)

社区反馈与可靠性

  • wxauto:7286★ 为本领域最高,但 2025 年冻结、作者转商业 wxautox;公共 PyPI 月下载仅 135、issue 区 2024-12 后停滞——存量价值高、增量投入归零。教程多是其最大资产
  • wechatauto-replica:star 仅 134 但 PyPI 月下载 6882(远超 wxauto 公共包),一周 5 个 release——真实需求旺盛的新晋方案;风险是单人项目、历史太短
  • WeChatBot_WXAUTO_SE:879★,停止维护且上游 KouriChat 明确禁止接入微信;但作为功能最全的成品模板,代码被大量参考——参考价值 > 部署价值
  • WeChatAuto.SDK:2026-08-30 仍在提交,MIT + 80% 开源(20% VIP API),主力单人开发;年轻但节奏健康
  • wechat-automation-api:171★,维护中;无 License 是商用硬伤
  • 大局观:两大 hook 项目 WeChatFerry(6797★)与 NGCBot(3302★)双双归档,wcferry Python 包仍有 6340 月下载的存量使用;JS 侧由 wechatferry 组织(2079★)接棒并给 Wechaty 提供”免费 PC Hook puppet”。hook 路线退潮、UI 自动化/DB 解密混合成为个人微信自动化的主流方向
  • 避坑:easyChat(搜索索引显示 1478★)实测仓库已 404(删库/转私有),不要再找它;WeChatPYAPI(1053★)社区版锁死微信 3.6.0.18 且不再维护,实为付费专业版引流,不建议

📌 未来微信自动化规划(入口)

  • 短期:微信 UI 自动化项目统一收在此文件(五项目对比)
  • 可选:跟进 wechatauto-replica 稳定性(若持续维护可升级为主力方案);商用客服场景另起一篇调研企业微信官方接口路线

refer

声明:

  1. 若文章存在错误,望诸君不吝指正^

  2. blog 仅供个人记录学习所用

  3. 部分笔记由于年代久远,做的笔记找不到最初是引用谁的,若是不允许引用转载,请联系我