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 |
安全提示
- 本模块仅用于个人设备上的自动化测试和学习研究
- 微信账号存在被封风险，建议在测试用小号上操作
- 不要在群聊中高频发送消息，避免触发风控
相关文档
