docs: complete handover documentation for Mohe
重写 architecture.md 含: - 完整方案评估(GDB vs LD_PRELOAD vs wine vs iLink) - 所有信息源链接和参考价值 - 当前状态检查清单(已完成/待完成) - 分 Phase 的实施指南 - 常见问题和风险说明 - 项目文件结构 更新 README.md 指向架构文档
This commit is contained in:
+16
-44
@@ -1,52 +1,24 @@
|
||||
# MoWeChat — 莫荷微信 Bot (Linux iLink 版)
|
||||
# MoWeChat — 莫荷微信 Bot (Linux 版)
|
||||
|
||||
将莫荷的微信 bot 从 Windows wxhelper DLL 注入方案迁移到 Linux 原生运行的腾讯官方 iLink Bot API。
|
||||
将莫荷的微信 bot 从 Windows(wxhelper 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**
|
||||
|
||||
Reference in New Issue
Block a user