AgentsMeeting/gateway/linux/docs/architecture.md

MoWeChat — 莫荷微信 Bot (Linux GDB Hook 版)

架构设计

┌─────────────────────────────────────────────────────────────┐
│ Linux 服务器                                                │
│                                                             │
│  ┌──────────────────────┐     ┌────────────────────────┐    │
│  │ 微信 Linux AppImage  │     │ wechat_agent_gdb.py    │    │
│  │ (官方原生, 最新版)     │     │ (主控脚本)              │    │
│  │                      │     │                        │    │
│  │ 正常扫码登录          │◄───►│ GDB Python API 附加     │    │
│  │ 消息接收 → GDB断点    │     │ 断点触发 → 提取消息     │    │
│  │ 消息发送 → GDB call   │     │ 处理 → Hermes :8642    │    │
│  └──────────────────────┘     └─────────┬──────────────┘    │
│                                         │                   │
│                                         ▼                   │
│                              ┌────────────────────┐         │
│                              │ Hermes Gateway     │         │
│                              │ :8642 → Agent处理  │         │
│                              └────────────────────┘         │
└─────────────────────────────────────────────────────────────┘

关键信息源

来源	链接	内容
Ajax's Blog (2026-03)	https://aajax.top/2026/03/11/GettingLinuxWechatMessages/	GDB + Python 方案核心参考。用 GDB 调试 Linux 微信 AppImage 4.1.0.16，拦截消息接收函数，Python 脚本提取消息内容。包含 Docker 封装。
看雪论坛	https://bbs.kanxue.com/thread-282965.htm	原始思路：GDB 分析 Linux 微信消息内存地址，Hook 打印明文消息
lmclmc/linux-wechat-hook	https://github.com/lmclmc/linux-wechat-hook	LD_PRELOAD 注入 libX.so 方案（旧版 wechat-beta，2年前）
52pojie 教程	https://www.52pojie.cn/thread-1955523-1-1.html	lmclmc 方案的讲解教程
Hermes Weixin 文档	https://hermes-agent.nousresearch.com/docs/zh-Hans/user-guide/messaging/weixin	Hermes 内置 iLink 平台说明（ClawBot 方案，已排除）
weixin-bot-sdk	https://github.com/epiral/weixin-bot	官方 iLink API（ClawBot 方案，已排除）

版本管理

代码在 AgentsMeeting/gateway/linux/ 目录下，git 仓库为 AgentsMeeting 项目。

原始 Windows 版在 AgentsMeeting/gateway/scripts/wechat_agent.py（保留不动）。