docs: architecture design doc + gitignore update

架构文档记录方案一(GDB Hook)的技术路线和关键信息源。
.gitignore 新增 *.AppImage / *.exe / *.dll 规则
This commit is contained in:
2026-06-23 21:24:20 +08:00
parent 1417552990
commit 9c73e8b107
2 changed files with 46 additions and 0 deletions
+5
View File
@@ -38,3 +38,8 @@ node_modules/
# OS
.DS_Store
Thumbs.db
# Large binaries
*.AppImage
*.exe
*.dll
+41
View File
@@ -0,0 +1,41 @@
# 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-beta2年前) |
| 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 APIClawBot 方案,已排除) |
## 版本管理
代码在 `AgentsMeeting/gateway/linux/` 目录下,git 仓库为 `AgentsMeeting` 项目。
原始 Windows 版在 `AgentsMeeting/gateway/scripts/wechat_agent.py`(保留不动)。