wx-favorites-report Test: WeChat-Favoriten Visualisierungstool - Ein-Klick interaktive Berichte
Haben Sie sich schon einmal gefragt, wie viele Dinge sich eigentlich in Ihren WeChat-Favoriten verbergen? Wie viele der spontan gespeicherten Artikel, Videos und Links haben Sie seitdem nie wieder geöffnet?
wx-favorites-report ist ein Open-Source-Tool zur Visualisierung von WeChat-Favoriten. Es entschlüsselt und analysiert die Daten aus der verschlüsselten lokalen WeChat-Mac-Datenbank Ende-zu-Ende und erstellt einen interaktiven HTML-Bericht mit 7 Diagrammtypen. Kurz gesagt: Es verwandelt Ihre WeChat-Favoriten von einer „Blackbox” in ein „Dashboard”.
1. Was ist wx-favorites-report?
wx-favorites-report wurde vom Entwickler zhuyansen als Open-Source-Projekt veröffentlicht, zunächst als Skill für Claude Code und später in Open-Source-Projekte wie claude-code-skills-zh integriert.
Die Kernfunktionen lassen sich in drei Schritte zusammenfassen:
- Entschlüsselung: Extraktion des Schlüssels und Entschlüsselung der verschlüsselten Datenbank (SQLCipher) des WeChat-Mac-Clients
- Analyse: Umwandlung der strukturierten XML-Daten in SQLite in einheitliches JSON
- Visualisierung: Erstellung eines einseitigen HTML-Berichts mit Statistik-Dashboard, monatlichen Trends, Typverteilung und mehr
Der gesamte Vorgang kann vollautomatisch ablaufen – wenn Sie Claude Code verwenden, reicht ein einziger Befehl wie „WeChat-Favoriten visualisieren”, und das Tool durchläuft den gesamten Prozess automatisch.
2. Detaillierte Kernfunktionen
2.1 Datenextraktion: Von der verschlüsselten DB zu Klartext
Die Favoritendaten von WeChat Mac 4.x werden in einer mit SQLCipher verschlüsselten SQLite-Datenbank gespeichert. wx-favorites-report verwendet die Frida-Dynamic-Injection-Technik, um die CCKeyDerivationPBKDF-Funktion von WeChat zu hooken und den Schlüsselableitungsprozess zur Laufzeit abzufangen.
# Abhängigkeiten installieren
pip3 install frida frida-tools pycryptodome
# Signierte WeChat-Kopie vorbereiten (Hardened Runtime umgehen)
cp -R /Applications/WeChat.app ~/Desktop/WeChat.app
codesign --force --deep --sign - ~/Desktop/WeChat.appDie Entschlüsselungsparameter entsprechen dem SQLCipher 4-Standard: AES-256-CBC-Verschlüsselung, HMAC-SHA512-Verifizierung, PBKDF2 mit 256.000 Iterationen.
2.2 Statistik-Dashboard
Die Startseite des Berichts ist ein Datenübersichtspanel mit vier Kennzahlen:
- Gesamtanzahl der Favoriten: Wie viele Inhalte Sie insgesamt gespeichert haben
- Zeitraum in Tagen: Die Zeitspanne vom ersten Favoriten bis heute
- Durchschnittliche Favoriten pro Tag: Wie viele Einträge Sie im Durchschnitt täglich speichern
- Anzahl der Quellen: Aus wie vielen verschiedenen Quellen Ihre Favoriten stammen
2.3 Sieben Visualisierungsdiagramme
| Diagrammtyp | Inhalt | Interaktion |
|---|---|---|
| Monatlicher Trend | Monatliche Entwicklung der Favoritenanzahl | Linien- + Flächendiagramm |
| Typverteilung | Anteil von Artikeln/Videos/Links/Bildern | Donut-Diagramm |
| Quellen-Ranking | Top 15 Favoritenquellen | Horizontales Balkendiagramm |
| Aktivitäts-Heatmap | Wochentag × Stunde der Favoritenhäufigkeit | Heatmatrix |
| Zeitverteilung | Welche Tageszeit am häufigsten für Favoriten genutzt wird | Doppeltes Balkendiagramm |
| Wordcloud | Schlüsselwörter aus Titel und Beschreibung | Interaktive Wordcloud |
| Tag-Cloud | Verteilung der WeChat-Favoriten-Tags | Anklickbare Tags |
2.4 Favoriten-Browser
Am Ende des Berichts befindet sich ein voll funktionsfähiger Favoriten-Browser mit folgenden Funktionen:
- Filterung nach Typ (Artikel/Video/Link/Bild)
- Filterung nach Tags
- Volltextsuche
- Verschiedene Sortiermöglichkeiten
- Seitenweise Anzeige
- Klick auf Karten zeigt vollständigen Inhalt und Original-Link
3. Technische Grundlagen
3.1 WeChat-Datenbankstruktur
Die Favoritendaten von WeChat Mac 4.x werden in favorite.db gespeichert, unter folgendem Pfad:
~/Library/Containers/com.tencent.xinWeChat/Data/Documents/
xwechat_files/<wxid>/db_storage/favorite/favorite.dbIm Gegensatz zur 3.x-Version, die eine Doppel-Tabellenstruktur mit FavItems + FavDataItem verwendete, nutzt 4.x eine einzelne Tabelle fav_db_item, wobei das Inhaltsfeld im XML-Format vorliegt.
3.2 Die 6 Iterationen der Schlüsselextraktion
Dies ist der schwierigste Teil des gesamten Projekts. Der Entwickler durchlief 6 Versuche:
| Runde | Methode | Ergebnis |
|---|---|---|
| 1 | C-Speicher-Scan im x’hex’-Format | Fehlgeschlagen: WeChat 4.x verwendet dieses Format nicht |
| 2 | Suche nach rohen Salt-Bytes | Fehlgeschlagen: Falsche Übereinstimmungen mit ASCII-Strings |
| 3 | HMAC-Brute-Force-Verifizierung | Fehlgeschlagen: Filterkriterien übersprangen die tatsächliche Position |
| 4 | Brute-Force-Suche ohne Filter | Fehlgeschlagen: Schlüssel wird nach PBKDF2-Ableitung gespeichert |
| 5 | DYLD-Hook / lldb | Fehlgeschlagen: macOS SIP blockiert |
| 6 | frida + CCKeyDerivationPBKDF | Erfolgreich |
Die endgültige Lösung hookt über Frida die systemweite PBKDF2-Funktion und fängt den Schlüsselableitungsprozess beim Start von WeChat ab.
3.3 Datenverarbeitungsablauf
Verschlüsselte DB → Frida extrahiert Schlüssel → PyCryptodome entschlüsselt → SQLite liest
→ XML-Analyse → Einheitliches JSON → ECharts-Rendering → Einseitige HTML-Datei4. Installation und Bereitstellung
4.1 Systemanforderungen
| Voraussetzung | Beschreibung |
|---|---|
| Betriebssystem | macOS (Apple Silicon oder Intel) |
| WeChat-Version | Mac 4.x, angemeldet |
| Python | 3.9+ |
| Optional | Claude Code (Ein-Klick-Ausführung) |
4.2 Manuelle Installationsschritte
Schritt 1: Python-Abhängigkeiten installieren
pip3 install frida frida-tools pycryptodomeSchritt 2: Signierte WeChat-Kopie vorbereiten
cp -R /Applications/WeChat.app ~/Desktop/WeChat.app
codesign --force --deep --sign - ~/Desktop/WeChat.appSchritt 3: Schlüssel extrahieren
killall WeChat 2>/dev/null; sleep 2
# Frida-Hook-Skript ausführen
# Nach WeChat-Start: Anmelden → „Favoriten"-Seite öffnen → 60 Sekunden wartenSchritt 4: Entschlüsseln und Bericht erstellen
# Daten analysieren
python3 parse_favorites.py --input favorite_decrypted.db --output data.json
# HTML-Bericht generieren
python3 generate_report.py --input data.json --output report.html
# Lokale Vorschau
python3 -m http.server 8765
# Browser öffnen: http://localhost:8765/report.html4.3 Ein-Klick-Ausführung mit Claude Code
Wenn Sie Claude Code installiert haben, sagen Sie einfach im Dialog:
WeChat-Favoriten visualisierenClaude führt automatisch den gesamten Prozess durch: Schlüsselextraktion, Entschlüsselung, Analyse und Berichtserstellung.
5. Praxis-Tutorial: Erstellen Sie Ihren ersten Favoriten-Bericht
5.1 Datenextraktion
Nach dem Ausführen des Frida-Skripts wird WeChat neu gestartet. Sie müssen dann:
- WeChat anmelden (QR-Code scannen oder bestätigen)
- Auf den Tab „Favoriten” auf der linken Seite klicken
- 60 Sekunden warten, damit Frida den Schlüssel erfassen kann
Der Schlüssel wird unter /tmp/wechat_frida_keys.log gespeichert. Über Salt-Matching wird der enc_key für favorite.db gefunden.
5.2 Datenbank-Entschlüsselung
Mit Python entschlüsseln:
from Crypto.Cipher import AES
import hashlib
# enc_key und salt aus dem Frida-Log abrufen
enc_key = bytes.fromhex("your_enc_key_here")
# SQLCipher 4-Parameter
kdf_iter = 256000
page_size = 4096
reserve_size = 80 # IV(16) + HMAC(64)
# Seite für Seite entschlüsseln...5.3 Berichtserstellung und Anpassung
python3 generate_report.py --input data.json --output report.htmlDer generierte Bericht ist eine einseitige HTML-Datei, bei der alle CSS- und JavaScript-Dateien inline eingebunden sind. Sie kann per Doppelklick geöffnet oder auf einen beliebigen statischen Hosting-Dienst hochgeladen werden.
6. Berichtsanalyse: Wie Sie Ihre Favoritendaten auswerten
6.1 Nutzungsgewohnheiten erkennen
Über die Aktivitäts-Heatmap können Sie herausfinden:
- Speichern Sie an Werktagen oder am Wochenende mehr?
- Zu welcher Tageszeit ist die höchste Speicheraktivität?
- Gibt es ein Muster von „spätabends am Handy und wildes Speichern”?
6.2 Inhaltspräferenzen analysieren
Das Typverteilungsdiagramm zeigt Ihre Favoriten-Präferenzen:
- Wenn Artikel über 80% ausmachen, sind Sie ein „Tiefenleser”
- Wenn Videos einen hohen Anteil haben, bevorzugen Sie „fragmentiertes Lernen”
- Wenn Links überwiegen, handelt es sich wahrscheinlich eher um „Tool-Sammlungen”
6.3 Quellenqualität bewerten
Das Quellen-Ranking Top 15 hilft Ihnen zu erkennen:
- Welche offiziellen Kontos/Websites speichern Sie am häufigsten?
- Ist die Inhaltsqualität dieser Quellen konstant gut?
- Gibt es Quellen, die Sie abbestellen oder per RSS abonnieren sollten?
7. Vergleich mit anderen WeChat-Daten-Tools
| Tool | Datentyp | Plattform | Visualisierung | Schwierigkeit |
|---|---|---|---|---|
| wx-favorites-report | Favoriten | Mac | ⭐⭐⭐⭐⭐ | Mittel |
| WeChatMsg | Chatverläufe | Windows | ⭐⭐⭐ | Mittel |
| PyWxDump | Chatverläufe + Kontakte | Windows | ⭐⭐ | Hoch |
| WeChat-eigene Favoritensuche | Favoriten | Alle Plattformen | ⭐ | Niedrig |
Die einzigartigen Vorteile von wx-favorites-report sind:
- Fokus auf Favoriten: Nicht so groß und komplex wie Chatverlauf-Tools
- Hochwertige Visualisierung: 7 professionelle Diagrammtypen, weit über der einfachen WeChat-Listensuche
- Einseitige Ausgabe: Keine zusätzliche Software zum Anzeigen erforderlich
- Claude Code-Integration: Ein einziger Befehl für den gesamten Prozess
Wenn Sie sich auch für WeChat-Chatverläufe interessieren, werfen Sie einen Blick auf unseren früheren Artikel PyWxDump im Test.
8. Anwendungsszenarien
8.1 Persönliches Datenmanagement
Regelmäßige Erstellung von Favoriten-Berichten hilft Ihnen:
- Abgelaufene oder nutzlose Favoriten zu bereinigen
- Vergessene hochwertige Inhalte wiederzufinden
- Eine Materialliste für Ihre persönliche Wissensdatenbank zu erstellen
8.2 Inhaltsorganisation
Wenn Sie Content Creator sind, kann der Favoriten-Bericht:
- Die Bereiche und Themen analysieren, die Sie interessieren
- Muster bei der Quelle Ihrer Inhaltsinspirationen aufdecken
- Datenbasierte Unterstützung für die Themenauswahl bieten
8.3 Analyse der Nutzungsgewohnheiten
Reflektieren Sie Ihr Informationskonsumverhalten anhand der Daten:
- Ist „Speichern gleich Vergessen”?
- Hängt das Speicherverhalten mit Angst zusammen?
- Wie können Sie ein effektiveres Informationsmanagementsystem aufbauen?
9. Einschränkungen und Hinweise
9.1 Plattform-Einschränkungen
- Nur macOS unterstützt: Die Schlüsselextraktion benötigt Frida und den WeChat-Mac-Client
- WeChat-Version erforderlich: Aktuell kompatibel mit Mac 4.x, 3.x hat eine andere Tabellenstruktur
- WeChat muss angemeldet sein: Ein aktives WeChat-Konto ist erforderlich
9.2 Datenschutz
- Alle Datenverarbeitung erfolgt lokal, es werden keine Daten an Server hochgeladen
- Die HTML-Berichtsdatei enthält Ihre Favoritendaten – nicht öffentlich teilen
- Während der Frida-Ausführung wird der WeChat-Prozess gehookt; nach Abschluss sollte die signierte Kopie geschlossen werden
9.3 Bekannte Einschränkungen
- Bilder/Videos/Dateien werden im WeChat-CDN gespeichert (verschlüsseltes Format) und können im Bericht nicht angezeigt werden
- Artikel-Vorschaubilder stammen vom WeChat-CDN; zum Anzeigen des Berichts ist eine Internetverbindung erforderlich
- Nach jedem WeChat-Update muss die Desktop-Kopie möglicherweise neu signiert werden
10. FAQ
F1: Ist wx-favorites-report sicher? Werden meine WeChat-Daten weitergegeben?
Die gesamte Datenverarbeitung erfolgt vollständig lokal, es werden keine Daten an Server hochgeladen. Frida hookt nur lokal den WeChat-Prozess zur Schlüsselextraktion, und der generierte Bericht ist eine reine lokale HTML-Datei. Bitte bewahren Sie die generierte Berichtsdatei sicher auf und teilen Sie sie nicht öffentlich.
F2: Werden Windows oder die mobile WeChat-Version unterstützt?
Derzeit wird nur der WeChat Mac 4.x-Client auf macOS unterstützt. Die Verschlüsselungsmechanismen unter Windows und auf Mobilgeräten sind unterschiedlich und werden derzeit nicht unterstützt. Wenn Sie ein WeChat-Daten-Tool für Windows benötigen, schauen Sie sich PyWxDump an.
F3: Funktioniert es noch nach einem WeChat-Update?
Größere WeChat-Updates können die Datenbankstruktur oder Verschlüsselungsmethode ändern, sodass Sie auf eine Tool-Anpassung warten müssen. Kleinere Updates beeinflussen in der Regel die Nutzung nicht, aber nach jedem Update muss die Desktop-Kopie neu signiert werden.
F4: Kann der generierte Bericht geteilt werden?
Der Bericht ist eine einseitige HTML-Datei und kann offline angezeigt werden. Da er jedoch Ihre persönlichen Favoritendaten enthält, empfehlen wir, ihn nur selbst zu verwenden und nicht auf öffentliche Websites hochzuladen oder mit anderen zu teilen.
F5: Kann ich es auch ohne Claude Code verwenden?
Ja. Claude Code bietet nur den Komfort der Ein-Klick-Ausführung. Wenn Sie die Schritte in der Dokumentation manuell befolgen, können Sie den gesamten Prozess ebenfalls abschließen. Die Kernskripte (parse_favorites.py und generate_report.py) sind eigenständige Python-Programme.
11. Fazit
wx-favorites-report ist die derzeit vollständigste Lösung zur Visualisierung von WeChat-Favoriten, die ich kenne. Es löst das Problem, dass „WeChat-Favoritendaten nicht exportiert und analysiert werden können”, und die vollständige Automatisierung von der verschlüsselten Datenbank bis zum interaktiven Bericht ist ausgereift.
Vorteile:
- Vollständige Automatisierung – von der Entschlüsselung bis zum Bericht mit einem Klick
- 7 Visualisierungsdiagramme für umfassende Dateneinblicke
- Einseitige HTML-Ausgabe, anschaubar ohne Abhängigkeiten
- Claude Code-Integration senkt die Einstiegshürde
Nachteile:
- Nur macOS unterstützt – Windows-/Mobilnutzer können es nicht verwenden
- Die Schlüsselextraktion erfordert gewisse technische Kenntnisse
- Bilder-/Videoinhalte können im Bericht nicht angezeigt werden
Wenn Sie ein „intensiver Sammler” ist und herausfinden möchten, was Sie eigentlich gespeichert haben und wie Ihre Speichergewohnheiten aussehen, ist wx-favorites-report einen Versuch wert.
Wir hoffen, dieser Blogartikel war hilfreich! Wenn Sie sich für WeChat-Datenverwaltung interessieren, werfen Sie einen Blick auf unsere Sammlung von KI-Tool-Tests, um weitere nützliche Datenanalyse- und Visualisierungstools kennenzulernen.
