Chatlog : outil open source permettant d'extraire et d'interroger les journaux de discussion de WeChat

Introduction générale

Chatlog est un outil open source qui se concentre sur l'extraction et l'interrogation des journaux de chat à partir de la base de données locale de WeChat. Il prend en charge les versions 3.x et 4.0 de WeChat, pour les systèmes Windows et macOS. Les utilisateurs peuvent afficher les journaux de discussion, les contacts, les discussions de groupe et les conversations récentes à partir de la ligne de commande, de l'interface de terminal ou des opérations de l'API HTTP. MCP SSE, qui peut être intégré à des assistants d'intelligence artificielle (par exemple ChatWise) pour analyser rapidement les données des chats. Le projet est basé sur la licence Apache-2.0, et le code est ouvert, sûr et fiable, adapté aux utilisateurs qui ont besoin d'organiser ou d'analyser les données WeChat.

Liste des fonctions

• Extrait les journaux de chat, les contacts, les chats de groupe et les conversations récentes de la base de données locale de WeChat.
• Prend en charge les versions 3.x et 4.0 de WeChat, compatible avec de nombreux formats de données.
• Fournit une interface de terminal (TUI) et des outils de ligne de commande pour un fonctionnement intuitif.
• API HTTP intégrée permettant d'interroger les journaux de discussion, les contacts, les discussions de groupe et d'autres informations.
• Prend en charge le protocole MCP SSE pour une connectivité transparente avec les assistants d'intelligence artificielle compatibles.
• Fournir une fonction de décryptage des données afin que les utilisateurs puissent accéder en toute sécurité aux données locales.
• Code source ouvert, l'utilisateur peut vérifier la sécurité ou personnaliser les fonctionnalités.

Utiliser l'aide

L'objectif de Chatlog est de permettre aux utilisateurs d'extraire et d'interroger facilement les journaux de chat de WeChat. Vous trouverez ci-dessous un guide d'installation et d'utilisation détaillé pour aider les utilisateurs à démarrer rapidement.

Processus d'installation

Chatlog nécessite quelques opérations techniques et convient aux utilisateurs ayant des connaissances de base. Voici les étapes de l'installation :

1. Préparation de l'environnement
   Assurez-vous que les logiciels suivants sont installés sur votre ordinateur :
   • AllerLa dernière version est recommandée, voir le site web de Go pour les instructions d'installation.
   • Xcode(Utilisateurs de macOS) : Téléchargez l'App Store pour l'extraction des clés.
   • Client WeChatLes journaux de chat doivent être migrés sur votre ordinateur.
2. Installation à partir de la source
   Ouvrez un terminal et exécutez la commande suivante pour installer Chatlog :

   go install github.com/sjzar/chatlog@latest
   

   Après l'installation, Chatlog peut être exécuté directement à partir de la ligne de commande.

3. Télécharger la version pré-compilée
   Si vous ne souhaitez pas compiler à partir des sources, visitez GitHub Releases et téléchargez une version précompilée pour votre système (par exemple Windows ou macOS). Une fois téléchargée, décompressez-la et utilisez-la.
4. Les utilisateurs de macOS désactivent le protocole SIP
   Pour le système macOS, en raison des restrictions de sécurité, le protocole SIP doit être temporairement désactivé lors de l'extraction des clés, comme suit :
   • Accéder au mode de récupération :
     • Intel MacLa fonction d'alerte est assurée par une pression prolongée après l'extinction de l'appareil. Command + R pour allumer l'ordinateur jusqu'à ce que le logo Apple apparaisse.
     • Apple Silicon MacPour ce faire, il convient d'appuyer sur le bouton d'alimentation et de le maintenir enfoncé après avoir éteint l'ordinateur, jusqu'à ce que l'option de démarrage s'affiche.
   • Ouvrez un terminal et tapez

     csrutil disable
     

   • Redémarrer le système :

     sudo reboot
     

   • Après avoir extrait la clé, il est recommandé de réactiver le SIP (exécuter la commande csrutil enable (et redémarrer).
5. Migrer les enregistrements de chat de WeChat
   Opérer dans WeChat sur votre téléphone portable :
   • Ouvrez "Me - Settings - General - Chat History Migration & Backup - Migration - Migrate to PC".
   • Suivez les instructions pour transférer les enregistrements de chat vers le client WeChat de votre ordinateur. Cette opération n'affecte pas les données du téléphone portable.

Principales fonctions

Chatlog offre plusieurs façons de gérer les données des chats WeChat, voici comment utiliser les fonctionnalités principales :

• Extraire et décrypter des données
  Après avoir lancé Chatlog, le programme demande le chemin d'accès à la base de données WeChat (qui se trouve généralement dans le répertoire macOS ~/Library/Containers/com.tencent.xinWeChat/Data/Library/Application Support/com.tencent.xinWeChat/ (ou le répertoire d'installation de WeChat pour Windows). Après avoir saisi le chemin d'accès, exécutez la commande suivante pour décrypter les données :

  ./chatlog decrypt
  

  Les données décryptées peuvent être utilisées à des fins d'interrogation ou d'affichage.

• Opérations de l'interface du terminal (TUI)
  Lancer l'interface du terminal :

  ./chatlog
  

  Mode de fonctionnement :

  • Utilisez les touches fléchées pour naviguer dans le menu.
  • presse Enter Sélectionnez l'option.
  • presse Esc Retour au niveau précédent.
  • presse Ctrl+C Procédure de sortie.
    L'interface du terminal affiche les journaux de discussion, les contacts et d'autres informations, ce qui permet une consultation rapide.
• Requête en ligne de commande
  Obtenir la clé de données Microsoft :

  ./chatlog key
  

  Interroger des données spécifiques (par exemple, les journaux de discussion)

  ./chatlog decrypt
  

  La ligne de commande est adaptée aux opérations par lots ou au traitement des scripts.

• Utilisation de l'API HTTP
  Démarrer le service HTTP (port par défaut 5030) :

  ./chatlog
  

  Accès par navigateur http://127.0.0.1:5030 Visualisez les données ou interrogez-les à l'aide de l'API :

  • journal de bord: :

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

    Paramètre Description :

    • time: Plage de temps, par exemple 2023-01-01 peut-être 2023-01-01~2023-12-31.
    • talkerID de chat : ID de chat, prendre en charge l'ID WeChat, le surnom ou l'ID de chat de groupe.
    • limit: renvoie le nombre d'enregistrements.
    • offset: Décalage de la radiomessagerie.
    • formatFormat de sortie (json,csv (ou texte).
  • Liste de contacts: :

    GET /api/v1/contact
    

  • Liste des groupes de discussion: :

    GET /api/v1/chatroom
    

  • Sessions récentes: :

    GET /api/v1/session
    

• Vue du navigateur
  Après avoir démarré le service HTTP, ouvrez un navigateur et visitez le site http://127.0.0.1:5030. La page affiche les enregistrements de chat, les contacts et d'autres contenus, permet un tri par heure ou par objet et fonctionne de manière intuitive.

Fonction en vedette Fonctionnement

La particularité de Chatlog réside dans sa conception open source et l'intégration de l'IA, voici les détails des fonctionnalités :

• Intégration du protocole MCP SSE
  Chatlog prend en charge le protocole MCP SSE pour la connexion avec les assistants d'intelligence artificielle (par exemple ChatWise, Claude). Étapes d'installation :
  • Démarrer le service HTTP de Chatlog.
  • Ajouter un nouvel outil aux paramètres de l'assistant d'intelligence artificielle :
    • Type :sse.
    • URL :http://127.0.0.1:5030/sse.
    • Cochez "Outils d'exécution automatisée".
  • Après la configuration, l'assistant d'IA peut directement interroger les enregistrements de chat. Par exemple, si vous tapez "Trouver les chats avec Xiaoming hier" dans ChatWise, l'assistant renverra les enregistrements correspondants.
  • Si l'outil d'IA ne prend pas en charge MCP SSE, utilisez l'option mcp-proxy Transmettre la demande. Par exemple, l'application Claude Édition sur le bureau config.json: :

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

• Open Source et personnalisation
  Chatlog est basé sur la licence Apache-2.0 et le code est accessible au public afin que les utilisateurs puissent vérifier la sécurité ou modifier les fonctionnalités. Par exemple, le code est accessible au public :
  • Ajouter un nouveau format d'exportation (par exemple CSV) :
    • compilateur src/export.goajouter la logique d'exportation.
    • être en mouvement go build Recompiler.
  • Optimiser la vitesse d'interrogation :
    • modifications src/query.go, en ajustant l'index de la base de données.
      La conception open source permet aux utilisateurs d'étendre les fonctionnalités en fonction de leurs besoins.

Fonctions supplémentaires (mentionnées dans la description officielle mais absentes de la présentation originale)

• Support multi-systèmes
  Chatlog est compatible avec Windows et macOS, et le processus est cohérent pour garantir un accès multiplateforme.
• Fonction de planification (TODO)
  Selon la note officielle, Chatlog sera pris en charge à l'avenir :
  • Extraction de données multimédias (par exemple, images, paroles).
  • Indexation plein texte des données de chat pour accélérer les recherches.
  • Tableau de bord des statistiques de données, montrant les résultats d'analyses telles que la fréquence des messages, les mots-clés, etc.
    Ces fonctionnalités ne sont pas encore opérationnelles, mais elles montrent l'orientation de l'amélioration continue du projet.

mise en garde

• la sécurité des donnéesLe Chatlog ne traite que les données locales et n'est pas téléchargé sur le web. Les utilisateurs peuvent vérifier le code via GitHub pour confirmer la sécurité.
• Fonctionnement du SIPLes utilisateurs de macOS doivent désactiver SIP uniquement lors de l'extraction des clés, et le réactiver lorsqu'ils ont terminé.
• Version WeChatPour les clients WeChat : Assurez-vous que le client WeChat est bien la version 3.x ou 4.0, d'autres versions peuvent ne pas être compatibles.
• Sauvegarde des donnéesIl est recommandé de sauvegarder régulièrement les fichiers de la base de données Microsoft afin d'éviter toute perte accidentelle.

Avec ces étapes, les utilisateurs peuvent facilement installer Chatlog, extraire les journaux de chat ou analyser les données avec des API et des assistants d'IA.

scénario d'application

1. Organisez vos chats
   Les utilisateurs veulent sauvegarder les messages WeChat avec leurs amis ou les chats de groupe, Chatlog peut extraire et organiser les enregistrements pour faciliter l'archivage ou l'exportation.
2. Gestion des discussions de groupe
   Lorsqu'un groupe de discussion est surchargé de messages, Chatlog peut rapidement rechercher les discours ou les mots-clés de certains membres, ce qui le rend adapté aux administrateurs de groupes.
3. l'analyse des données
   Les développeurs ont besoin de statistiques sur la fréquence des chats ou les mots-clés, et l'API HTTP de Chatlog fournit des données structurées adaptées à la recherche ou à la rédaction de rapports.
4. Collaboration en matière d'IA
   Les utilisateurs souhaitent qu'un assistant d'intelligence artificielle puisse savoir de quoi ils discutent, et le support MCP SSE de Chatlog permet à l'intelligence artificielle de lire et d'analyser les données directement.

QA

1. Quels sont les systèmes supportés par Chatlog ?
   Prend en charge Windows et macOS et est compatible avec les versions 3.x et 4.0 de WeChat.
2. Comment garantir la sécurité des données ?
   Chatlog est un outil open source dont les données ne sont traitées que localement, le code est accessible au public pour inspection et n'est pas téléchargé sur le web.
3. macOS Pourquoi dois-je désactiver SIP ?
   Le mécanisme de sécurité de WeChat limite l'extraction des clés, et la désactivation du SIP est une opération temporaire qui peut être réactivée une fois terminée.
4. Quelles sont les requêtes de données prises en charge par l'API ?
   Prise en charge des journaux de discussion, des contacts, des discussions de groupe et des requêtes de sessions récentes aux formats JSON et CSV.
5. Comment s'intègre-t-il aux assistants d'IA ?
   Démarrez le service SSE de Chatlog et configurez l'URL de l'outil de l'assistant d'intelligence artificielle comme suit http://127.0.0.1:5030/sse Prêt à partir.