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 泄露扫描 + hook | niezhe/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) | frida | 16.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。
八、端口
| 端口 | 用途 |
|---|---|
| 9421 | debug server(小程序连接) |
| 62000 | CDP 代理(DevTools / MCP 连接) |
| 49999 | miniapp-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 --hookwx-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 工具)
按这个顺序对目标小程序做自动化渗透:
-
列目标 / 切上下文
list_targets→switch_target切到 AppService(逻辑层) 线程(接口、加密逻辑所在地)。 -
抓接口与数据
list_network_requests(返回抓到的小程序 XHR/Fetch)→get_response_body(看响应) →get_request_initiator(定位发起请求的 JS 调用栈,找加密/签名入口)。 -
扫密钥与敏感信息
search_in_sources(在所有已加载 JS 里搜appid|secret|key|token|aes|encrypt|sign等) →list_scripts+save_script_source(把风控/加密 JS 整包拉下来)。 -
断点逆向加密
get_script_source读目标函数体 →set_breakpoint_on_text(在函数体内某条语句下断点, 不要对函数名/赋值语句下断点)→ 在小程序里触发请求 →get_paused_info(看调用栈/作用域/参数) →evaluate_script(在暂停现场取关键变量/密钥)→step单步 →resume_execution放行。 -
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 工具会把小程序的底层运行上下文暴露给客户端,允许检查、调试、修改内存中任何数据;务必授权后使用。
- 本项目按"现状"提供,使用者自行承担全部风险。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |