WeChat 4.x Chatverlauf entschlüsseln & abfragen (macOS + Windows)
Erster Start – Selbstprüfung (Agent MUSS ausführen)
python3 -c "import platform; print(platform.system())"
claude mcp list 2>&1 | grep -q "wechat.*Connected" && echo "MCP_OK" || echo "MCP_MISSING"
test -f ~/.claude/skills/wechat-decrypt/key.txt && echo "KEY_OK" || echo "KEY_MISSING"
| Status | Aktion |
|---|---|
MCP_MISSING | macOS bash setup.sh / Windows powershell -File setup.ps1, anschließend „Claude Code neu starten“ |
KEY_MISSING | Schlüsselextraktion gemäß Plattform durchführen (unter Windows nach Schlüsselextraktion zusätzlich python scripts\windows\decrypt_all.py ausführen, um die gesamte Datenbank zu entschlüsseln) |
| Alle OK | MCP-Tools direkt nutzen |
Windows-Selbstprüfung (PowerShell, analog zu den drei macOS-Punkten oben):
python -c "import frida, Crypto; print('DEPS_OK')" # fehlt → pip install frida pycryptodome Test-Path "$env:USERPROFILE\.claude\skills\wechat-decrypt\key_windows.txt" # fehlt → extract_raw_key.py ausführen Test-Path "$env:USERPROFILE\.claude\skills\wechat-decrypt\decrypted" # fehlt → decrypt_all.py ausführenFehlende Schritte nachholen: deps→
setup.ps1, key→extract_raw_key.py, Klartext-DB→decrypt_all.py.
Selbstprüfung nicht überspringen.
Agent-Auslöseregeln
| Benutzerabsicht | Aktion |
|---|---|
| „Zeig mir meine WeChats“ „Letzte Chats“ „Wer hat geschrieben“ „Gibt es neue Nachrichten“ | MCP: wechat_recent_messages / wechat_chat_summary |
| „Suche Chat mit X“ „In Unterhaltung mit X erwähnt“ | MCP: wechat_search_messages |
| „Chats auflisten“ „Welche Gruppen gibt es“ | MCP: wechat_list_chats |
| „Lies den Chat mit X“ | MCP: wechat_read_chat |
| „Exportiere Chat mit X“ „Exportiere X auf den Desktop“ | Zuerst ① Modellprüfung durchführen (siehe unten), dann python3 scripts/common/export_chat.py <contact> [--start/--end/--year] [-o Pfad] (ohne Datum = gesamter Verlauf; Modell vorhanden → Transkription standardmäßig aktiv, --no-transcribe deaktiviert; Spracherkennungsergebnisse werden in voice_cache.json zwischengespeichert, zweiter Export erfolgt sofort) |
| „Transkribiere die Sprachnachricht von X“ „Sprache in Text umwandeln“ „Exportiere Sprachnachrichten als Text“ | python3 scripts/common/export_chat.py <contact> --transcribe, oder separat python3 scripts/common/transcribe_db.py <contact> -o map.json |
| „WeChat wurde aktualisiert“ „Erneut entschlüsseln“ „Schlüssel ungültig“ | Schlüsselextraktion gemäß Plattform unten durchführen |
① Export-Vorbereitung – Prüfung des Spracherkennungsmodells (standardmäßig ausführen)
Vor dem Export/Transkribieren eines Chats, der Sprachnachrichten enthalten könnte, prüfen, ob das Modell vorhanden ist:
test -d ~/.cache/huggingface/hub/models--mlx-community--whisper-large-v3-mlx && echo MODEL_OK || echo MODEL_MISSING
| Ergebnis | Aktion |
|---|---|
MODEL_OK | Export standardmäßig mit Spracherkennung (Skript erkennt Modell und transkribiert automatisch, --transcribe nicht nötig; nur wenn Benutzer explizit keine Transkription wünscht, --no-transcribe verwenden) |
MODEL_MISSING | Benutzer fragen, ob er das Modell installieren möchte (whisper-large-v3 ~3 GB, reine Offline-Installation, einmalig). Bei Zustimmung → --transcribe hinzufügen (downloadet Modell beim ersten Mal automatisch und transkribiert); bei Ablehnung → normaler Export, Sprachnachrichten bleiben als [Audio] erhalten |
Das Skript enthält bereits die gleiche Logik (Modell vorhanden → Transkription standardmäßig aktiv, nicht vorhanden → [Audio] und Hinweis). Aber bei MODEL_MISSING MUSS der Agent den Benutzer aktiv fragen und nicht eigenmächtig 3 GB herunterladen.
MCP-Tools (Registrierungsname wechat)
| Tool | Parameter | Zweck |
|---|---|---|
wechat_list_chats | Keine | Alle Unterhaltungen (Gruppennamen + Notizen bereits aufgelöst) |
wechat_read_chat | contact, limit(50), days(7) | Bestimmte Unterhaltung |
wechat_search_messages | keyword, days(30), limit(50) | Volltextsuche |
wechat_recent_messages | days(3), limit(100) | Neueste Nachrichten |
wechat_chat_summary | days(3) | Strukturierte Zusammenfassung + offene Punkte |
[Ich] = vom Benutzer gesendet, [Anderer] = vom Kontakt gesendet.
Spracherkennung (vollautomatisch)
Sprachnachrichten (local_type=34) werden als SILK v3 in media_0.db in VoiceInfo.voice_data gespeichert, Verknüpfung über svr_id == server_id. Kette: Direkt aus VoiceInfo lesen → pilk decodiert SILK→wav → whisper large-v3 transkribiert → server_id zurückverknüpfen. Vollautomatisch, Stapelverarbeitung, rein offline, kein BlackHole/Wiedergabe/Neustart nötig. Standardverhalten: Modell bereits gecached → automatische Transkription; --transcribe erzwingt (beinhaltet erstmaligen Download des ~3 GB Modells, Cache in ~/.cache/huggingface/); --no-transcribe deaktiviert. Backend plattformabhängig: macOS = mlx-whisper (Apple Silicon), Windows = faster-whisper (CPU int8, wird bei Bedarf heruntergeladen); das alte BlackHole+Swift-Schema befindet sich im langlobal Entwicklungs-Repo.
CLI-Einstiegspunkte (Logikkern; MCP ist optionale, dünne Fassade)
Der Logikkern befindet sich in scripts/common/query.py (Kommandozeile), die MCP-Tools in server.py leiten nur dorthin weiter. Agent-Aufrufe sollten --json verwenden, um strukturierte Ausgabe zu erhalten (zuverlässiger zu parsen, nicht von Textformatierung beeinflusst); Menschen lassen --json für Debugging weg, um lesbaren Text zu sehen.
SKILL_DIR=~/.claude/skills/wechat-decrypt
python3 "$SKILL_DIR/scripts/common/query.py" list
python3 "$SKILL_DIR/scripts/common/query.py" recent -d 3 --json # Agent: --json verwenden
python3 "$SKILL_DIR/scripts/common/query.py" search Suchbegriff --json
# Unterbefehle: list / read <contact> / search <kw> / recent / summary / stats / media / openfile
Schlüsselsystem (plattformübergreifend)
- Raw Key: 64 Hex-Zeichen, pro Gerät einzigartig (WeChat 4.0: Raw Key für dasselbe Konto unter macOS und Windows unterschiedlich, nicht austauschbar); solange WeChat nicht aktualisiert wird, bleibt er gültig.
- Ableitungsformel:
PBKDF2-HMAC-SHA512(raw_key, db_file_salt, 256000) → 32 Bytes - SQLCipher-Parameter:
PRAGMA key = "x'<derived>'"; PRAGMA kdf_iter = 1; PRAGMA cipher_compatibility = 4; PRAGMA cipher_page_size = 4096;
Datenbankpfade
| Plattform | Pfad |
|---|---|
| macOS | ~/Library/Containers/com.tencent.xinWeChat/.../xwechat_files/{wxid}/db_storage/ |
| Windows | ~/Documents/xwechat_files/{wxid}/db_storage/ |
Schlüsselextraktion
macOS
Agent-Ablauf
- Prüfe Resignierung:
codesign -dv /Applications/WeChat.app 2>&1 | grep -q "Signature=adhoc" || echo "NEED_RESIGN"NEED_RESIGN→ Benutzer auffordern:sudo codesign --force --deep --sign - /Applications/WeChat.app
- Ausführen:
bash ~/.claude/skills/wechat-decrypt/scripts/macos/extract_key.sh - Skript startet WeChat → Benutzer zum Anmelden auffordern → nach der Anmeldung wird der Schlüssel automatisch in
key.txtgeschrieben. - Verifikation:
test -f ~/.claude/skills/wechat-decrypt/key.txt && echo "OK" - Nach der Extraktion muss der Benutzer aufgefordert werden, die Signatur wiederherzustellen: Adhoc-Resignierung ist ein destruktiver, einmaliger Vorgang, der die Originalsignatur von Tencent überschreibt und zu wiederholten Berechtigungsdialogen für Screenshots/Datenzugriff führen kann. Codesign kann keine Drittanbieter-Signatur wiederherstellen; nur eine Neuinstallation von WeChat stellt die Originalsignatur wieder her. Chatverläufe befinden sich in einem separaten Container-Verzeichnis (
~/Library/Containers/com.tencent.xinWeChat/), die Neuinstallation von/Applications/WeChat.apphat darauf keinen Einfluss. Nach der Schlüsselextraktion wird für die tägliche Abfrage nur lesend auf die DB zugegriffen, die Resignierung ist nicht mehr nötig.
Wichtiges Verständnis
- Resignierung ist nur für den Moment der Schlüsselextraktion erforderlich; danach sollte WeChat neu installiert werden, um die Signatur wiederherzustellen.
- Wiederholte Berechtigungsdialoge = Symptom einer Adhoc-Signatur, nicht verursacht durch Claude Code/MCP.
- Schlüssel ist pro Gerät einzigartig (unterschiedlich für dasselbe Konto auf verschiedenen Geräten, nicht austauschbar). Solange WeChat nicht aktualisiert wird, bleibt er gültig und muss nicht erneut extrahiert werden.
Funktionsprinzip
Die macOS-Version von WeChat 4.x verwendet nicht sqlite3_key (diese Funktion in Apples System-SQLite ist eine Hülse), sondern ruft über die einheitliche WCDB-Verschlüsselungsschicht CCKeyDerivationPBKDF (CommonCrypto) auf. Frida nutzt Module.findGlobalExportByName (Frida 17.x+ API), um diese Funktion zu hooken und bei passwordLen=32, rounds>1000, dkLen=32 das Passwort-Parameter (Raw Key) abzufangen.
Windows (Gelöst: Schlüsselextraktion → Entschlüsselung → Lesen, gleiche Fähigkeiten wie macOS)
Status (2026-06-06 UTM-Test erfolgreich): Schlüsselextraktion → gesamte Datenbank entschlüsseln → MCP/Export/Spracherkennung, gleiche Fähigkeiten wie macOS. message_0 hat 99 Unterhaltungen/1384 Nachrichten entschlüsselt. Vollständiger Ablauf siehe docs/2026-06-06-windows-raw-key-journey.md.
Agent-Ablauf
- Bei WeChat anmelden
- Schlüssel extrahieren:
python scripts\windows\extract_raw_key.py→ Aufforderung folgen: WeChat auf dem Desktop manuell neu starten (erforderlich; per schtasks/SSH gestartete WeChat-Instanzen sind Hülsen und lesen keine DB) → Skript führt automatisch Race-Attach + Hook auf sha512 durch, um den Raw Key abzufangen und zu verifizieren, und schreibt ihn inkey_windows.txt - Gesamte Datenbank entschlüsseln:
python scripts\windows\decrypt_all.py→ Verwendet den Raw Key, um alle Datenbanken indb_storageindecrypted\{wxid}_<device>\db_storage\(Klartext) zu entschlüsseln. - Claude Code neu starten → MCP-Tools, Export und Spracherkennung sind identisch zu macOS (server/export/transcribe verwenden
DB_BACKEND="sqlite3", um die Klartext-Datenbank zu lesen; Spracherkennung verwendet faster-whisper).
Einzelne Datenbank verifizieren/debuggen mit scripts\windows\decrypt_read.py <raw_key> (entschlüsselt nur message_0 zur Verifikation).
Funktionsprinzip der Schlüsselextraktion (sha512-Einstiegspunkt + HMAC ipad)
Kern: Raw Key/K1 ist im Speicher dreifach geschützt (AES-NI Rundenkeys/Nach Gebrauch löschen/secure mem, Memory-Brute-Force schlägt fehl), aber der SQLCipher-Ableitungsschlüssel geht über PBKDF2-HMAC-SHA512, und während der HMAC-Konstruktion des ipad-Blocks liegt der Schlüssel im Klartext vor (key XOR 0x36, die letzten 96 Bytes sind konstant 0x36) – dies umgeht allen Schutz.
extract_raw_key.py ist in sich geschlossen: Automatische Lokalisierung des sha512-Einstiegspunkts (Suche nach K-Konstante 0x428a2f98d728ae22 → Xref → Disassemblierung, keine fest codierten Adressen, funktioniert auch mit anderen WeChat-Versionen) + Race-Attach (vor dem Öffnen der DB) + Hook auf den Einstiegspunkt (rdx=input block) + Erkennung von ipad + automatische Verifikation (PBKDF2→AES page1 raus = Raw Key (universell) / AES raus = K1 (einzelne DB)). Start von PBKDF2(raw,salt) gibt Raw Key preis; während der Laufzeit gibt page-MAC nur mac_key (nutzlos) preis → der Start muss per Race erreicht werden.
Frida kann unter ARM-Emulation (xtajit übersetzt x64) interne x64-Funktionen von WeChat hooken (11,27 Millionen Verifikationen); da Spawn nicht kompatibel ist, wird Race-Attach verwendet.
- Datenpfad:
C:\Users\<Benutzer>\Documents\xwechat_files\{wxid}_<device>\db_storage\.wechat-dump-rswurde per DMCA gesperrt, diese Methode ist der Ersatz. - Das vollständige Entwicklungsskript-Set (Lokalisierung/Brute-Force/Fehlerprotokolle) befindet sich im langlobal Entwicklungs-Repo; für den Betrieb reichen
extract_raw_key.py+decrypt_all.py.
Verteilung & Installation
Das gesamte Skill-Verzeichnis kopieren. Der Empfänger führt aus:
macOS: bash setup.sh
Windows: powershell -File setup.ps1
key.txt, contacts.json, all_keys.json, voice_cache.json sind persönliche Daten; vor der Verteilung löschen (bereits in .gitignore).
Dateiliste
~/.claude/skills/wechat-decrypt/ # Laufende Einheit; vollständige Entwicklung (Tests/Docs/Skripte/Legacy) im langlobal Entwicklungs-Repo
├── server.py config.py crypto.py db.py contacts.py message.py ← MCP-Kern (6), db.py mit zwei Backends
├── scripts/
│ ├── common/ ← Plattformübergreifend: export_chat(Export+Transkription) transcribe_db voice_decode sqlcipher_decrypt read_doc export_media verify_key
│ ├── macos/ ← extract_key.sh + hook_pbkdf.js (CCKeyDerivationPBKDF)
│ └── windows/ ← extract_raw_key.py (in sich geschlossene Schlüsselextraktion) decrypt_all.py (gesamte DB entschlüsseln → Klartext) decrypt_read.py (Einzel-DB-Verifikation)
├── setup.sh / setup.ps1 ← Plattforminstallation
├── SKILL.md README.md LICENSE
├── key.txt key_windows.txt ← .gitignore
└── contacts.json ← .gitignore
Abhängigkeiten: macOS systemweites Python (mcp/frida/cryptography/pilk/mlx-whisper/zstd); Windows (mcp/frida/pycryptodome/pilk/faster-whisper/zstandard). Spracherkennungsmodell-Cache: ~/.cache/huggingface/.