STATUS.md 7.63 KB

XHS MITM 进度备忘 — 2026-06-29(Hermes 接手版)

写给设备上 Hermes Agent 的完整上下文。直接可用,无需 Mac 介入的操作都写了命令。


战役目标:✅ 已完成

抓 edith.xiaohongshu.com 的 xy-common-params(ECFAAF/ECFAAF01 签名参数),用于复现 XHS 请求鉴权。

核心障碍:edith 用 Google Mainline Cronet + 静态链接 BoringSSL,Frida Interceptor 无法 hook 静态符号。 解法:LSPosed(JingMatrix/Vector fork)在 XHS 进程 fork 时注入,hook OkHttp Java 层,在签名传入 Cronet 前拦截。


当前设备状态(2026-06-29 17:22 验证通过)

设备:Pixel 10 Pro Fold
Android:16 (API 36)
Magisk:30.7
LSPosed (Vector fork):正常运行,lspd 进程存活
xhshook:注入 com.xingin.xhs 成功
xy-common-params:已捕获(见下方样本)

模块布局

/data/adb/modules/
├── zygisk_vector/          # LSPosed Vector fork(含 A16 JNI size fix)
│   ├── zygisk/arm64-v8a.so # 核心注入 so(1142464 字节)
│   ├── daemon.apk          # Java 守护进程(3199711 字节)
│   ├── framework/lspd.dex  # 注入 DEX(182840 字节)
│   ├── daemon              # 启动脚本(已修复入口类名)
│   └── service.sh          # Magisk 钩子(已去掉不兼容 flag)
├── xhshook/                # Xposed 模块
│   ├── module.prop
│   └── xhshook.apk         # 已更新为 v2(无捆绑 XposedBridge)
└── xhs_ca/                 # MITM 代理 CA 证书
    └── system/etc/security/cacerts/36522bbf.0

xhshook 配置

已安装:com.hermes.xhshook(streamed install,非 incremental)
APK 含:assets/xposed_init → com.hermes.xhshook.Hook
modules_config.db:mid=3, enabled=1, scope=com.xingin.xhs

捕获到的 xy-common-params 样本

打开 XHS 后,用 logcat 实时抓:

# 在 Termux 里(需要 root)
su -c "logcat -b all | grep -F 'xy-common-params:'"

示例值(session 级字段每次启动刷新):

fid=
gid=7c9eca1fb5ac54aae84944d1bb4d85a3591f09d9473599ae77728621
device_model=phone
tz=Asia/Shanghai
channel=YingYongBao
versionName=9.35.1
deviceId=748327bc-6079-3b06-9351-1638281dbc6f   ← 设备固定
platform=android
sid=session.1782715007780944836188               ← 每次启动变
identifier_flag=4
cpu_abi=arm64-v8a
nqe_score=89
project_id=ECFAAF
app_id=ECFAAF01
id_token=VjEAAN3Pjix...                          ← 每次启动变
t=1782724968                                     ← Unix 时间戳,每次变
build=9351803
did=058844e5598e4d001b42a122d1a9d1c2            ← 设备固定

固定字段(可硬编码复现请求):deviceId、did、gid、platform、versionName、build Session 字段(需要 hook 实时拿):id_token、sid、t


xhshook 架构(Hermes 改 hook 用)

Hook 逻辑(当前 v2)

// 源码位置(设备):/sdcard/Download/xhs_lsposed_a16_fix/xhshook_src/Hook.java
// 源码位置(Mac):~/Documents/LemonAI/pixelphone/xhs_lsposed_a16_fix/xhshook_src/Hook.java

hook 点:okhttp3.Request$Builder.build()
过滤:只打印 edith.xiaohongshu.com 的请求
输出:logcat tag=VectorLegacyBridge

改 hook 的完整流程(需 Mac 操作)

# 1. 编辑 Hook.java
# ~/Documents/LemonAI/pixelphone/xhs_lsposed_a16_fix/xhshook_src/Hook.java

# 2. 重新编译 + 打包(Mac 上运行)
bash ~/Documents/LemonAI/pixelphone/xhs_lsposed_a16_fix/rebuild_xhshook.sh

# 3. 推到设备
ADB=~/Documents/LemonAI/pixelphone/platform-tools/adb
$ADB shell 'pm uninstall com.hermes.xhshook' && \
$ADB install --no-incremental ~/Documents/LemonAI/pixelphone/xhs_lsposed_a16_fix/xhshook_v2_signed.apk

# 4. 更新 modules_config.db(脚本自动做)
bash ~/Documents/LemonAI/pixelphone/xhs_lsposed_a16_fix/update_xhshook_db.sh

# 5. 杀掉 XHS 进程重启(不需要重启整机!)
$ADB shell 'am force-stop com.xingin.xhs'
# 然后手动在屏幕上点 XHS 图标

# 6. 验证
$ADB shell 'logcat -d | grep "\[XHSHook\]"'

可以加的下一个 hook:CertificatePinner bypass

xhs_ca 模块已经把 MITM 代理 CA 证书装进系统了。补上 CertificatePinner bypass 后可以直接用 mitmproxy 抓 OkHttp 流量(edith 仍然走 Cronet,但其他接口会走 OkHttp):

// 在 handleLoadPackage 里加(XHS 包名判断之后):
try {
    XposedHelpers.findAndHookMethod(
        "okhttp3.CertificatePinner", lpparam.classLoader,
        "check", String.class, List.class,
        new XC_MethodHook() {
            @Override
            protected void beforeHookedMethod(MethodHookParam param) throws Throwable {
                param.setResult(null);
            }
        }
    );
    XposedBridge.log("[XHSHook] CertificatePinner bypassed!");
} catch (Throwable t) {
    XposedBridge.log("[XHSHook] CertificatePinner bypass failed: " + t);
}

下一步可以做的事(Hermes 接手)

A. 用捕获到的参数复现 XHS API 请求

xy-common-params 里的固定字段可以直接复用,session 字段需要先打开 XHS 触发 hook 实时拿。

# Termux 里实时抓一次完整的 xy-common-params
su -c "logcat -c && am force-stop com.xingin.xhs"
# → 手动打开 XHS →
su -c "logcat -d | grep 'xy-common-params:' | head -1"

拿到后,用 curl 复现请求:

XY_PARAMS="fid=&gid=7c9eca...(完整值)"
curl -H "xy-common-params: $XY_PARAMS" \
     "https://edith.xiaohongshu.com/api/sns/v1/homefeed?..."

B. Hook 更多字段(如果 curl 复现失败)

edith 除 xy-common-params 外可能还检查其他 header(如 xy-sign、cookie)。修改 xhshook 打印所有 edith 请求的全部 header,观察缺什么。

Hook.java 里已经打印了 Headers.toString() 的完整内容——重新抓一次 logcat 即可看到所有 header(logcat 多行输出,每个 header 一行)。

su -c "logcat -d -b all | grep 'VectorLegacyBridge' | grep -v '\[XHSHook\]'" | head -30

C. 修改 xhshook 做实时转发(高级)

改 hook 在 beforeHookedMethod 里把参数通过 HTTP POST 转到 Hermes 的本地 server(如 localhost:8765),让 Hermes 实时处理每条请求。


文件索引(设备上)

/sdcard/Download/xhs_lsposed_a16_fix/
├── STATUS.md               ← 本文件
├── CLAUDE.md               ← 项目说明(构建/部署命令)
├── apply_a16_fix.sh        ← A16 补丁脚本(已应用,留作参考)
├── ipc_bridge.h            ← 已打补丁的头文件
├── ipc_bridge.cpp          ← 已打补丁的源文件
├── xhshook_src/
│   └── Hook.java           ← xhshook v2 源码
└── xhshook_v2_signed.apk   ← 预构建的 APK(当前已安装版本)

已知不行的路线(别重新踩)

  • Frida hook edith.xiaohongshu.com:Cronet 静态链接 BoringSSL,Frida Interceptor 找不到符号。SSL_read/SSL_write 都 hook 不上。
  • Java TrustManager 替换:时序问题,edith 在 app 启动很早就开始通信,Frida 注入晚了窗口就过了。LSPosed 没有这个问题。
  • 常驻 Frida daemon 注入 XHS:XHS 检测到反调试后崩溃(wechat_plain 里有记录,XHS 同理)。
  • 把 Xposed API 类打进 xhshook DEX:LSPosed 会检查 XposedBridge.class.getClassLoader() == initLoader,打进去的话直接 Cannot load module。必须用 compileOnly。
  • incremental install(adb install 默认):Incremental Install 的 marker 会让 java.util.zip.ZipFile 解析失败,LSPosed 找不到 assets/xposed_init。必须用 adb install --no-incremental。