WeChat 交互服务 — 发送与跟踪

本目录提供从 Mac 和 Pixel 手机 两个端点与微信进行交互的能力：发送消息、实时跟踪收发消息。

底层依赖自研的 LSPosed/Xposed 模块（HermesWeChatSendMsg），通过 Hook 微信内部 API 实现消息发送，并拦截日志实现消息跟踪。

---

整体架构

┌─────────────────────────────────────────────────────────────────────┐
│                         用户 / hermes agent                          │
│                                                                      │
│   Mac 端                        │   Pixel 手机端 (Termux/Debian)     │
│   ┌──────────────────────┐      │   ┌──────────────────────────┐     │
│   │ wechat-sender.js     │      │   │ android-wechat-sender.js │     │
│   │ wechat-tracker.js    │ adb  │   │ android-wechat-tracker.js│     │
│   └──────────┬───────────┘──────┘   └────────────┬─────────────┘     │
│              │                                   │                   │
│              │        adb shell su -c            │   su -c           │
│              │        "content insert ..."        │   "content ..."   │
│              │        "cat /data/adb/lspd/..."    │   "tail -f ..."   │
│              │                                   │                   │
│              ▼                                   ▼                   │
│   ┌──────────────────────────────────────────────────────┐          │
│   │              Pixel 10 Pro Fold (Rooted)               │          │
│   │  ┌────────────────────────────────────────────────┐   │          │
│   │  │  HermesWeChatSendMsg (LSPosed/Vector Module)   │   │          │
│   │  │  ┌──────────────┐      ┌──────────────────┐    │   │          │
│   │  │  │ ContentProvider│─────▶│ Broadcast Intent │    │   │          │
│   │  │  │   (Provider)   │      │ com.hermes.wechat│    │   │          │
│   │  │  └──────────────┘      │     .SEND_MSG     │    │   │          │
│   │  │         │              └────────┬───────────┘    │   │          │
│   │  │         │                       │                │   │          │
│   │  │         ▼                       ▼                │   │          │
│   │  │  ┌───────────────────────────────────────────┐   │   │          │
│   │  │  │         微信主进程 (com.tencent.mm)        │   │   │          │
│   │  │  │  ┌─────────────────────────────────────┐  │   │   │          │
│   │  │  │  │  Hook 点：                            │  │   │   │          │
│   │  │  │  │  • ExtContentProviderBase.h() → 1   │  │   │   │          │
│   │  │  │  │  • ExtContentProviderBase.b() → true│  │   │   │          │
│   │  │  │  │  • AESUtil.b/a → 明文 wxid          │  │   │   │          │
│   │  │  │  │  • MsgInfo.c1() → 消息日志           │  │   │   │          │
│   │  │  │  └─────────────────────────────────────┘  │   │   │          │
│   │  │  │  ┌─────────────────────────────────────┐  │   │   │          │
│   │  │  │  │  广播接收器 → NetSceneSendMsg       │  │   │   │          │
│   │  │  │  │  u01.r1.a() → Builder → m1.a()      │  │   │   │          │
│   │  │  │  └─────────────────────────────────────┘  │   │   │          │
│   │  │  └───────────────────────────────────────────┘   │   │          │
│   │  └────────────────────────────────────────────────┘   │          │
│   └──────────────────────────────────────────────────────┘          │
└─────────────────────────────────────────────────────────────────────┘

---

模块原理

Hook 点（WeChat 8.0.72）

目标类	方法	作用
ExtContentProviderBase	h() → return 1	绕过 appId + UID + 签名校验
ExtContentProviderBase	b() → return true	绕过登录状态检查
AESUtil	b(long) → 返回原值	跳过联系人 ID 加密
AESUtil	a(String) → 返回原值	跳过联系人 ID 解密
MsgInfo (f9)	c1(String)	监控消息内容变更，记录日志

消息发送调用链

外部请求
    │
    ├── content insert ──▶ ContentProvider ──▶ Broadcast (com.hermes.wechat.SEND_MSG)
    │                                              │
    └── am broadcast ────────────────────────────┘
                                                   │
                                                   ▼
                                    微信主进程 BroadcastReceiver
                                                   │
                              ┌────────────────────┴────────────────────┐
                              │                                         │
                              ▼                                         ▼
                    sendTextMessage()                        sendTextMessageDirect()
                    (官方 ContentProvider)                     (反射内部 API)
                              │                                         │
                              │     u01.r1.a(toUser) → Builder         │
                              │     builder.e(content)                 │
                              │     builder.h(0)                       │
                              │     builder.a() → u01.m1               │
                              │     m1.a()  // 必须在主线程调用        │
                              │                                         │
                              └─────────────────────────────────────────┘
                                                   │
                                                   ▼
                                              微信服务器

跨进程通信

模块代码运行在 微信主进程（通过 LSPosed 注入），ContentProvider 运行在 模块 APK 自身进程。两者通过 Android 广播通信：

hermes / adb shell content  →  模块 Provider 进程  →  发送广播
                                                          │
                                            微信主进程（注入的模块）
                                                          │
                                            广播接收器 → NetSceneSendMsg
                                                          │
                                                  微信服务器

---

文件清单

文件	用途	运行端
wechat-sender.js	发送消息（adb）	Mac
wechat-tracker.js	跟踪消息（adb）	Mac
android-wechat-sender.js	发送消息（su）	Pixel
android-wechat-tracker.js	跟踪消息（su）	Pixel
index.js	统一入口，自动检测环境	通用
test-phone.js	手机端一键测试	Pixel
deploy-to-phone.sh	推送到手机	Mac
SKILL.md	hermes agent skill 文档	通用
wechat-reader.js	读取解密后的 SQLite DB	Mac
wechat-importer.js	导入联系人到知识图谱	Mac

---

前置条件

1. 手机环境

• Pixel 10 Pro Fold（或其他已 root Android 设备）
• Magisk 30.7+，Zygisk 已启用
• LSPosed/Vector 2.0+ 框架已安装
• 微信 8.0.72
• Termux 或 Debian chroot（hermes agent 运行环境）

2. 模块安装

# 在 Mac 上编译（详见 lsposed-wechat-sendmsg/README.md）
cd lsposed-wechat-sendmsg
./gradlew assembleRelease

# 签名并安装
adb install app/build/outputs/apk/release/app-release.apk

# 在手机上：
# 1. 打开 Vector Manager → 模块 → 启用 HermesWeChatSendMsg
# 2. 作用域中选择「微信（com.tencent.mm）」
# 3. 强行停止微信，重新打开

3. 验证模块工作

adb shell su -c "logcat -s HermesWX:D | grep 'Send broadcast receiver registered'"
# 应看到: [HermesWX] Send broadcast receiver registered

---

Mac 端使用

发送消息

const { sendTextMessage, sendBatch } = require('./wechat-sender');

// 单条
const r = await sendTextMessage('filehelper', 'Hello from Mac');
console.log(r); // { ok: true, uri: 'content://.../send/0' }

// 批量
await sendBatch([
  { toUser: 'filehelper', content: 'msg1' },
  { toUser: 'wxid_xxx', content: 'msg2' },
], 2000);

跟踪消息

const { WechatTracker } = require('./wechat-tracker');
const tracker = new WechatTracker();

tracker.on('message', msg => {
  console.log(`[${msg.type}] ${msg.talker}: ${msg.content}`);
});

tracker.startPolling(3000);  // 轮询模式
// tracker.startStream();     // 流式模式（更实时）

---

手机端使用

一键部署

cd server/services/wechat
./deploy-to-phone.sh /data/data/com.termux/files/home/hermes-wechat

发送消息

const { sendTextMessage, sendTextMessageBroadcast } = require('./android-wechat-sender');

// 方式1：ContentProvider（与 Mac API 一致）
await sendTextMessage('filehelper', 'Hello from Pixel');

// 方式2：直接广播（更可靠）
await sendTextMessageBroadcast('wxid_xxx', 'Test');

跟踪消息

const { AndroidWechatTracker } = require('./android-wechat-tracker');
const tracker = new AndroidWechatTracker();

tracker.on('message', msg => console.log(msg));
tracker.startPolling(3000);

运行测试

cd /data/data/com.termux/files/home/hermes-wechat
node test-phone.js filehelper "hello from pixel"

---

统一入口

const wechat = require('./index');

// 自动检测环境：Mac 用 adb，Android 用 su
console.log(wechat.platform); // 'mac' | 'android'

// 发送
await wechat.sendTextMessage('filehelper', 'test');

// 跟踪
const tracker = new wechat.WechatTracker();
tracker.startPolling(3000);

---

API 参考

发送

函数	参数	返回值	说明
sendTextMessage(toUser, content)	string, string	{ok, uri, error}	通过 ContentProvider
sendTextMessageBroadcast(toUser, content)	string, string	{ok, error}	直接广播
queryStatus()	—	{status, error}	查询发送结果
sendBatch(messages, delayMs)	Array, number	Array	批量发送

跟踪

方法	说明
fetchRecent(n)	拉取最近 N 条
startPolling(ms)	轮询模式
startStream()	流式模式（tail -f）
stopPolling() / stopStream()	停止

事件

事件名	数据
message	{type, talker, msgType, msgId, content, raw, timestamp}
sendResult	{success, raw}
sendRequest	{toUser, raw}
error	Error
close	—

---

故障排查

模块层面

现象	原因	解决
content insert 无响应	广播未注册	检查 logcat 中 Send broadcast receiver registered
Send result: false	内部 API 调用失败	确认 WeChat 版本匹配，检查类名混淆
m1.a() return type 异常	微信版本升级	重新反编译 APK，更新 CLS_SEND_MSG_FACTORY
模块未出现在 Vector Manager	APK 未签名	重新签名安装

Mac 端

现象	原因	解决
adb: no devices	手机未连接	检查 USB 调试和 adb 授权
adb exit 255	未 root	确认 Magisk 已授权 adb shell 的 su

手机端

现象	原因	解决
exit 1: permission denied	未 root	检查 Magisk root 状态
content: not found	不在 Android 环境	确保在 Termux 或指定 /system/bin/content
发送成功但对方没收到	微信没在前台	确保微信主进程存活
跟踪不到消息	日志级别不够	Vector Manager → 日志 → 设置详细级别
Background execution not allowed	Android 10+ 限制	使用 content insert 替代 am broadcast

---

安全提示

• 本模块仅用于个人设备上的自动化测试和学习研究
• 微信账号存在被封风险，建议在测试用小号上操作
• 不要在群聊中高频发送消息，避免触发风控

---

相关文档

• LSPosed 模块 README — 模块编译、安装、Hook 点详情
• SKILL.md — hermes agent 快速上手指南