docs: complete handover documentation for Mohe

重写 architecture.md 含:
- 完整方案评估(GDB vs LD_PRELOAD vs wine vs iLink)
- 所有信息源链接和参考价值
- 当前状态检查清单(已完成/待完成)
- 分 Phase 的实施指南
- 常见问题和风险说明
- 项目文件结构

更新 README.md 指向架构文档
This commit is contained in:
2026-06-23 23:12:47 +08:00
parent 9c73e8b107
commit 255729bb8c
2 changed files with 233 additions and 73 deletions
+16 -44
View File
@@ -1,52 +1,24 @@
# MoWeChat — 莫荷微信 Bot (Linux iLink 版)
# MoWeChat — 莫荷微信 Bot (Linux 版)
将莫荷的微信 bot 从 Windows wxhelper DLL 注入方案迁移到 Linux 原生运行的腾讯官方 iLink Bot API
将莫荷的微信 bot 从 Windowswxhelper DLL 注入迁移到 Linux 原生运行。
## 架构
**技术方案:官方 Linux 微信 AppImage + GDB Hook**
```
微信 → iLink Bot API (ilinkai.weixin.qq.com) → wechat_agent.py → Hermes Gateway (:8642) → Agent
```
## 快速导航
- **iLink Bot API**: 腾讯 2026 年开放的官方微信个人号 Bot 接口
- **weixin-bot-sdk**: Python SDK,处理 QR 登录、长轮询收消息、发消息
- **Hermes Gateway**: 原有的 LLM 处理管道,无变动
- **架构文档**`docs/architecture.md`(所有方案评估、信息源、接入须知)
- **GDB Hook 脚本**`hooks/gdb_hook_messages.py`(待实现)
- **微信安装包**`WeChatLinux.AppImage`(已下载,276MB,最新版)
- **Windows 原版**`../scripts/wechat_agent.py`(保留不动)
## 快速开始
## 当前状态
```bash
cd gateway/linux
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
python3 wechat_agent.py
```
✅ 项目结构 + 依赖安装 + 微信下载
⏳ GDB Hook 脚本(待实现)→ 莫荷接手
首次运行会显示二维码,用莫荷的手机微信扫码登录。凭证保存在 `~/.weixin-bot/credentials.json`,后续运行自动跳过扫码。
## 注意事项
## 与 Windows 版的差异
| 功能 | Windows (wxhelper) | Linux (iLink) |
|------|-------------------|---------------|
| 消息收发 | DLL 注入 → HTTP | 官方 API → HTTP |
| QR 登录 | 降版本微信手动登录 | 终端二维码扫码 |
| 图片 OCR | doubao API | doubao API ✅ |
| 文章处理 | article_processor | article_processor ✅ |
| 图片生成 | SenseNova | SenseNova ✅ |
| 联系人查询 | wxhelper API | ❌ iLink 不支持 |
| 历史记录查询 | wxhelper SQL | ❌ 改用 session_search |
| 文件发送 | wxhelper sendFile | 发送下载链接 |
| 5801 端口 | 支持 | 支持 ✅ |
## 服务管理
systemd service:
```bash
sudo cp mohe-wechat.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable mohe-wechat
sudo systemctl start mohe-wechat
```
## 日志
日志文件:`../../logs/wechat_agent_linux.log`
- **不走 ClawBot/iLink** — 详见 `docs/architecture.md`
- **不走 wine** — 3.9.x 微信登录已被腾讯封禁
- **不走降版本工具** — 已损坏
- 唯一可行路线:**Linux 原生微信 + GDB Hook**