WMPFDebugger GUI

微信小程序运行时调试与 CDP 分析桌面工具

项目简介

WMPFDebugger GUI 是一个用于在 macOS 上调试微信小程序的图形界面工具。

项目当前已适配微信 19024，核心能力包括：

• 一键启动 Frida 注入与调试代理
• 在小程序连接成功后自动打开独立 DevTools
• 通过 ws://127.0.0.1:62000 暴露 CDP 调试入口
• 内置 19024 对应的 Frida 偏移配置

仓库内容

当前仓库只保留源码与必要资源，不包含以下内容：

• node_modules
• dist
• dist-electron
• release
• Rust target

环境要求

• macOS
• 已安装微信桌面版
• Node.js 18 或更高
• npm 9 或更高
• Frida 可正常工作
• 能够在微信进程中进行注入

重要前提：

• 需要关闭 SIP，否则 Frida 往往无法稳定附加微信相关进程
• 启动调试前，请先在微信中打开“小程序列表”页面

安装

npm install

开发运行

npm run dev

前端通常会启动在：

http://localhost:5173/

打包

npm run build

产物默认输出到：

release/1.0.1/

使用流程

简版流程：

1. 在微信中打开小程序列表页
2. 打开本工具并点击“启动服务”
3. 再打开任意一个目标小程序
4. 等待日志出现 miniapp client connected
5. DevTools 会自动弹出；如果没有，也可以手动点击“打开 DevTools”

MCP 运行时分析

当前版本已内置一个本地 MCP Server（默认仅监听 127.0.0.1:39200）：

http://127.0.0.1:39200/mcp

用途：

• 实时列出最近网络请求
• 根据 requestId 或 URL 片段回看 initiator 调用栈
• 列出运行时已加载脚本
• 直接读取运行时脚本源码（通过 CDP 动态拉取）
• 回看最近调试日志

当前已提供的 MCP tools：

• get_debugger_state
• list_recent_requests
• get_request_detail
• explain_request_source
• list_scripts
• search_scripts
• read_script
• get_recent_runtime_logs

建议使用顺序：

1. 启动 GUI
2. 点击“启动调试”
3. 打开目标小程序
4. 等待出现 miniapp client connected
5. 再通过 MCP 调 list_recent_requests / read_script 等工具

说明：第一版主要是 只读运行时分析。动态 JS hook / 热插拔 Frida hook 可以在下一版继续补。

文档

• 使用与注意事项：docs/USAGE.md
• Windows 偏移自动适配流程：docs/windows-offset-playbook.md
• 18926 适配记录：docs/offsets-18926-2026-03-11.md
• 19024 适配记录：docs/offsets-19024-2026-03-11.md