# 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`（保留不动）。