概要

WMPFDebugger-mac は、WeChat（微信）の「小程序（ミニプログラム）」を対象としたデバッグ／解析ツールの macOS 版です。本プロジェクトは既存の WMPFDebugger（Windows 版）と WMPFDebugger-arm（macOS ARM 向け）を基にしており、Intel（x64）と Apple Silicon（arm64）を両方サポートする「デュアルアーキテクチャ」対応を実現しています。バージョン別のオフセット管理を設定ファイルで行い、実行時にシステムアーキテクチャと WeChatAppEx のバージョンを自動検出して最適な設定を読み込むことで、異なる環境やバージョンに柔軟に対応できます。Frida を用いた関数フックやメモリ操作が中心機能で、開発・解析・逆解析用途で利用されます。

リポジトリの統計情報

スター数: 15
フォーク数: 4
ウォッチャー数: 15
コミット数: 7
ファイル数: 8
メインの言語: JavaScript

主な特徴

Intel x64 と Apple Silicon arm64 の両アーキテクチャをサポートするデュアルアーキテクチャ対応
WeChatAppEx のバージョンごとにオフセットを設定ファイルで管理し、運用性を向上
実行時にアーキテクチャとアプリバージョンを自動検出して適切な設定をロード
Frida ベースのフックでメソッドインジェクションやメモリ読み書きを行う設計

技術的なポイント

本プロジェクトの中心は「フックエンジン（Frida）」と「バージョン／アーキテクチャ管理」の二点にあります。Frida を利用することで、実行中の WeChat プロセス（WeChatAppEx）へ動的にスクリプトを注入し、目的の関数をフックしたり、メモリ上の値を読み書きしたりできます。WMPFDebugger-mac は Frida スクリプトやラッパーを用いて、ミニプログラムの起動／実行フローに介入し、デバッグ情報の抽出や挙動変更を可能にします。

もう一つの肝は「バージョン依存性の管理」です。ネイティブバイナリの関数オフセットやシンボルの位置は WeChat のバージョンごとに変化するため、このツールは設定ファイル（オフセットテーブル）を用いてバージョン別の情報を保持します。起動時に WeChatAppEx のバージョンを自動検出し、該当するオフセットセットを読み込むことで、手動でオフセットを指定する手間を省いています。同様にシステムアーキテクチャを自動判定し、x64/arm64 両対応のスクリプトやバイナリを切り替える仕組みを備えています。

この設計により、開発者や解析者は新しい WeChat アップデートが出ても、該当バージョンのオフセットを追加／更新するだけでツールを再利用できます。とはいえ、恒久的な安定動作を保証するには、Frida のバージョン整合性、macOS の SIP（System Integrity Protection）やコード署名、WeChat の保護機構の変化など外部条件に注意する必要があります。また、こうしたツールは利用者側の責任で、安全かつ法令順守の範囲で使用することが重要です。

（約700字）

プロジェクトの構成

主要なファイルとディレクトリ：

.github: dir
.gitignore: file
LICENSE: file
README.md: file
frida: dir

…他 3 ファイル

frida ディレクトリには Frida スクリプトやアーキテクチャ別の補助コード、オフセット設定ファイルが含まれている想定です。README にはプロジェクトの由来（WMPFDebugger と WMPFDebugger-arm をベース）や主要機能の説明、対応アーキテクチャ・バージョン管理の概要が記載されています。

利用上の注意と拡張方法

Frida のインストール（pip または公式配布）と、適切な frida-server／frida-tools の整備が前提です。
macOS のセキュリティ設定や WeChat のコード署名により、動作しないケースがあるため、必要に応じて適切な権限や環境調整が必要です。
新しい WeChat バージョンに対応するには、該当バージョンのバイナリを解析してオフセットを抽出し、設定ファイルに追記します。プロジェクトの設計上、設定ファイルを追加することで容易に対応可能です。
法的・倫理的配慮：本ツールはリバースエンジニアリングを支援するためのものであり、利用は対象アプリの規約や各国法令を遵守してください。

まとめ

Intel/ARM 両対応とバージョン管理に注力した macOS 向け WeChat ミニプログラムデバッガ。運用性に優れる一方、環境依存の課題に注意が必要。

リポジトリ情報：

名前: WMPFDebugger-mac
説明: WMPFDebugger macOS版支持intel和m系列芯片
スター数: 15
言語: JavaScript
URL: https://github.com/linguo2625469/WMPFDebugger-mac
オーナー: linguo2625469
アバター: https://avatars.githubusercontent.com/u/49717738?v=4

READMEの抜粋：

WMPFDebugger-mac

macOS 版本的微信小程序调试工具（支持 Intel x64 和 Apple Silicon arm64）

项目简介

本项目基于以下两个优秀的开源项目修改而成：

WMPFDebugger - Windows 版本的微信小程序调试工具
WMPFDebugger-arm - macOS ARM 版本的适配

本项目在 WMPFDebugger-arm 的基础上，实现了以下改进(还有倒退笑)：

✅ 双架构支持：同时支持 macOS Intel (x64) 和 Apple Silicon (arm64/M芯片)
✅ 完善的版本管理：通过配置文件管理不同版本的偏移地址，便于维护和扩展
✅ 自动架构检测：自动检测系统架构并加载对应的配置
✅ 自动版本检测：自动检测 WeChatAppEx 版本并加载对应的配置文…

WMPFDebugger-mac：macOS（Intel / Apple Silicon）対応 WeChat 小程序デバッグツール