微信小程序和网页自动打开调试界面工具

# WMPFDebugger-kiss

**微信小程序 & 内置浏览器网页调试工具**

一键启动，自动注入 Frida Hook，支持小程序和 H5 网页的 Chrome DevTools 调试

</div>

---

## 功能特性

- **小程序调试** — 自动检测小程序启动，自动弹出 Chrome DevTools 调试窗口
- **H5 网页调试** — 通过「可用目标」列表选择并附加到微信内置浏览器页面自动打开进行调试
- **进程监控** — 实时监控 WeChatAppEx 进程，自动处理连接与断开
- **日志过滤** — 支持按等级过滤日志（仅提醒/报错 或 全部）
- **GUI 界面** — Electron 桌面应用，操作简单直观

## 界面预览

### 小程序调试窗口

![小程序调试](images/dxcx.png)

### 可用目标列表

点击「可用目标」按钮后，会列出所有可调试的页面：

![可用目标列表](images/h5.png)

### H5 网页调试

选择目标后，自动打开网页调试窗口：

![网页调试](images/dh5.png)

## 环境要求

- **操作系统**：Windows 10/11
- **Node.js**：>= 18.x
- **微信 PC 版**：已安装并登录
- **Frida**：随依赖自动安装

## 安装

### 1. 克隆项目

```bash
git clone https://github.com/Bai-Ye-Yi/WMPFDebugger-kiss.git
cd WMPFDebugger-kiss

2. 安装依赖

npm install

安装过程会自动执行 npm run build 编译 TypeScript 源码。

3. 运行

npm run ui

或双击 运行.vbs 启动（无终端窗口）。

使用方法

小程序调试

1. 启动应用后，点击 「启动调试器」 按钮
2. 等待日志显示 Frida 已就绪
3. 在微信中打开任意小程序
4. 调试窗口会 自动弹出
5. 如果没有自动弹出，关闭小程序重新打开，不能直接刷新小程序，必须关闭重新打开，或查看日志排查原因

H5 网页调试

1. 先按上述步骤通过小程序进入调试会话（必须先开小程序）
2. 在微信中打开目标网页
3. 点击 「可用目标」 按钮
4. 在弹出的列表中选择要调试的网页，点击即可附加调试窗口
5. 注意：小程序及其调试窗口不要关闭，可以最小化到后台，否则已连接的 H5 网页调试也会断开

支持的微信版本

程序通过 Frida Hook 注入 WeChatAppEx.exe，不同版本需要对应的偏移地址配置。

当前已支持的版本（frida/config/ 目录）：

新增版本适配

支持新版本只需添加 JSON 配置文件，无需修改代码：

1. 获取新版本的三个 Hook 偏移地址
2. 在 frida/config/ 下创建 addresses.<版本号>.json：

{
    "Version": <版本号>,
    "LoadStartHookOffset": "0xXXXXXXX",
    "CDPFilterHookOffset": "0xXXXXXXX",
    "SceneOffsets": [offset1, offset2, offset3]}

1. 重新启动调试器即可自动加载新配置

故障排除

致谢

• WMPFDebugger — 核心调试框架
• WMPFDebugger UI — UI 基础设计

License

GPL-2.0