Chatlog: Open-Source-Tool zum Extrahieren und Abfragen von WeChat-Chat-Protokollen

Allgemeine Einführung

Chatlog ist ein Open-Source-Tool, das sich auf das Extrahieren und Abfragen von Chat-Protokollen aus der lokalen Datenbank von WeChat konzentriert. Es unterstützt die WeChat-Versionen 3.x und 4.0 und deckt sowohl Windows- als auch macOS-Systeme ab. Benutzer können Chatprotokolle, Kontakte, Gruppenchats und aktuelle Unterhaltungen über die Befehlszeile, die Terminalschnittstelle oder HTTP-API-Operationen anzeigen. MCP SSE-Protokoll, das mit KI-Assistenten (z. B. ChatWise) integriert werden kann, um Chat-Daten schnell zu analysieren. Das Projekt basiert auf der Apache-2.0-Lizenz, und der Code ist offen, sicher und zuverlässig, geeignet für Benutzer, die WeChat-Daten organisieren oder analysieren müssen.

Funktionsliste

• Extrahieren Sie Chat-Protokolle, Kontakte, Gruppenchats und aktuelle Unterhaltungen aus der lokalen WeChat-Datenbank.
• Unterstützt WeChat Version 3.x und 4.0, kompatibel mit mehreren Datenformaten.
• Bietet eine Terminalschnittstelle (TUI) und Befehlszeilentools für eine intuitive Bedienung.
• Integrierte HTTP-API zur Unterstützung der Abfrage von Chat-Protokollen, Kontakten, Gruppenchats und anderen Informationen.
• Unterstützt das MCP SSE-Protokoll für nahtlose Konnektivität mit kompatiblen KI-Assistenten.
• Bieten Sie eine Datenentschlüsselungsfunktion, um sicherzustellen, dass die Benutzer sicher auf lokale Daten zugreifen können.
• Offener Quellcode, der Benutzer kann die Sicherheit überprüfen oder die Funktionen anpassen.

Hilfe verwenden

Das Ziel von Chatlog ist es, den Benutzern die Möglichkeit zu geben, WeChat-Chat-Protokolle einfach zu extrahieren und abzufragen. Nachfolgend finden Sie eine detaillierte Installations- und Nutzungsanleitung, um den Benutzern einen schnellen Einstieg zu ermöglichen.

Einbauverfahren

Chatlog erfordert eine gewisse technische Bedienung und ist für Benutzer mit Grundkenntnissen geeignet. Nachfolgend finden Sie die Installationsschritte:

1. Vorbereiten der Umgebung
   Stellen Sie sicher, dass die folgende Software auf Ihrem Computer installiert ist:
   • WeiterDie neueste Version wird empfohlen, Installationsanweisungen finden Sie auf der Go-Website.
   • Xcode(macOS-Benutzer): Laden Sie den Schlüssel aus dem App Store herunter, um ihn zu extrahieren.
   • WeChat-ClientVergewissern Sie sich, dass Sie installiert und eingeloggt sind und dass die Chatprotokolle auf Ihren Computer migriert werden müssen.
2. Installation von der Quelle aus
   Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus, um Chatlog zu installieren:

   go install github.com/sjzar/chatlog@latest
   

   Nach der Installation kann Chatlog direkt von der Kommandozeile aus gestartet werden.

3. Vorkompilierte Version herunterladen
   Wenn Sie nicht vom Quellcode kompilieren möchten, besuchen Sie GitHub Releases und laden Sie eine vorkompilierte Version für Ihr System herunter (z. B. Windows oder macOS). Nach dem Herunterladen entpacken Sie sie und verwenden sie.
4. macOS-Benutzer schalten SIP aus
   Bei macOS-Systemen sollte SIP aufgrund von Sicherheitsbeschränkungen vorübergehend deaktiviert werden, wenn Schlüssel extrahiert werden, wie folgt:
   • Rufen Sie den Wiederherstellungsmodus auf:
     • Intel-MacNach dem Ausschalten drücken und halten Command + R Taste, um den Computer einzuschalten, bis das Apple-Logo erscheint.
     • Apple Silizium MacDrücken Sie nach dem Ausschalten des Computers die Einschalttaste und halten Sie sie gedrückt, bis Sie die Boot-Option sehen.
   • Öffnen Sie ein Terminal und geben Sie ein:

     csrutil disable
     

   • Starten Sie das System neu:

     sudo reboot
     

   • Nach dem Extrahieren des Schlüssels wird empfohlen, das SIP wieder zu aktivieren (führen Sie das csrutil enable (und Neustart).
5. WeChat-Chat-Datensätze migrieren
   Arbeiten Sie in WeChat auf Ihrem Mobiltelefon:
   • Öffnen Sie "Ich - Einstellungen - Allgemein - Chat-Verlauf Migration & Backup - Migration - Auf PC migrieren".
   • Befolgen Sie die Anweisungen, um Chat-Aufzeichnungen auf Ihren Computer zu übertragen WeChat-Client. Dieser Vorgang hat keine Auswirkungen auf die Daten des Mobiltelefons.

Hauptfunktionen

Chatlog bietet mehrere Möglichkeiten, WeChat-Chat-Daten zu verwalten. Hier erfährst du, wie du die wichtigsten Funktionen nutzen kannst:

• Daten extrahieren und entschlüsseln
  Nach dem Start von Chatlog fragt das Programm nach dem Pfad zur WeChat-Datenbank (normalerweise in der macOS ~/Library/Containers/com.tencent.xinWeChat/Data/Library/Application Support/com.tencent.xinWeChat/ (oder das WeChat-Installationsverzeichnis für Windows). Nachdem Sie den Pfad eingegeben haben, führen Sie den folgenden Befehl aus, um die Daten zu entschlüsseln:

  ./chatlog decrypt
  

  Die entschlüsselten Daten können zur Abfrage oder Anzeige verwendet werden.

• Operationen an der Terminalschnittstelle (TUI)
  Starten Sie die Terminalschnittstelle:

  ./chatlog
  

  Arbeitsweise:

  • Verwenden Sie die Pfeiltasten, um im Menü zu navigieren.
  • drücken. Enter Wählen Sie die Option.
  • drücken. Esc Zurück zur vorherigen Ebene.
  • drücken. Ctrl+C Ausstiegsverfahren.
    Auf der Terminalschnittstelle werden Chatprotokolle, Kontakte und andere Informationen angezeigt, die sich für eine schnelle Anzeige eignen.
• Kommandozeilenabfrage
  Holen Sie sich den Microsoft-Datenschlüssel:

  ./chatlog key
  

  Abfrage spezifischer Daten (z. B. Chatprotokolle)

  ./chatlog decrypt
  

  Die Befehlszeile eignet sich für Stapelverarbeitungsvorgänge oder Skriptverarbeitung.

• HTTP-API-Verwendung
  Starten Sie den HTTP-Dienst (Standardport 5030):

  ./chatlog
  

  Zugang über Browser http://127.0.0.1:5030 Zeigen Sie die Daten an, oder fragen Sie sie über die API ab:

  • Chatprotokoll::

    GET /api/v1/chatlog?time=2023-01-01&talker=wxid_xxx&limit=100&offset=0&format=json
    

    Parameter Beschreibung:

    • timeZeitbereich, z.B. 2023-01-01 vielleicht 2023-01-01~2023-12-31.
    • talkerChat-ID, WeChat-ID, Spitzname oder Gruppen-Chat-ID unterstützen.
    • limitAnzahl der Datensätze: Gibt die Anzahl der Datensätze zurück.
    • offset: Paging-Offset.
    • format: Ausgabeformat (jsonundcsv (oder Text).
  • Kontaktliste::

    GET /api/v1/contact
    

  • Gruppenchat-Liste::

    GET /api/v1/chatroom
    

  • Jüngste Sitzungen::

    GET /api/v1/session
    

• Browser-Ansicht
  Nachdem Sie den HTTP-Dienst gestartet haben, öffnen Sie einen Browser und besuchen Sie http://127.0.0.1:5030. Die Seite zeigt Chataufzeichnungen, Kontakte und andere Inhalte an, unterstützt die Sortierung nach Zeit oder Objekt und ist intuitiv zu bedienen.

Featured Function Bedienung

Die Einzigartigkeit von Chatlog liegt in seinem Open-Source-Design und der KI-Integration. Hier sind die Details der Funktionen:

• MCP SSE-Protokoll-Integration
  Chatlog unterstützt das MCP SSE Protokoll für die Verbindung mit KI-Assistenten (z.B. ChatWise, Claude). Setup-Schritte:
  • Starten Sie den HTTP-Dienst von Chatlog.
  • Fügen Sie ein neues Werkzeug zu den Einstellungen des KI-Assistenten hinzu:
    • Art:sse.
    • URL:http://127.0.0.1:5030/sse.
    • Markieren Sie "Automatisierte Ausführungswerkzeuge".
  • Nach der Konfiguration kann der KI-Assistent Chat-Datensätze direkt abfragen. Wenn Sie z. B. in ChatWise "Chats mit Xiaoming gestern finden" eingeben, gibt der Assistent die entsprechenden Datensätze zurück.
  • Wenn das AI-Tool MCP SSE nicht unterstützt, verwenden Sie die mcp-proxy Leiten Sie die Anfrage weiter. Zum Beispiel kann die Claude Auf dem Desktop bearbeiten config.json::

    {
    "mcpServers": {
    "mcp-proxy": {
    "command": "/path/to/mcp-proxy",
    "args": ["http://localhost:5030/sse"],
    "env": {}
    }
    }
    }
    

• Open Source und Anpassung
  Chatlog basiert auf der Apache-2.0-Lizenz und der Code ist öffentlich zugänglich, so dass Benutzer die Sicherheit überprüfen oder die Funktionalität ändern können. Zum Beispiel:
  • Fügen Sie ein neues Exportformat hinzu (z. B. CSV):
    • Compiler src/export.goExportlogik hinzufügen.
    • in Bewegung sein go build Neu kompilieren.
  • Optimieren Sie die Abfragegeschwindigkeit:
    • Änderungen src/query.gound passt den Datenbankindex an.
      Das Open-Source-Design ermöglicht es den Benutzern, die Funktionalität nach Bedarf zu erweitern.

Zusätzliche Funktionen (die in der offiziellen Beschreibung erwähnt werden, aber in der ursprünglichen Präsentation fehlen)

• Multisystem-Unterstützung
  Chatlog ist sowohl mit Windows als auch mit macOS kompatibel, und der Prozess ist einheitlich, um einen plattformübergreifenden Zugriff zu gewährleisten.
• Planungsfunktion (TODO)
  Laut der offiziellen Mitteilung wird Chatlog in Zukunft unterstützt werden:
  • Extraktion von Multimedia-Daten (z. B. Bilder, Sprache).
  • Volltextindizierung von Chatdaten zur Beschleunigung der Suche.
  • Dashboard für Datenstatistiken, das die Ergebnisse von Analysen wie Nachrichtenhäufigkeit, Schlüsselwörter usw. anzeigt.
    Diese Funktionen sind noch nicht live, zeigen aber die Richtung der kontinuierlichen Verbesserung des Projekts.

caveat

• DatensicherheitChatlog: Chatlog verarbeitet nur lokale Daten und lädt sie nicht ins Web hoch. Benutzer können den Code über GitHub überprüfen, um die Sicherheit zu bestätigen.
• SIP-BetriebmacOS-Benutzer müssen SIP nur deaktivieren, wenn sie Schlüssel extrahieren, und es wieder aktivieren, wenn sie fertig sind.
• WeChat-VersionVergewissern Sie sich, dass der WeChat-Client Version 3.x oder 4.0 ist, andere Versionen sind möglicherweise nicht kompatibel.
• Daten sichernEs wird empfohlen, Ihre Microsoft-Datenbankdateien regelmäßig zu sichern, um einen versehentlichen Verlust zu vermeiden.

Mit diesen Schritten können Nutzer Chatlog einfach installieren, Chatprotokolle extrahieren oder die Daten mit APIs und KI-Assistenten analysieren.

Anwendungsszenario

1. Organisieren Sie Ihre Chats
   Wenn Benutzer WeChat-Nachrichten mit Freunden oder Gruppenchats speichern möchten, kann Chatlog die Aufzeichnungen extrahieren und organisieren, um sie einfach zu archivieren oder zu exportieren.
2. Gruppenchat-Management
   Wenn ein Gruppenchat mit Nachrichten überladen ist, kann Chatlog schnell die Reden oder Schlüsselwörter bestimmter Mitglieder nachschlagen, was es für Gruppenadministratoren geeignet macht.
3. Datenanalyse
   Entwickler benötigen Statistiken über die Chat-Häufigkeit oder Schlüsselwörter, und Chatlogs HTTP-API liefert strukturierte Daten, die sich für Untersuchungen oder Berichte eignen.
4. KI-Zusammenarbeit
   Die Nutzer möchten, dass ein KI-Assistent herausfindet, worüber sie chatten, und mit der MCP SSE-Unterstützung von Chatlog kann die KI die Daten direkt lesen und analysieren.

QA

1. Welche Systeme werden von Chatlog unterstützt?
   Unterstützt Windows und macOS und ist kompatibel mit den WeChat-Versionen 3.x und 4.0.
2. Wie gewährleisten Sie die Datensicherheit?
   Chatlog ist ein Open-Source-Tool, bei dem die Daten nur lokal verarbeitet werden, der Code öffentlich zugänglich ist und nicht ins Internet hochgeladen wird.
3. macOS Warum muss ich SIP deaktivieren?
   Der Sicherheitsmechanismus von WeChat schränkt die Schlüsselextraktion ein, und die Deaktivierung von SIP ist ein vorübergehender Vorgang, der nach Abschluss wieder aktiviert werden kann.
4. Welche Datenabfragen unterstützt die API?
   Unterstützung von Chatprotokollen, Kontakten, Gruppenchats und Abfragen der letzten Sitzung in den Formaten JSON und CSV.
5. Wie funktioniert die Integration mit KI-Assistenten?
   Starten Sie den SSE-Dienst von Chatlog und konfigurieren Sie die Tool-URL des KI-Assistenten so, dass sie lautet http://127.0.0.1:5030/sse Es kann losgehen.