docs: architecture design doc + gitignore update

架构文档记录方案一（GDB Hook）的技术路线和关键信息源。 .gitignore 新增 *.AppImage / *.exe / *.dll 规则
2026-06-23 21:24:20 +08:00
parent 1417552990
commit 9c73e8b107
2 changed files with 46 additions and 0 deletions
@@ -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-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`（保留不动）。