wechat-lsposed-send-module.md
4.93 KB
WeChat LSPosed Send Module Design
Date: 2026-06-30 Status: Skeleton exists, needs active-send upgrade
Existing Skeleton
Location: /data/data/com.termux/files/home/WeChatHook/
Main class: com.example.wechathook.WeChatHook
Target: com.tencent.mm.ui.chatting.component.sk.p0(String, int, String)
Current State: PASSIVE Logger
// Hooks sk.p0() and logs calls — does NOT inject messages
XposedHelpers.findAndHookMethod(
"com.tencent.mm.ui.chatting.component.sk",
lpparam.classLoader,
"p0",
String.class, int.class, String.class,
new XC_MethodHook() {
@Override
protected void beforeHookedMethod(MethodHookParam param) {
// Logs: msg, type, extra
// DOES NOT send custom messages
}
}
);
Proposed Upgrade: ACTIVE Sender
Design: File-Based Command Queue
Termux/Hermes → echo "wxid|hello world|1" > /sdcard/wechat_send_cmd.txt
↓ (module FileObserver or polling)
LSPosed module → read command → call saved sk.p0()
↓
Message sent through WeChat's network stack
Implementation Plan
public class WeChatHook implements IXposedHookLoadPackage {
private static Object sLastSkInstance; // Saved sk component
private static final String CMD_FILE = "/sdcard/wechat_send_cmd.txt";
@Override
public void handleLoadPackage(XC_LoadPackage.LoadPackageParam lpparam) {
if (!lpparam.packageName.equals("com.tencent.mm")) return;
// 1. Hook sk.p0() to capture instance
XposedHelpers.findAndHookMethod(
"com.tencent.mm.ui.chatting.component.sk",
lpparam.classLoader,
"p0",
String.class, int.class, String.class,
new XC_MethodHook() {
@Override
protected void beforeHookedMethod(MethodHookParam param) {
sLastSkInstance = param.thisObject;
// Log normal sends
}
}
);
// 2. Start command poller thread
new Thread(() -> {
while (true) {
try {
Thread.sleep(2000);
checkCommands();
} catch (Exception e) {}
}
}).start();
}
private void checkCommands() {
try {
File cmdFile = new File(CMD_FILE);
if (!cmdFile.exists()) return;
String content = readFile(cmdFile);
if (content.isEmpty()) return;
// Format: "msg|type|extra"
String[] parts = content.split("\\|", 3);
if (sLastSkInstance != null && parts.length >= 2) {
String msg = parts[0];
int type = Integer.parseInt(parts.length > 1 ? parts[1] : "1");
String extra = parts.length > 2 ? parts[2] : "";
// Call sk.p0() with our message
XposedHelpers.callMethod(sLastSkInstance, "p0", msg, type, extra);
}
// Clear command file
cmdFile.delete();
} catch (Exception e) {
Log.e(TAG, "Command error: " + e.getMessage());
}
}
}
Known Issue: Chat Context
The sk instance is bound to a specific chat (the currently open ChattingUI).
When we call sk.p0(), it sends to the talker of that chat window, NOT an arbitrary contact.
Workaround: Accept that the message goes to the currently active chat. For automated sending, the user must first open the target chat.
Alternative: Implement a chat-switching mechanism:
- Parse target wxid from command
- Use
am start -n com.tencent.mm/.ui.chatting.ChattingUI --es Chat_User <wxid> - Wait for new chat to load (sk instance recreated)
- Send message
Build Instructions
Cannot build on Termux (no Android SDK). Must build on Mac/PC:
# On Mac
cd ~/path/to/WeChatHook
export ANDROID_HOME=~/Library/Android/sdk
./gradlew assembleDebug
# Output: app/build/outputs/apk/debug/app-debug.apk
# Push to device
adb push app-debug.apk /sdcard/
# Install
adb shell su -c 'pm install -r /sdcard/app-debug.apk'
# Enable in LSPosed Manager + scope to com.tencent.mm
# Reboot or force-stop WeChat
adb shell su -c 'am force-stop com.tencent.mm'
File Paths
Module project: /data/data/com.termux/files/home/WeChatHook/
Main Hook class: app/src/main/java/com/example/wechathook/WeChatHook.java
Build output: app/build/outputs/apk/debug/app-debug.apk
Xposed init: app/src/main/assets/xposed_init
Compile on: Mac/PC (Android Studio or gradle CLI)
Install: pm install -r /sdcard/app-debug.apk
Enable: LSPosed Manager → Modules → WeChatHook → scope: com.tencent.mm
Dependencies
- Xposed API (stub):
de.robv.android.xposed:api:82(provided by LSPosed at runtime) - Android SDK: compileSdk 34, minSdk 26
- No external dependencies beyond Xposed stubs