Hermes WeChat 本地闭环架构方案

版本: 2.0 (HTTP API 模式) 日期: 2026-05-22 目标设备: Pixel 10 Fold (Android) 运行环境: Termux + Ubuntu proot-distro 微信版本: 8.0.72

---

1. 目标

在 Pixel 手机本地实现微信全自动闭环：

收到消息 → 读取内容 → HTTP 调用 hermes → 生成回复 → 发送回复

不依赖 Mac 远程 adb，所有组件运行在 Android 本地。

核心设计原则：

• daemon 是常驻后台进程，只负责数据读写和消息收发
• hermes (lemonPCRM) 是独立的 AI 服务，负责 LLM 推理和回复生成
• 两者通过 HTTP API (/api/master/chat) 通信

---

2. 架构总览

┌─────────────────────────────────────────────────────────────────────────────┐
│                           Pixel 手机本地运行环境                               │
│                                                                             │
│  ┌───────────────────────────────────────────────────────────────────────┐  │
│  │                    Ubuntu proot-distro 容器                             │  │
│  │  ┌─────────────────────────────────────────────────────────────────┐  │  │
│  │  │                        hermes (lemonPCRM)                        │  │  │
│  │  │  ┌──────────────┐  ┌──────────┐  ┌──────────┐                 │  │  │
│  │  │  │ Node.js      │  │ Master   │  │ Claude   │                 │  │  │
│  │  │  │ Express      │  │ Session  │  │ CLI      │                 │  │  │
│  │  │  │ :3010        │  │ Manager  │  │ Protocol │                 │  │  │
│  │  │  └──────────────┘  └──────────┘  └──────────┘                 │  │  │
│  │  │         ↑                                                        │  │  │
│  │  │         │ POST /api/master/chat (SSE)                            │  │  │
│  │  │         │ {message, sessionId}                                   │  │  │
│  │  └─────────┼────────────────────────────────────────────────────────┘  │  │
│  │            │                                                             │  │
│  │  ┌─────────┴─────────────────────────────────────────────────────────┐  │  │
│  │  │                        daemon (Python)                             │  │  │
│  │  │  ┌──────────────┐  ┌──────────┐  ┌──────────┐  ┌──────────────┐  │  │  │
│  │  │  │ DB 轮询/     │→ │ 新消息   │→ │ HTTP     │→ │ am broadcast │  │  │  │
│  │  │  │ 通知触发     │  │ 检测     │  │ hermes   │  │ 发送回复     │  │  │  │
│  │  │  └──────────────┘  └──────────┘  └──────────┘  └──────────────┘  │  │  │
│  │  │         ↑                                              │          │  │  │
│  │  │         │                                              │          │  │  │
│  │  │  ┌──────────────┐                          ┌──────────┴─────┐    │  │  │
│  │  │  │ sqlcipher    │                          │ 回复内容       │    │  │  │
│  │  │  │ 解密读取     │                          │ (SSE result)   │    │  │  │
│  │  │  └──────────────┘                          └────────────────┘    │  │  │
│  │  └──────────────────────────────────────────────────────────────────┘  │  │
│  │         ↑                                                              │  │
│  │         │                                                              │  │
│  │  ┌──────────────┐                                          ┌──────────┴──┐│
│  │  │ su -c cp DB  │                                          │ LSPosed     ││
│  │  │ + WAL + SHM  │                                          │ WeChatHook  ││
│  │  └──────────────┘                                          └─────────────┘│
│  └───────────────────────────────────────────────────────────────────────────┘  │
│         ↑                                                              │        │
│         │                                                              ▼        │
│  ┌───────────────────────────────────────────────────────────────────────┐      │
│  │                    Termux 环境 (与 proot 共享 home)                      │      │
│  │  ┌─────────────────────────────────────────────────────────────────┐  │      │
│  │  │ 通知监听线程 (辅助通道)                                          │  │      │
│  │  │  termux-notification-list 每 3 秒轮询                            │  │      │
│  │  │  发现微信通知 → 触发紧急 DB 轮询                                 │  │      │
│  │  └─────────────────────────────────────────────────────────────────┘  │      │
│  │  ┌─────────────────────────────────────────────────────────────────┐  │      │
│  │  │ Termux:Boot 开机自启                                            │  │      │
│  │  │  ~/.termux/boot/start-hermes.sh                                 │  │      │
│  │  └─────────────────────────────────────────────────────────────────┘  │      │
│  └───────────────────────────────────────────────────────────────────────┘      │
│         ↑                                                              │        │
│         │                                                              ▼        │
│  ┌───────────────────────────────────────────────────────────────────────┐      │
│  │                         Android 系统层                                  │      │
│  │  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐                │      │
│  │  │ 微信 APK     │  │ SQLCipher DB │  │ 通知栏       │                │      │
│  │  │ (已 root)    │  │ EnMicroMsg   │  │ (微信通知)   │                │      │
│  │  └──────────────┘  └──────────────┘  └──────────────┘                │      │
│  └───────────────────────────────────────────────────────────────────────┘      │
└─────────────────────────────────────────────────────────────────────────────────┘

---

3. 数据流详解

3.1 完整消息处理流程

1. 通知触发（或定时轮询）
   │
   ▼
2. daemon 复制 EnMicroMsg.db + WAL + SHM 到 /sdcard/hermes/dbs/
   │
   ▼
3. daemon 用 sqlcipher 解密 DB
   │
   ▼
4. daemon 查询 message 表：SELECT * WHERE msgId > last_msg_id
   │
   ▼
5. daemon 提取消息内容 + 最近 5 条上下文
   │
   ▼
6. daemon 构造 prompt，HTTP POST 到 hermes /api/master/chat
   │   {
   │     "message": "收到消息（来自 xxx）：...\n上下文: ...",
   │     "sessionId": "wx-xxx"
   │   }
   │
   ▼
7. hermes (lemonPCRM) 调用 Claude CLI 处理消息，返回 SSE 流
   │   events: session → progress → agent_output → result
   │
   ▼
8. daemon 解析 SSE，提取 result.output 作为回复文本
   │
   ▼
9. daemon 执行 am broadcast 发送回复到微信
   │
   ▼
10. LSPosed 模块拦截广播，调用微信内部 API 发送消息

3.2 Session 管理

每个微信联系人 (talker) 对应一个独立的 hermes session：

talker	sessionId	作用
filehelper	wx-filehelper	文件传输助手
wxid_abc123	wx-wxid_abc123	个人联系人
123456789@chatroom	wx-123456789@chatroom	群聊

好处：

• hermes 自动维护每个对话的上下文记忆
• 不同联系人的对话互不干扰
• session 10 分钟空闲后自动清理

---

4. 消息监听双通道

4.1 通道 A: DB 轮询（主推）

原理: 定期复制微信加密 DB → sqlcipher 解密 → 查询 message 表 → 检测 msgId 变化

流程:

while True:
    su -c "cp /data/data/com.tencent.mm/MicroMsg/<hash>/EnMicroMsg.db /sdcard/hermes/dbs/"
    su -c "cp /data/data/com.tencent.mm/MicroMsg/<hash>/EnMicroMsg.db-wal /sdcard/hermes/dbs/"

    sqlcipher EnMicroMsg.db "PRAGMA key='e03ce81'; ..."

    SELECT * FROM message WHERE msgId > last_msg_id ORDER BY msgId
    UPDATE last_msg_id = max(msgId)
    sleep(10)

关键参数: | 参数 | 值 | 说明 | |------|-----|------| | SQLCipher key | e03ce81 | 7 字符字符串密码 | | cipher_compatibility | 1 | WCDB 兼容模式 | | cipher_page_size | 1024 | 页大小 | | 轮询间隔 | 10s | 可配置 | | WAL 文件 | 必须复制 | 否则丢失最新数据 |

4.2 通道 B: 通知监听（辅助）

原理: 通过 Termux:API 的 termux-notification-list 读取系统通知栏，发现微信通知后立即触发一次 DB 轮询。

流程:

while True:
    notifs = termux-notification-list
    wechat_notifs = [n for n in notifs if n.pkgName == "com.tencent.mm"]
    for n in wechat_notifs:
        if is_new(n):
            trigger_urgent_db_poll()  # 不等 10 秒周期
    sleep(3)

权限要求:

1. 安装 Termux:API 应用
2. 设置 → 应用 → Termux:API → 通知访问权限 → 允许
3. 关闭 Termux 和 Termux:API 的电池优化

4.3 双通道协同

正常状态: DB 轮询每 10 秒执行一次

收到新消息:
  通知栏产生通知 ──→ termux-notification-list 在 3 秒内发现
                            │
                            ▼
                  触发紧急 DB 轮询（不等 10 秒周期）
                            │
                            ▼
                  获取完整消息内容 ──→ HTTP POST hermes ──→ 发送回复

---

5. Hermes HTTP API 调用

5.1 API 端点

端点	方法	说明
POST /api/master/chat	SSE	发送消息，流式返回处理结果
GET /api/health	HTTP	健康检查

5.2 请求格式

POST /api/master/chat
Content-Type: application/json

{
  "message": "收到消息（来自 filehelper）：你好\n请回复：",
  "sessionId": "wx-filehelper"
}

5.3 SSE 响应格式

event: session
data: {"sessionId": "wx-filehelper"}

event: progress
data: {"step": "initializing", "message": "🤖 Master Agent 启动中..."}

event: agent_output
data: {"agent": "master", "message": "你好！很高兴收到你的消息。"}

event: result
data: {"sessionId": "wx-filehelper", "type": "text", "output": "你好！很高兴收到你的消息。"}

daemon 提取 result 事件的 output 字段作为最终回复。

5.4 Prompt 构造

daemon 发送给 hermes 的消息格式：

你是一个微信智能助手。根据收到的消息，给出简短、自然、得体的中文回复。

最近对话上下文：
  对方: 在吗？
  我: 在的，有什么可以帮你的？

收到新消息（来自 filehelper）：帮我查一下明天的天气

请直接给出回复内容，不要加任何解释或格式标记。

---

6. 消息发送

6.1 发送机制

LSPosed 模块 HermesWeChatModule 注入微信进程，暴露 BroadcastReceiver：

/system/bin/am broadcast \
  -a com.hermes.wechat.SEND_MSG \
  --es toUser "filehelper" \
  --es content "回复内容"

6.2 发送限制

限制	说明
仅文本消息	当前模块只支持文本
主线程调用	NetScene 提交必须在主线程
微信前台	建议保持微信在前台或后台运行

---

7. 开机自启（Termux:Boot）

7.1 启动脚本

文件: ~/.termux/boot/start-hermes.sh

#!/bin/bash

# 启动 frida-server（可选）
if [ -f "/data/local/tmp/frida-server" ]; then
    su -c "/data/local/tmp/frida-server &"
fi

# 启动微信（如果未运行）
if ! su -c "pgrep -x com.tencent.mm" > /dev/null 2>&1; then
    su -c "am start -n com.tencent.mm/.ui.LauncherUI"
    sleep 5
fi

# 启动 hermes (lemonPCRM) — 在 proot 内
export PATH=/data/data/com.termux/files/usr/bin:$PATH
proot-distro login --shared-home ubuntu -- bash -c \
    "cd /root/aipcrm && npm start &"

sleep 5

# 启动守护进程
proot-distro login --shared-home ubuntu -- bash -c \
    "cd /root/local-testkit && python3 hermes_wechat_daemon.py --daemon"

# 发送启动通知
termux-notification \
    --title "Hermes WeChat" \
    --content "守护进程已启动" \
    --priority low

7.2 安装步骤

mkdir -p ~/.termux/boot
cp setup_termux_boot.sh ~/.termux/boot/start-hermes.sh
chmod +x ~/.termux/boot/start-hermes.sh

---

8. 目录结构

~/local-testkit/                       # daemon 目录
├── hermes_wechat_daemon.py           # 主守护进程
├── config.json                        # 运行时配置
├── test_env.py                        # 环境预检
├── test_db_poll.py                    # DB 轮询测试
├── test_send_msg.py                   # 发送消息测试
├── test_termux_api.py                 # Termux API 测试
├── test_hermes_api.py                 # hermes HTTP API 测试
├── run_all_tests.sh                   # 一键测试
├── setup_termux_boot.sh              # 开机自启脚本
└── HERMES_WECHAT_ARCHITECTURE.md     # 本方案文档

~/aipcrm/                              # hermes (lemonPCRM) 目录
├── server/                            # Express 后端
├── packages/                          # ACP 协议 + Agent 运行时
├── package.json
└── ...

/sdcard/hermes/                        # 运行时数据
├── dbs/                               # DB 副本
│   ├── EnMicroMsg.db
│   ├── EnMicroMsg.db-wal
│   └── EnMicroMsg.db.decrypted.db
├── wechat_msgs.jsonl                 # 消息日志
└── daemon.log                         # 守护进程日志

---

9. 配置说明

config.json:

{
  "db_src_path": "",
  "db_copy_dir": "/sdcard/hermes/dbs",
  "sqlcipher_key": "e03ce81",
  "cipher_compatibility": 1,
  "cipher_page_size": 1024,
  "poll_interval_sec": 10,
  "max_msgs_per_poll": 50,
  "hermes": {
    "api_url": "http://localhost:3010/api/master/chat",
    "timeout_sec": 120,
    "default_session_prefix": "wx-",
    "system_hint": "你是一个微信智能助手。根据收到的消息，给出简短、自然、得体的中文回复。"
  },
  "auto_reply": {
    "enabled": false,
    "contacts": ["filehelper"],
    "exclude_types": [10000],
    "cooldown_sec": 5
  },
  "send": {
    "method": "am_broadcast",
    "broadcast_action": "com.hermes.wechat.SEND_MSG",
    "am_path": "/system/bin/am"
  },
  "logging": {
    "level": "INFO",
    "file": "/sdcard/hermes/daemon.log"
  }
}

注意：daemon 不配置 LLM API key，所有 LLM 配置在 hermes (lemonPCRM) 中。

---

10. 部署步骤

Step 1: 环境准备

# Pixel Termux 中
pkg update
pkg install python sqlcipher termux-api

# 安装 Termux:Boot 和 Termux:API 应用（F-Droid 或 GitHub）

Step 2: 部署 hermes (lemonPCRM)

# 在 proot Ubuntu 中
cd ~/aipcrm
npm install
# 配置 .env 中的 Claude API key
npm start  # 或 npm run dev（热重载）

确认 hermes 监听 localhost:3010。

Step 3: 部署 daemon

cd ~/local-testkit

Step 4: 运行测试

chmod +x run_all_tests.sh
./run_all_tests.sh

预期结果:

• test_env.py: 全部 [OK]
• test_db_poll.py: DB 复制、解密、查询通过
• test_send_msg.py: am broadcast 发送成功
• test_termux_api.py: 通知读取成功
• test_hermes_api.py: hermes API 调用成功，收到回复

Step 5: 启动守护进程

# 单次测试
python3 hermes_wechat_daemon.py --once

# 正常运行（前台）
python3 hermes_wechat_daemon.py

# 后台运行
python3 hermes_wechat_daemon.py --daemon

Step 6: 设置开机自启

cp setup_termux_boot.sh ~/.termux/boot/start-hermes.sh
chmod +x ~/.termux/boot/start-hermes.sh

---

11. 故障排查

Q: DB 解密失败

A:

1. 确认 key 正确
2. 确认 WAL 文件已复制：ls -la /sdcard/hermes/dbs/EnMicroMsg.db*
3. 微信运行时 DB 被锁定，必须通过 su -c cp 复制后再解密

Q: hermes API 调用超时

A:

1. 确认 hermes 已启动：curl http://localhost:3010/api/health
2. 检查 hermes 日志是否有 Claude CLI 调用错误
3. 增加 hermes.timeout_sec（Claude 推理可能需要 30-60 秒）

Q: hermes 返回空回复

A:

1. 检查 hermes 的 system/agents/ 目录是否有微信相关 Agent
2. 查看 hermes 日志中的 SSE 事件流
3. 确认 Claude CLI 进程正常运行（非 mock 模式）

Q: am broadcast 发送成功但微信没收到

A:

1. 检查 LSPosed 模块是否启用且作用域包含微信
2. 检查日志：su -c "cat /data/adb/lspd/log/modules_*.log | grep HermesWX | tail -20"
3. 确认微信在主进程运行

Q: termux-notification-list 返回空

A:

1. 确认 Termux:API 应用已安装
2. 确认已授予通知访问权限
3. 发送一条测试消息，等待通知出现

---

12. 安全与风险提示

1. 微信封号风险: 自动化操作存在被检测风险，建议使用测试小号
2. Root 权限: 需要 Magisk root
3. LSPosed 模块: 仅作用于微信进程
4. API Key: Claude API key 仅在 hermes 中配置，daemon 不持有

---

13. 扩展方向

• [ ] 支持群聊 @识别和回复
• [ ] 支持图片/语音消息处理
• [ ] 本地 LLM 部署（减少 API 延迟）
• [ ] Web UI 管理界面
• [ ] 多账号支持