Skip to content

xegeng/wx-miniapp-skills / skills/wx-miniapp-wmpf

wx-miniapp-wmpf

Verified

微信小程序(PC 端) WMPF 自动化调试与安全评估工具链的搭建、使用与 AI 自动化渗透。覆盖「偏移自动提取 → Frida 注入 → CDP 代理 → DevTools 调试 → e0e1-wx 自动化扫描 → MCP 工具链 → AI 渗透」,集成 WMPFDebugger + e0e1-wx + wmpf-offset-adaptation + miniapp-cdp-mcp。当任务涉及"对已授权微信小程序做自动化测试/强开 F12/CDP 调试/反编译抓接口/微信版本更新后取偏移/用 MCP 让 AI 做自动化渗透(抓接口、扫密钥、断点逆向加密)"时使用。关键约束:必须是 Node 20 LTS + frida 锁 @16.6.6,否则 NODE_MODULE_VERSION/ESM 不兼容;MCP 侧必须 pin mcp<2(FastMCP 兼容)。

微信小程序 WMPF 自动化调试/安全评估工具链

本文档固化「微信小程序全自动化工具链(WMP-pentest-automation)」的完整搭建与使用流程,供复用。

参考: 微信小程序全自动化渗透工具 —— 偏移自动提取 → Frida 注入 → CDP 代理 → MCP 工具链 → AI 渗透。 集成 WMPFDebugger、e0e1-wx、wmpf-offset-adaptation-skill,解决微信更新后偏移值改变导致的注入失败。

仅用于对你已授权或本人拥有的小程序做安全评估/自动化测试。禁止破解、抓取或传播他人享有权利或隐私、商业秘密的小程序、数据或接口。


适用场景(when to use)

  • 需要在 PC 桌面微信里强开小程序的 F12 / DevTools,看控制台、网络请求、页面元素。
  • 需要对小程序做自动化反编译 + 接口/key 泄露扫描(e0e1-wx)。
  • 需要用 MCP 让 AI 助手做自动化渗透:抓接口、扫密钥、下断点逆向加密算法、还原签名/风控逻辑(miniapp-cdp-mcp)。
  • 微信升级后注入失败、需要按新版本重新提取偏移(wmpf-offset-adaptation)。
  • 目标: 已授权的小程序,运行在 Windows 桌面微信(4.x,使用新版 WMPF 运行时)。

一、前置检查(必须做)

# 1) 桌面微信已安装且小程序能正常打开
#    微信主程序版号 / WMPF 运行时版号(决定是否支持):
Get-ChildItem "$env:APPDATA\Tencent\xwechat\xplugin\plugins\RadiumWMPF"   # 取 <版本号> 目录
#    例: ...\RadiumWMPF\18151\extracted\runtime\flue.dll  → WMPF 版本 = 18151

# 2) Python 3.10+ 64 位
python -c "import sys,platform; print(sys.version, platform.architecture())"

# 3) Node.js 必须是 20 LTS(关键!) —— 见第四节
node -v          # 期望 v20.x
nvm current      # 期望 20.x

# 4) 微信小程序数据目录(wx-file,含 Applet 文件夹)
#    微信设置→文件管理 可查到;典型:
#    D:\messaging\wxcache\xwechat_files\WMPF

二、组件与目录

组件作用来源
WMPFDebugger/检测 WMPF 运行时并强开 F12/CDP(Frida 注入 + vendor 桥接)netz888/zhong-wechat-wmpf-debugger(Python)
e0e1-wx/监听打开的小程序 → 反编译(unveilr) → 接口/key 泄露扫描 + hookniezhe/e0e1-wx(Python)
offset-tool/分析 flue.dll 生成 addresses.<版本>.json(微信更新后取偏移)flagqaz/WMPFOffsetGen(C#/.NET CLI)
mcp/miniapp-cdp-mcp/把小程序 CDP 暴露成 MCP 工具,供 AI 自动化渗透(抓接口/扫密钥/断点逆向)zhizhuodemao/miniapp-cdp-mcp(Python/FastMCP)

建议统一放在一个根目录(下称 <ROOT>,本机为 D:\dsh\wxwmpf):

<ROOT>\
├─ WMPFDebugger\repo\
│  └─ vendor\wmpfdebugger\frida\config\addresses.<版本>.json
├─ e0e1-wx\repo\
│  ├─ tools\unveilr.exe
│  ├─ tools\WeChatAppEx.exe.js
│  └─ config.yaml
├─ offset-tool\repo\dist\WMPFOffsetGen.GUI.v1.1.exe
├─ mcp\miniapp-cdp-mcp\
│  ├─ run_mcp_http_server.py   # Streamable HTTP 启动(MCP :49999)
│  └─ src\miniapp_cdp\
└─ scripts\

三、拉取组件

cd <ROOT>
git clone --depth 1 https://github.com/netz888/zhong-wechat-wmpf-debugger.git WMPFDebugger\repo
git clone --depth 1 https://github.com/niezhe/e0e1-wx.git                    e0e1-wx\repo
git clone --depth 1 https://github.com/flagqaz/WMPFOffsetGen.git             offset-tool\repo
git clone --depth 1 https://github.com/zhizhuodemao/miniapp-cdp-mcp.git       mcp\miniapp-cdp-mcp

本环境到 github 的通断不稳定,个别仓库可能失败: 用 git ls-remote <url> 探活,失败就重试 或换 fork(如 eeeeeeeeee-code/e0e1-wx)。WMPFDebugger 部分 fork(二开版/arm 版)常被下架。


四、关键:Node 20 LTS + frida 锁 @16.6.6

这是最容易踩的坑。 frida 二进制与 Node 版本强绑定:

  • 用 Node v20 → frida@16.6.6 会自动下载匹配二进制(正常)。
  • 用 Node v22+ → frida 报 NODE_MODULE_VERSION 错误,或 prebuild-install install aborted → 回退源码编译(缺 VS 必挂)。
  • 且 vendor 桥接代码对 frida 有 ESM 兼容要求,文章明确「必须锁 v16.6.6」。

4.1 确保 Node 是 20 LTS

nvm use 切换全局版本需要管理员权限(UAC),非交互 shell 会挂起。可用同等效果的方式直接切换 (nvm 就是重建 D:\env\nodejs 这个链接):

# 切到 Node 20(把 D:\env\nodejs 指向 v20 目录)
Remove-Item D:\env\nodejs -Recurse -Force -ErrorAction SilentlyContinue
New-Item -ItemType Junction -Path D:\env\nodejs -Target D:\env\nvm\v20.19.0
node -v        # v20.19.0

版本目录一般在 D:\env\nvm\v<版本>\;若 nvm 未装 20,先 nvm install 20.19.0(安装不需管理员)。

4.2 给 vendor 安装 frida 并重建原生二进制(native .node)

cd <ROOT>\WMPFDebugger\repo\vendor\wmpfdebugger

# 1) 把 package.json 的 frida 锁到 16.6.6(不要 ^17.x)
#    "dependencies": { "frida": "16.6.6", ... }
#    并把 "allowScripts": { "frida@16.6.6": true }

# 2) 安装(注意 npm 的 allow-scripts 会拦截 install 脚本)
npm install
npm approve-scripts frida      # 允许 frida 的 install 脚本执行
npm rebuild frida              # 在 Node 20 下自动下载对应预编译

# 3) 校验
node -e "require('frida'); console.log('frida OK')"
Get-ChildItem node_modules\frida\build\frida_binding.node   # 期望 ~63MB 存在

若 npm rebuild frida 报 prebuild-install ... Request timed out: frida 预编译从 https://github.com/frida/frida/releases/download/<版本>/frida-v<版本>-napi-v8-win32-x64.tar.gz 下载,本环境对 github 下载端点不通会超时。处理:

  • 换能下载 github 的网络跑 npm rebuild frida,再把 node_modules\frida 拷回来;或
  • 手动下载该 tar.gz,把 frida_binding.node 解到 node_modules\frida\build\;或
  • 装 Visual Studio Build Tools(C++)走源码编译 npm rebuild frida。

4.3 版本核对

组件依赖版本
WMPFDebugger (Python)frida==16.1.11(见其 requirements.txt)
WMPFDebugger vendor (Node)frida16.6.6(手动锁)
e0e1-wx (Python)frida放宽 >=16.1.11(原 15.2.2 无 cp312 wheel)

五、Python 依赖

# WMPFDebugger
python -m venv <ROOT>\WMPFDebugger\venv
<ROOT>\WMPFDebugger\venv\Scripts\python -m pip install -r <ROOT>\WMPFDebugger\repo\requirements.txt

# e0e1-wx: 原始 requirements 锁的是旧版(frida 15.2.2/pandas 2.0.1/pywin32 305),
#          无 cp312 wheel,用放宽版:
<ROOT>\e0e1-wx\venv\Scripts\python -m pip install -r e0e1-wx\requirements-py312.txt
# requirements-py312.txt = colorama/filetype/frida>=16.1.11/httpx>=0.27/pandas>=2.1/psutil>=5.9.6/
#                         pywin32>=306/PyYAML/requests/requests_toolbelt/tqdm/openpyxl/xlsxwriter

e0e1-wx 还需在 repo\config.yaml 填微信数据目录:

wx-tools:
  wx-file: 'D:\messaging\wxcache\xwechat_files\WMPF'   # 含 Applet 的目录

六、偏移适配(微信更新后)

微信升级后若 RadiumWMPF\<版本号> 变化,注入会失败,需重新取偏移:

<ROOT>\offset-tool\repo\dist\WMPFOffsetGen.GUI.v1.1.exe --cli ^
  --input "C:\Users\<你>\AppData\Roaming\Tencent\xwechat\xplugin\plugins\RadiumWMPF\<新版本>" ^
  --version <新版本> --verbose
# 生成的 addresses.<新版本>.json 在 EXE 同级目录,复制到
# <ROOT>\WMPFDebugger\repo\vendor\wmpfdebugger\frida\config\

若仓库已内置当前版本的 addresses.<版本>.json,则跳过。main.py --check 会提示是否支持。


七、启动流程(顺序关键,别弄反)

① main.py -x(先启动桥接) → ② 微信里打开小程序(自动连 9421) → ③ 浏览器开 DevTools URL
# ① 检测(可选)
<ROOT>\WMPFDebugger\venv\Scripts\python.exe <ROOT>\WMPFDebugger\repo\main.py --check
#    期望: 当前 WMPF 版本 18151:支持

# ② 启动 F12/CDP 桥接(先启动!)
$env:PYTHONUNBUFFERED=1   # 让日志实时回显
<ROOT>\WMPFDebugger\venv\Scripts\python.exe <ROOT>\WMPFDebugger\repo\main.py -x

成功后输出(关键行):

[+] Detected WMPF runtime version 18151 (client_version=4065596974)
[+] DevTools URL: devtools://devtools/bundled/inspector.html?ws=127.0.0.1:62000
[server] debug server running on ws://localhost:9421
[server] proxy server running on ws://localhost:62000
[frida] script loaded, WMPF version: 18151, pid: 32276
[frida] you can now open any miniapps

关键顺序: 等 [frida] you can now open any miniapps 之后再打开小程序(先开小程序再启动桥接的话,小程序不会连接 debug server)。正确做法——桥接跑着,在微信里打开/重新打开小程序,它会自动连到 9421。


八、端口

端口用途
9421debug server(小程序连接)
62000CDP 代理(DevTools / MCP 连接)
49999miniapp-cdp MCP Server(Streamable HTTP,/mcp)

DevTools URL: devtools://devtools/bundled/inspector.html?ws=127.0.0.1:62000 (用 Chromium 系浏览器打开) MCP URL: http://127.0.0.1:49999/mcp(AI 助手连接)


九、使用与验证

  • DevTools 打开后,能看到小程序页面(target 为 servicewechat.com/<appid>/<ver>/page-frame.html)。
  • 想看控制台/网络/JS 逻辑,在 DevTools 目标下拉切到 appservice / webview 上下文,而不是 page-frame(渲染 frame)。
  • 若预览区显示 "The tab is inactive": 目标非激活所致。在微信里点一下小程序页面 → 刷新 DevTools(Ctrl+R); 或关闭 DevTools 重开一次;或等注入稳定后再开 DevTools(不要在小程序快速重连的瞬间开)。
  • 自动化扫描(可选,另一终端):
    cd <ROOT>\e0e1-wx\repo
    <ROOT>\e0e1-wx\venv\Scripts\python.exe e0e1-wx.py --hook
    
    监听 wx-file\Applet 新打开的目录 → 反编译 → 生成 result\<窗口名>\proess.xlsx(接口/拼接/key 泄露)。

十、MCP 工具链(把小程序 CDP 暴露给 AI)

结合 miniapp-cdp-mcp,在已打通的 62000 CDP 之上架一层 MCP Server,让 Claude Code / Cursor 等 AI 助手直接调用工具做自动化渗透。

10.1 依赖(重要: mcp 必须 pin <2)

miniapp-cdp-mcp 用的是 FastMCP v1 的 API。mcp 2.x 把 FastMCP 改名成了 MCPServer(from mcp.server.fastmcp import FastMCP 会直接报 ModuleNotFoundError)。所以必须装 mcp 1.x:

cd <ROOT>\mcp\miniapp-cdp-mcp
python -m venv .venv
.\.venv\Scripts\python -m pip install "mcp>=1.27.0,<2" "cdp-use" "python-socks>=2.8.1"
# 或直接 pip install "cdp-use" "mcp>=1.27.0,<2" "python-socks>=2.8.1"

若误装了 mcp 2.x,from miniapp_cdp.server import mcp 会报 No module named 'mcp.server.fastmcp' ... pin 'mcp<2' to keep running v1 code。

10.2 启动 MCP Server(Streamable HTTP :49999)

server.py 构造 FastMCP(...) 时给了默认 host/port(127.0.0.1:8000),会覆盖 FASTMCP_PORT 环境变量。 写一个包装脚本 run_mcp_http_server.py,导入后直接改 mcp.settings 再 run(transport="streamable-http"):

import os, sys
from pathlib import Path
SRC = Path(__file__).resolve().parent / "src"
sys.path.insert(0, str(SRC))
from miniapp_cdp.server import mcp
mcp.settings.host = "127.0.0.1"
mcp.settings.port = 49999
if __name__ == "__main__":
    mcp.run(transport="streamable-http")

运行(会话保持,放后台):

.\.venv\Scripts\python.exe run_mcp_http_server.py

验证:

Get-NetTCPConnection -LocalPort 49999 -State Listen    # 期望监听
# MCP initialize 返回 HTTP 200 + serverInfo=miniapp-cdp

10.3 连接 AI 助手

claude mcp add wxcdp --transport http http://127.0.0.1:49999/mcp

连接后端会自动连上 62000 的 CDP,并自动选中 servicewechat.com/<appid>/<ver>/page-frame.html 目标 (逻辑层/渲染层目标自动切换)。先在 main.py -x 把桥接跑起来、再开小程序,再起 MCP。


十一、AI 自动化渗透工作流(用 MCP 工具)

按这个顺序对目标小程序做自动化渗透:

  1. 列目标 / 切上下文 list_targets → switch_target 切到 AppService(逻辑层) 线程(接口、加密逻辑所在地)。

  2. 抓接口与数据 list_network_requests(返回抓到的小程序 XHR/Fetch)→ get_response_body(看响应) → get_request_initiator(定位发起请求的 JS 调用栈,找加密/签名入口)。

  3. 扫密钥与敏感信息 search_in_sources(在所有已加载 JS 里搜 appid|secret|key|token|aes|encrypt|sign 等) → list_scripts + save_script_source(把风控/加密 JS 整包拉下来)。

  4. 断点逆向加密 get_script_source 读目标函数体 → set_breakpoint_on_text(在函数体内某条语句下断点, 不要对函数名/赋值语句下断点)→ 在小程序里触发请求 → get_paused_info(看调用栈/作用域/参数) → evaluate_script(在暂停现场取关键变量/密钥)→ step 单步 → resume_execution 放行。

  5. WebSocket 分析 get_websocket_messages(若小程序用 WS 长连,看消息模式/协议)。

抓手顺序提醒:先 main.py -x 再开小程序,再连 MCP;抓包需在微信里触发请求后 list_network_requests 才有数据(它捕获的是启用监控之后的请求)。


十二、常见问题排查

  • main.py -x 里没日志 → stdout 被管道缓冲,加 $env:PYTHONUNBUFFERED=1 重开。
  • frida_binding.node 缺失 → 没在 Node 20 / frida 没锁 16.6.6 / github 下载失败(见 4.2)。
  • npm install 后 frida 未下载 → npm 的 allow-scripts 拦截了 install 脚本,先 npm approve-scripts frida 再 npm rebuild frida。
  • nvm use 挂起 → 需要管理员(UAC),用 junction 切换(见 4.1)。
  • main.py --check 提示不支持 → 需为新版本取偏移(见第六节)。
  • Python 依赖装不上 → 旧锁版本无 cp312 wheel,用第五节放宽版。
  • DevTools 打开但没内容 → 先确保小程序已在微信里打开;刷新 DevTools;重开标签页;重跑 -x。
  • from miniapp_cdp.server import mcp 报 No module named 'mcp.server.fastmcp' → mcp 装成 2.x 了,pip install "mcp>=1.27.0,<2" 降到 1.x(见 10.1)。
  • MCP Server 起在 8000 而不是 49999 → server.py 构造 FastMCP 时给了默认 port,FASTMCP_PORT 会被覆盖;在包装脚本里 mcp.settings.port = 49999 再 run(transport="streamable-http")(见 10.2)。
  • claude mcp add 连不上 → 先确认 main.py -x 桥接(62000)在跑、小程序已开、MCP Server(49999)在监听。
  • list_network_requests 抓不到请求 → 它只捕获启用监控之后的请求;先在微信里触发请求(点击/操作)再抓。

使用边界

  • 仅对本人拥有或已获明确授权的小程序使用。
  • 遵守《中华人民共和国网络安全法》、微信/腾讯用户协议与服务条款。
  • 严禁用于绕过授权、窃取数据、破坏服务、商业牟利等违法用途。
  • MCP 工具会把小程序的底层运行上下文暴露给客户端,允许检查、调试、修改内存中任何数据;务必授权后使用。
  • 本项目按"现状"提供,使用者自行承担全部风险。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall