Sobre o projeto
wx-cli lê diretamente o banco de dados local do WeChat no macOS, permitindo que usuários e Agentes de IA acessem histórico de conversas, contatos, grupos e mensagens de mídia. Os dados permanecem por padrão na máquina local, sem necessidade de upload ou dependência de exportação em nuvem.
As capacidades principais incluem:
1. Descriptografia de banco de dados: captura chamadas PBKDF2 via hook LLDB para extrair a chave original, com suporte a descriptografia completa e incremental, cobrindo todos os bancos de dados do WeChat.
2. Consulta e busca de mensagens: consulta de mensagens históricas por contato, grupo, intervalo de tempo e tipo de mensagem; suporte a busca global por palavras-chave em todas as conversas; leitura em lote de mensagens de todas as conversas por intervalo de tempo (timeline), ideal para complementação de memória e processamento em lote.
3. Assinatura em tempo real: monitoramento contínuo de novas mensagens via linha de comando, ou push em tempo real de novas mensagens para Agentes e outros programas via SSE (/api/v1/events).
4. Exportação e processamento de mídia: conversas podem ser exportadas em JSON ou texto; suporte a descriptografia de imagens, extração de áudio (requer ffmpeg) e descriptografia de vídeos do Canal de Vídeo.
5. Integração com Agentes: inclui uma Agent Skill instalável via npx skills add; ferramentas como Claude Code, Codex e Cursor podem entender e invocar as capacidades do wx-cli após a instalação.
6. Serviço REST API: serviço persistente reutiliza bancos de dados já abertos, oferecendo endpoints como sessions, contacts, messages, timeline, search, media e events, com suporte a autenticação por token e acesso remoto. Comandos de consulta reutilizam automaticamente a API durante a execução do serviço.
7. Controle de privacidade: permite ocultar contatos, grupos ou contatos com tags específicas por conta, com filtragem automática durante consulta e assinatura (exceto na busca de texto completo).
Os requisitos de plataforma são macOS (arm64 / Apple Silicon), com WeChat versão 4.1.7 ou superior. A extração de chaves requer o desligamento do SIP (System Integrity Protection), além da ativação de DevToolsSecurity e permissões de grupo de desenvolvedor. O projeto é escrito em Rust, oferecendo duas formas de instalação: binários pré-compilados e compilação a partir do código-fonte.
A estrutura do projeto inclui crates independentes para a biblioteca principal de descriptografia, extração e armazenamento de chaves, entrada CLI, consulta de banco de dados, descriptografia de mídia, monitoramento em tempo real, resolução de contexto de conta e gerenciamento de caminhos da plataforma.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.