Sobre el proyecto
wx-cli lee directamente la base de datos local de WeChat en macOS, permitiendo que tanto usuarios como agentes de IA accedan a registros de chat, contactos, grupos y mensajes multimedia. Los datos permanecen en la máquina local de forma predeterminada, sin necesidad de carga ni dependencia de exportación en la nube.
Las capacidades principales incluyen:
1. Descifrado de base de datos: captura llamadas PBKDF2 mediante hook de LLDB para extraer la clave original, admite descifrado completo e incremental de la base de datos, cubriendo todas las bases de datos de WeChat.
2. Consulta y búsqueda de mensajes: consulta mensajes históricos por contacto, grupo, rango de tiempo y tipo de mensaje; admite búsqueda global por palabras clave en todas las conversaciones; puede leer todos los mensajes de todas las conversaciones por rango de tiempo (timeline), ideal para completar memoria y procesamiento por lotes.
3. Suscripción en tiempo real: monitoreo continuo de nuevos mensajes desde la línea de comandos, o mediante SSE (/api/v1/events) para enviar nuevos mensajes en tiempo real a agentes y otros programas.
4. Exportación y procesamiento de medios: las conversaciones se pueden exportar como JSON o texto; admite descifrado de imágenes, extracción de voz (requiere ffmpeg) y descifrado de videos de WeChat Video.
5. Integración con agentes: incluye un Skill de agente instalable mediante npx skills add; herramientas como Claude Code, Codex y Cursor pueden entender directamente las capacidades de wx-cli e invocarlas después de la instalación.
6. Servicio de API REST: el servicio de larga duración reutiliza la base de datos abierta, proporcionando puntos finales como sessions, contacts, messages, timeline, search, media y events, con soporte para autenticación por token y acceso remoto. Los comandos de consulta reutilizan automáticamente la API cuando el servicio está en ejecución.
7. Control de privacidad: permite ocultar contactos, grupos o contactos con etiquetas específicas por cuenta, filtrando automáticamente en consultas y suscripciones (excepto en búsqueda de texto completo).
Los requisitos de plataforma son macOS (arm64 / Apple Silicon), con versión de WeChat 4.1.7 o superior. La extracción de clave requiere desactivar SIP (System Integrity Protection) y habilitar DevToolsSecurity y permisos de grupo de desarrolladores. El proyecto está escrito en Rust y ofrece dos métodos de instalación: binario precompilado y compilación desde el código fuente.
La estructura del proyecto incluye crates independientes como biblioteca de descifrado central, extracción y almacenamiento de claves, entrada CLI, consulta de base de datos, descifrado de medios, monitoreo en tiempo real, análisis de contexto de cuenta y gestión de rutas de plataforma.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.