zhuyansen/wx-favorites-report

해결하는 문제

Mac의 WeChat은 즐겨찾기를 암호화된 로컬 데이터베이스에 저장하므로 앱 외부에서 쉽게 보거나 분석할 수 없습니다. 이 프로젝트는 해당 데이터를 추출하여 차트와 필터가 포함된 풍부하고 자체 포함된 HTML 보고서를 생성하여 WeChat 인터페이스에 의존하지 않고 저장된 항목을 탐색할 수 있게 합니다.

작동 방식

이 프로세스는 macOS에서 실행되며 로그인된 WeChat 4.x가 필요합니다. 다음 단계로 구성됩니다:

1. Frida 도구로 WeChat의 PBKDF2 키 파생 함수를 후킹하여 데이터베이스 암호화 키를 추출합니다.
2. 추출된 키를 사용하여 SQLCipher 호환 매개변수(AES-256-CBC, HMAC-SHA512, PBKDF2 256,000 라운드)로 즐겨찾기 데이터베이스 파일을 찾아 복호화합니다.
3. 복호화된 SQLite 데이터와 포함된 XML 콘텐츠를 구문 분석하여 통합된 JSON 구조로 변환합니다.
4. ECharts를 사용하여 단일 파일 HTML 보고서를 생성합니다. 대시보드, 추세선, 분포 차트, 워드 클라우드, 필터링 가능한 탐색 영역이 포함됩니다.

권장 방법은 Claude Code를 통해 호출하는 것으로, 단일 명령으로 전체 파이프라인을 자동화합니다. 수동 단계별 스크립트도 제공됩니다.

대상 사용자

Mac에서 WeChat을 사용하고 즐겨찾기가 많으며 패턴, 수, 추세를 확인하거나 저장된 항목을 더 유연하고 오프라인에서 사용 가능한 방식으로 탐색하려는 사람들입니다. Python 스크립트와 명령줄 도구 실행에 익숙한 사용자 또는 Claude Code를 활용하여 기술적 단계를 처리할 수 있는 사용자에게 적합합니다.

주요 기능

• 통계 카드, 월별 추세, 유형 분포, 상위 소스, 활동 히트맵, 워드 클라우드, 태그 클라우드가 포함된 대화형 보고서
• 유형 또는 태그별 필터링, 전체 텍스트 검색, 정렬, 페이지네이션을 지원하는 즐겨찾기 탐색
• WeChat의 암호화된 로컬 데이터베이스에서 직접 데이터 추출(macOS 전용)
• Frida를 사용하여 PBKDF2 함수를 후킹하여 키를 추출, 수동 리버스 엔지니어링 방지
• WeChat 4.x의 변경된 테이블 구조와 비균일한 XML 필드 이름 처리
• 종속성이 포함된 단일 파일 HTML 보고서를 생성하여 모든 브라우저에서 볼 수 있음
• 실제 개인 데이터 없이 테스트할 수 있는 데모 데이터 생성기 포함