wechat-resonance
Health Warn
- License — License: Apache-2.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Connect AI to WeChat desktop: Windows GUI automation, local message reading, and a VPS bridge. ChatGPT Work / MCP Events edition.
WeChat Resonance
让 AI 通过工具调用使用 Windows 官方微信 4.x:本地适配器读取私聊文字,AI 生成回复,再由 微信 GUI 自动化 把文字发回原会话。
技术核心:本地 DB 读取 + 微信 GUI 自动化
Windows 侧基于 wechatauto-replica。AI 通过 Bridge 下发结构化回复,真正执行微信窗口操作的是 Windows 适配器。
| 环节 | 实际执行方式 |
|---|---|
| 收消息 | WeChatDB + Listener 从本地微信数据库读取指定会话的新文字;生成 eventId,通过 HTTPS 上报 VPS。 |
| 让 AI 处理 | 官端通过 MCP Events 唤醒 Work,模型调用读取/回复工具;Codex 路线由服务端请求网关并续接对应 thread。 |
| 发消息 | Windows 长轮询取回待发指令,调用 WeChatGUI.send_msg(text, who, verify=True),打开会话、输入文字并发送。 |
| 确认结果 | 发送后回读本地微信数据库,确认新发出的消息,再向 VPS 回报 ACK;已完成的 command 不重复发送。 |
GUI 发送优先使用 UIA,必要时走 Win32 窗口定位、坐标与 Windows OCR,配合剪贴板粘贴和点击发送。微信必须保持登录,Windows 桌面需要解锁并能操作微信窗口;锁屏或交互会话断开会影响 GUI 发送。
两条 AI 路线共用这套 Windows 收发层。 本仓库提供的是 官端 GPT / Work 的最小文字版源码;Codex 的持久化 inbox、网关和前端同步属于另一条实现路线,目前仅分享架构思路。
本项目按实际验证的官端链路设计:
Windows WeChat → Windows Adapter → VPS Bridge → MCP Events → ChatGPT Work → VPS Bridge → Windows WeChat
如果你要迁移到 API、第三方前端或其他 MCP Host,可以基于现有协议自行调整 Bridge、唤醒和工具调用方式。
当前公开版只保留 文字聊天接力。图片、语音、文件、朋友圈、拍一拍等能力不在 v0 范围内。
仓库里有什么
wechat-resonance/
├─ adapter.py # Windows 微信文字收发
├─ supervisor.py # 等待微信、拉起 Adapter、崩溃重启
├─ install-autostart.ps1 # Windows 登录后自动启动
├─ bridge/ # VPS 侧最小 Bridge
│ ├─ src/
│ │ ├─ wechat/ # ingress / long poll / ACK / burst
│ │ └─ events/ # MCP Events / webhook / watchdog
│ ├─ test/
│ └─ README.md
├─ docs/
│ ├─ END_TO_END.md
│ ├─ VPS_BRIDGE.md
│ ├─ WORK_MCP_EVENTS.md
│ ├─ BRIDGE_PROTOCOL.md
│ └─ DEPLOY.md
└─ assets/
└─ architecture-flow.svg
Windows 负责真实微信读写;VPS Bridge 负责排队、MCP Events 唤醒、Work 工具调用和回复回传;模型推理发生在 ChatGPT 官端。
当前能力
- 监听指定微信私聊的文字消息
- 把连续短消息合并成一轮对话
- 通过 MCP Events 唤醒 ChatGPT Work
- Work 使用
wechat_bridge_get_event读取当前微信消息 - Work 使用
wechat_bridge_reply把回复送回微信 - Bridge 长轮询下发待发送文字
- Windows 侧确认真实发送结果并回 ACK
- 稳定 command ID 与重复发送抑制
- Windows 登录后自动启动
- Adapter 异常退出后自动拉起
- MCP Events subscription 持久化
- Work wake watchdog
- 单目标微信会话白名单
非文字消息会被 Windows Adapter 直接忽略。
环境要求
Windows
- Windows 10 / 11
- 官方微信桌面版 4.x,且已登录
- Windows 交互桌面保持解锁,微信窗口可操作
- Python 3.12+
wechatauto-replica
当前依赖固定在经过验证的 upstream commit:
wechatauto-replica @ git+https://github.com/fanyuantaier/wechatauto-replica.git@91dc0e1
VPS
- Linux VPS
- Node.js 22
- 一个可通过 HTTPS 访问的域名
- Caddy / Nginx 等反向代理
ChatGPT
- 可使用 Work 与 MCP Events 的 ChatGPT 环境
- 已连接本项目 Bridge MCP endpoint 的插件
MCP Events 的实际可用范围以 ChatGPT 当前产品和工作空间设置为准。
1. 部署 VPS Bridge
克隆仓库:
git clone https://github.com/yanceydaisy/wechat-resonance.git
cd wechat-resonance/bridge
安装、检查并构建:
npm ci
npm run typecheck
npm run build
npm test
配置:
PORT=8787
HOST=127.0.0.1
WECHAT_AGENT_TOKEN=<a long random token>
MCP_EVENTS_PATH_TOKEN=<a long url-safe random token>
MCP_EVENTS_STORE_PATH=.local/mcp-event-subscriptions.json
启动:
npm start
详细部署、systemd 与反向代理说明见 VPS Bridge 部署。
2. 部署 Windows Adapter
在仓库根目录创建虚拟环境:
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
设置三个 Windows 用户环境变量:
WECHAT_BRIDGE_URL=https://your-bridge.example.com
WECHAT_AGENT_TOKEN=<same token as VPS>
WECHAT_TARGET=wxid_replace_me
其中:
WECHAT_BRIDGE_URL:VPS Bridge 的 HTTPS 地址WECHAT_AGENT_TOKEN:Windows Adapter 专用 Bearer tokenWECHAT_TARGET:允许监听和回复的单个微信会话 wxid
不要把真实 token 或 wxid 提交到 Git。
先手动运行:
.\.venv\Scripts\python.exe .\adapter.py
确认 Listener、outbound sender 和 heartbeat 正常后,再安装自启动:
.\install-autostart.ps1
Windows 侧详细排错见 部署与排错。
3. 在 ChatGPT Work 订阅 MCP Events
Bridge 的 MCP endpoint 形态:
https://your-bridge.example.com/mcp/events/<MCP_EVENTS_PATH_TOKEN>
将它连接为 ChatGPT 插件的 MCP 服务,并确认可以发现:
事件
wechat.bridge.requested
工具
wechat_bridge_get_event
wechat_bridge_reply
然后在 Work 对话中订阅:
wechat.bridge.requested
{"source":"wechat.dm"}
完整的自然语言订阅指令、验证步骤和排错见 ChatGPT Work MCP Events。
Bridge HTTP 接口
Windows Adapter 只依赖四个 HTTP 接口:
| 方法 | 路径 | 作用 |
|---|---|---|
POST |
/wechat/agent/events |
上报微信文字消息 |
GET |
/wechat/agent/next |
长轮询下一条待发送文字回复 |
POST |
/wechat/agent/result |
回报发送成功 / 失败 |
POST |
/wechat/agent/heartbeat |
心跳 |
这些接口都使用 Windows Adapter 专用 Bearer token。字段说明见 Bridge Protocol。
可靠性
Windows 入站
Adapter 为每条微信文字消息生成确定性的事件 ID:
wechat:<target>:<create_time>:<local_id>
短暂网络错误会在本地重试;Bridge 对重复事件做去重。
Windows 出站
成功发送到微信的 command ID 会写入:
.local/delivered_commands.json
如果 ACK 丢失后 Bridge 再次下发相同 command,Adapter 会抑制重复发送,只补成功回执。
Work 唤醒
MCP Events webhook 返回 2xx 只表示通知已经被平台接收,不等于 Work 已经开始或完成本轮处理。
Bridge 会保留原 bridgeEventId,由 watchdog 在需要时重新唤醒;一旦回复进入实际发送流程,watchdog 不再制造第二份回复。
VPS 重启
MCP Events subscription 会持久化保存。
当前 conversation queue、burst buffer 和尚未 ACK 的出站 command 仍包含内存状态,因此 VPS 在消息处理过程中重启时,未完成消息可能无法自动恢复。长期运行时可以把这些状态迁移到 SQLite、Postgres 或其他持久化队列。
已验证范围
当前公开版按以下链路实现和验证:
WeChat text
→ Windows Adapter
→ VPS Bridge
→ MCP Events
→ ChatGPT Work
→ wechat_bridge_get_event
→ wechat_bridge_reply
→ VPS Bridge
→ Windows Adapter
→ WeChat text
Bridge 本地检查包括:
npm run typecheck
npm run build
npm test
项目边界
这一版故意只保留文字流。
需要图片、语音、文件、朋友圈、拍一拍或更多微信桌面自动化能力时,可以直接参考上游 wechatauto-replica 按需扩展。
如果你使用 API、第三方 ChatGPT 前端或其他 MCP Host,也可以基于本仓库现有 HTTP / MCP 结构自行迁移;相关运行方式和兼容性调整请根据自己的环境处理。
更新日志
2026-11-22
- 项目与仓库更名为 WeChat Resonance / 微信共振,仓库地址为
yanceydaisy/wechat-resonance。 - 补充本地 DB 收消息、GUI 发消息、DB 回读确认与 ACK 的具体技术路线,以及桌面解锁要求。
- 区分公开官端源码与 Codex 架构分享。
- v0.2.0:代码、工具、事件、环境变量、启动任务与互斥锁统一使用中性名称;旧标识不再作为运行接口。旧部署升级请按 迁移指南 重新配置并订阅。
- 新部署文档使用
wechat-resonance目录和服务名;已有 VPS 的安装目录、服务名可继续沿用,更新本地 git remote 即可。
git remote set-url origin https://github.com/yanceydaisy/wechat-resonance.git
文档
- v0.2.0 迁移指南:环境变量、计划任务、工具与事件更新
- 端到端链路:从微信消息直到 ChatGPT 回微信
- VPS Bridge 部署:Node.js、HTTPS、systemd、MCP Events
- ChatGPT Work MCP Events:插件、订阅、读取、回复、排错
- Bridge HTTP 协议:文字入站、长轮询、ACK、心跳
- Windows 部署与排错:Adapter 自启动与日志
- Bridge 独立说明
致谢
Windows 微信读写能力来自 wechatauto-replica。
感谢上游作者对微信 4.x 本地数据读取与自动化能力的维护。
License
Apache License 2.0,与上游 wechatauto-replica 保持一致。详见 LICENSE。
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found