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:

  1. Parse target wxid from command
  2. Use am start -n com.tencent.mm/.ui.chatting.ChattingUI --es Chat_User <wxid>
  3. Wait for new chat to load (sk instance recreated)
  4. 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