À propos du projet
wx-cli lit directement la base de données locale de WeChat sur macOS, permettant aux utilisateurs et aux Agents IA d'accéder aux historiques de chat, aux contacts, aux discussions de groupe et aux messages multimédias. Les données restent par défaut sur la machine locale, sans nécessiter d'envoi ni de dépendance à une exportation cloud.
Les capacités principales incluent :
1. Déchiffrement de la base de données : capture des appels PBKDF2 via un hook LLDB pour extraire la clé originale, prise en charge du déchiffrement complet et incrémental, couvrant toutes les bases de données WeChat.
2. Interrogation et recherche de messages : interrogation des messages historiques par contact, discussion de groupe, plage temporelle et type de message ; prise en charge de la recherche globale par mot-clé sur toutes les conversations ; lecture en une seule fois de tous les messages de toutes les conversations par plage temporelle (timeline), adaptée à la complétion de mémoire et au traitement par lots.
3. Abonnement en temps réel : surveillance continue des nouveaux messages en ligne de commande, ou push en temps réel des nouveaux messages vers les Agents et autres programmes via SSE (/api/v1/events).
4. Export et traitement multimédia : export des conversations en JSON ou en texte ; prise en charge du déchiffrement des images, de l'extraction audio (nécessite ffmpeg), du déchiffrement des vidéos de chaînes vidéo.
5. Intégration Agent : Agent Skill intégré installable via npx skills add ; après installation, des outils comme Claude Code, Codex, Cursor peuvent directement comprendre les capacités de wx-cli et les appeler.
6. Service API REST : service résident réutilisant la base de données déjà ouverte, fournissant des points de terminaison sessions, contacts, messages, timeline, search, media, events, etc., avec prise en charge de l'authentification par token et de l'accès distant. Les commandes d'interrogation réutilisent automatiquement l'API lorsque le service est en cours d'exécution.
7. Contrôle de la confidentialité : possibilité de masquer par compte des contacts, discussions de groupe ou contacts portant un tag spécifique, avec filtrage automatique lors des interrogations et abonnements (sauf pour la recherche plein texte).
Configuration requise : macOS (arm64 / Apple Silicon), version de WeChat 4.1.7 ou supérieure. L'extraction de la clé nécessite la désactivation de SIP (System Integrity Protection), ainsi que l'activation de DevToolsSecurity et des permissions du groupe développeur. Le projet est écrit en Rust et propose deux modes d'installation : binaire précompilé ou compilation depuis les sources.
La structure du projet comprend des crates indépendants : bibliothèque de déchiffrement principale, extraction et stockage de clé, point d'entrée CLI, interrogation de base de données, déchiffrement multimédia, surveillance en temps réel, résolution du contexte de compte et gestion des chemins de plateforme.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.