WeChat 本地闭环测试套件 — Pixel Termux 版

目标：在 Pixel 手机本地（Termux / Ubuntu proot）实现微信消息的监控-响应-发送全流程，不依赖 Mac 远程 adb。

---

文件清单

文件	用途	执行环境
hermes_wechat_daemon.py	主守护进程：DB 轮询 → 新消息检测 → LLM 处理 → 发送回复	Ubuntu proot
test_env.py	环境预检：验证所有依赖（su, sqlcipher, sqlite3, am, frida）	Ubuntu proot
test_db_poll.py	DB 轮询测试：验证复制+解密+增量读取	Ubuntu proot
test_send_msg.py	发送消息测试：验证 am broadcast 本地触发 LSPosed 模块	Ubuntu proot
test_frida_local.py	Frida 本地 attach 测试：验证 get_local_device() 捕获 key	Ubuntu proot
run_all_tests.sh	一键运行全部测试	Ubuntu proot
test_termux_api.py	Termux API 测试：通知读取、剪贴板、电量	Termux / proot
setup_termux_boot.sh	Termux Boot 启动脚本（开机自启）	Termux
NOTIFICATION_STRATEGY.md	通知监听策略说明	-
config.json	运行时配置（DB 路径、密钥、轮询间隔等）	Ubuntu proot

---

快速开始

1. 部署到 Pixel

在 Mac 上：

# 方式 A：adb push 到 Termux home
cd /Users/yibo/Documents/aipcrm/wechat_plain/scripts
adb push local-testkit /sdcard/hermes/local-testkit

# 然后在 Pixel 的 Termux 中：
cp -r /sdcard/hermes/local-testkit ~/local-testkit
cd ~/local-testkit

或者方式 B（直接 zip 上传）：

cd /Users/yibo/Documents/aipcrm/wechat_plain/scripts
zip -r local-testkit.zip local-testkit
adb push local-testkit.zip /sdcard/Download/
# 在 Termux 中 unzip

2. 运行环境预检

cd ~/local-testkit
python3 test_env.py

预期输出所有 [OK]，如果有 [FAIL] 按提示修复。

3. 运行全部测试

chmod +x run_all_tests.sh
./run_all_tests.sh

4. 启动守护进程（测试全部通过后）

# 编辑配置
nano config.json

# 启动 daemon
python3 hermes_wechat_daemon.py

---

架构说明

消息监控：DB 轮询（主推方案）

┌─────────────────┐     ┌──────────────┐     ┌──────────────┐
│ 微信 EnMicroMsg │────→│ su -c cp DB  │────→│ sqlcipher 解密│
│   (SQLCipher)   │     │  + WAL + SHM │     │              │
└─────────────────┘     └──────────────┘     └──────────────┘
                                                      │
                                                      ▼
┌─────────────────┐     ┌──────────────┐     ┌──────────────┐
│  LLM 处理回复    │←────│  新消息检测   │←────│ sqlite3 查询  │
│  (Kimi/Claude)  │     │ (msgId > last)│     │ message 表   │
└─────────────────┘     └──────────────┘     └──────────────┘
         │
         ▼
┌─────────────────┐     ┌──────────────┐     ┌──────────────┐
│ /system/bin/am  │────→│ LSPosed 模块 │────→│ NetSceneSendMsg│
│   broadcast     │     │ Broadcast RX │     │   发送消息     │
└─────────────────┘     └──────────────┘     └──────────────┘

轮询间隔默认 10 秒，可配置。

消息发送：am broadcast → LSPosed

已有 LSPosed 模块 HermesWeChatModule 在运行，只需本地触发 broadcast：

/system/bin/am broadcast \
  -a com.hermes.wechat.SEND_MSG \
  --es toUser "filehelper" \
  --es content "测试消息"

Key 更新：Frida 本地 attach

微信重启后 key 可能变化，daemon 内置 key 失效检测和自动重捕获：

device = frida.get_local_device()  # 不是 get_usb_device()
pid = device.spawn(["com.tencent.mm"])  # 或 attach 已有进程

---

配置说明（config.json）

{
  "db_src_path": "/data/data/com.tencent.mm/MicroMsg/xxxxxxxx/EnMicroMsg.db",
  "db_copy_dir": "/sdcard/hermes/dbs",
  "sqlcipher_key": "e03ce81",
  "cipher_compatibility": 1,
  "cipher_page_size": 1024,
  "poll_interval_sec": 10,
  "llm_provider": "kimi-coding",
  "llm_base_url": "https://api.kimi.com/coding",
  "llm_api_key": "sk-...",
  "llm_model": "kimi-for-coding",
  "auto_reply_enabled": true,
  "auto_reply_contacts": ["filehelper"],
  "log_level": "INFO"
}

---

故障排查

Q: su 命令找不到或权限不足？

A: 确保 Magisk 已安装，并在 Magisk Manager → 设置 → SuList 中授予 Termux/proot root 权限。

Q: am broadcast 执行成功但微信没收到？

A: 检查 LSPosed 模块是否启用且作用域包含微信。查看日志：su -c "cat /data/adb/lspd/log/verbose_*.log | grep HermesWX | tail -20"

Q: sqlcipher 解密失败？

A: 确认 key 正确（运行 test_frida_local.py 重新捕获），并检查 WAL 文件是否复制。微信运行时 DB 被锁定，必须通过 cp 复制后再解密。

Q: DB 复制成功但 sqlite3 查询为空？

A: 可能 WAL 文件未复制或未及时 checkpoint。检查 EnMicroMsg.db-wal 是否存在。

Q: Termux API 命令找不到？

A: 在 Termux 中运行 pkg install termux-api，并安装 Termux:API 应用。在 proot 容器内可能需要通过 /data/data/com.termux/files/usr/bin/termux-* 完整路径调用。

---

Termux API 双通道监听（补充方案）

除了 DB 轮询，还可以利用 Termux:API 的通知读取能力实现实时消息触发：

# 读取通知栏
/data/data/com.termux/files/usr/bin/termux-notification-list

混合策略：

1. termux-notification-list 每 3 秒轮询一次
2. 发现微信新通知 → 立即触发一次 DB 轮询（获取完整内容）
3. LLM 处理 → am broadcast 发送回复

详见 NOTIFICATION_STRATEGY.md。

---

开机自启（Termux:Boot）

复制启动脚本到 Termux boot 目录：

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

重启手机后自动：启动 frida-server → 启动微信 → 启动守护进程。

---

测试报告模板

运行 run_all_tests.sh 后，会在 test_report.json 生成结构化报告：

{
  "timestamp": "2026-05-22T18:00:00",
  "env": {"su": true, "sqlcipher": true, "sqlite3": true, "am": true, "frida": true},
  "db_poll": {"last_msg_id": 12345, "new_messages": 3, "ok": true},
  "send_msg": {"sent": true, "method": "am_broadcast"},
  "frida": {"key_captured": true, "key_hex": "65303363653831"},
  "overall": "PASS"
}

请将此报告内容贴回给 Claude，用于进一步分析和优化。