First

微信小程序调试工具 —— 基于 Frida + CDP 代理，支持 GUI 与 CLI 双模式

---

改项目仅支持windows,macos用户使用dp虚拟机即可

截图预览

主界面 / Control Panel

路由导航

云函数分析

安全扫描

待优化

---

功能特性

• 通过 Frida 注入微信客户端，转发小程序调试协议
• CDP 代理桥接，支持 Chrome DevTools 直接连接调试
• 路由枚举与一键跳转导航
• 云函数调用监控与参数分析
• UserScript 自动注入（支持按 URL 匹配、run-at 时机控制）
• 内置安全扫描模块，生成扫描报告
• 深色 / 浅色主题切换
• GUI（PySide6）与 CLI 双模式运行

---

环境要求

依赖	版本
Python	>= 3.9
frida	>= 17.0.0
websockets	>= 12.0
protobuf	>= 4.0.0
PySide6	>= 6.5.0

安装依赖：

pip install -r requirements.txt

---

使用方法

GUI 模式（推荐）

python gui.py

启动后在主界面点击 Start 即可开始调试。

CLI 模式

# 默认端口启动
python main.py

# 自定义端口
python main.py --debug-port 9421 --cdp-port 62000

# 开启详细日志
python main.py --debug-main --debug-frida

连接 Chrome DevTools

启动后，在 Chrome 地址栏输入：

devtools://devtools/bundled/inspector.html?ws=127.0.0.1:62000

参数说明

参数	默认值	说明
--debug-port	9421	远程调试服务端口
--cdp-port	62000	CDP 代理监听端口
--debug-main	关闭	输出主进程调试日志
--debug-frida	关闭	输出 Frida 客户端日志
--scripts-dir	./userscripts	UserScript 目录路径
--script	—	指定单个 .js 文件注入（可多次使用）

UserScript 注入

将 .js 脚本放入 userscripts/ 目录，工具启动时自动加载并按规则注入。

也可手动指定文件：

python main.py --script ./my_hook.js --script ./another.js

---

打包为可执行文件

pyinstaller WMPFDebugger.spec

---

参考项目

本项目参考并学习了以下优秀工具的实现思路：

• evi0s/WMPFDebugger
• 0xsdeo/HeartK
• 残笑/FindSomething

---

致谢

感谢 0xsdeo 师傅的大力支持与思路提供。

---

免责声明

本工具仅供安全研究与学习使用，请勿用于未授权的目标，使用者须自行承担相关法律责任。