Chatlog: herramienta de código abierto para extraer y consultar los registros de chat de WeChat

Introducción general

Chatlog es una herramienta de código abierto que se centra en la extracción y consulta de registros de chat de la base de datos local de WeChat. Es compatible con las versiones 3.x y 4.0 de WeChat, tanto para sistemas Windows como macOS. Los usuarios pueden ver los registros de chat, contactos, chats de grupo y conversaciones recientes desde la línea de comandos, la interfaz de terminal o las operaciones de la API HTTP.Chatlog también es compatible con MCP SSE, que puede integrarse con asistentes de inteligencia artificial (por ejemplo, ChatWise) para analizar rápidamente los datos del chat. El proyecto se basa en la licencia Apache-2.0, y el código es abierto, seguro y fiable, apto para usuarios que necesiten organizar o analizar datos de WeChat.

Lista de funciones

• Extrae registros de chats, contactos, chats de grupo y conversaciones recientes de la base de datos local de WeChat.
• Soporta WeChat versión 3.x y 4.0, compatible con múltiples formatos de datos.
• Proporciona una interfaz de terminal (TUI) y herramientas de línea de comandos para un funcionamiento intuitivo.
• API HTTP integrada para consultar registros de chat, contactos, chats de grupo y otra información.
• Admite el protocolo MCP SSE para una conectividad perfecta con asistentes de IA compatibles.
• Proporcionar la función de descifrado de datos para garantizar que los usuarios puedan acceder de forma segura a los datos locales.
• Código fuente abierto, el usuario puede comprobar la seguridad o personalizar la funcionalidad.

Utilizar la ayuda

El objetivo de Chatlog es permitir a los usuarios extraer y consultar fácilmente los registros de chat de WeChat. A continuación se muestra una guía detallada de instalación y uso para ayudar a los usuarios a empezar rápidamente.

Proceso de instalación

Chatlog requiere algunas operaciones técnicas y es adecuado para usuarios con conocimientos básicos. A continuación se indican los pasos de instalación:

1. Preparar el entorno
   Asegúrese de que el siguiente software está instalado en su ordenador:
   • Vaya a: Se recomienda la última versión; consulte las instrucciones de instalación en el sitio web de Go.
   • Xcode(usuarios de macOS): Descargar de la App Store para la extracción de claves.
   • Cliente WeChat: Asegúrese de que está instalado y conectado, y de que los registros del chat deben migrarse a su ordenador.
2. Instalación desde el origen
   Abra un terminal y ejecute el siguiente comando para instalar Chatlog:

   go install github.com/sjzar/chatlog@latest
   

   Tras la instalación, Chatlog puede ejecutarse directamente desde la línea de comandos.

3. Descargar versión precompilada
   Si no quieres compilar desde el código fuente, visita GitHub Releases y descarga una versión precompilada para tu sistema (por ejemplo, Windows o macOS). Una vez descargada, descomprímela y utilízala.
4. Los usuarios de macOS desactivan SIP
   Para el sistema macOS, debido a restricciones de seguridad, SIP debe ser desactivado temporalmente al extraer claves, de la siguiente manera:
   • Entra en el modo de recuperación:
     • Mac IntelPulse y mantenga pulsado después de apagar Command + R para encender el ordenador hasta que aparezca el logotipo de Apple.
     • Apple Silicon Mac: Mantenga pulsado el botón de encendido después de apagar el ordenador hasta que aparezca la opción de arranque.
   • Abre un terminal y escribe:

     csrutil disable
     

   • Reinicia el sistema:

     sudo reboot
     

   • Después de extraer la clave, se recomienda volver a habilitar el SIP (ejecute el comando csrutil enable (y reiniciar).
5. Migrar registros de chat de WeChat
   Opere en WeChat en su teléfono móvil:
   • Abre "Yo - Configuración - General - Migración y copia de seguridad del historial de chat - Migración - Migrar a PC".
   • Sigue las instrucciones para transferir los registros de chat al cliente WeChat de tu ordenador. Esta operación no afectará a los datos del teléfono móvil.

Funciones principales

Chatlog ofrece múltiples formas de gestionar los datos de chat de WeChat, a continuación te explicamos cómo utilizar las funciones principales:

• Extraer y descifrar datos
  Tras ejecutar Chatlog, el programa solicitará la ruta de acceso a la base de datos de WeChat (normalmente se encuentra en la carpeta de macOS ~/Library/Containers/com.tencent.xinWeChat/Data/Library/Application Support/com.tencent.xinWeChat/ (o el directorio de instalación de WeChat para Windows). Después de introducir la ruta, ejecute el siguiente comando para descifrar los datos:

  ./chatlog decrypt
  

  Los datos descifrados pueden utilizarse para consulta o visualización.

• Operaciones de interfaz de terminal (TUI)
  Inicie la interfaz del terminal:

  ./chatlog
  

  Método de funcionamiento:

  • Utilice las teclas de flecha para navegar por el menú.
  • pulse Enter Selecciona la opción.
  • pulse Esc Volver al nivel anterior.
  • pulse Ctrl+C Procedimiento de salida.
    La interfaz del terminal muestra registros de chat, contactos y otra información, adecuada para una visualización rápida.
• consulta en línea de comandos
  Consigue la clave de datos de microsoft:

  ./chatlog key
  

  Consulta de datos específicos (por ejemplo, registros de chat)

  ./chatlog decrypt
  

  La línea de comandos es adecuada para operaciones por lotes o procesamiento de scripts.

• Uso de la API HTTP
  Inicie el servicio HTTP (puerto por defecto 5030):

  ./chatlog
  

  Acceso a través del navegador http://127.0.0.1:5030 Visualice los datos o consúltelos mediante la API:

  • registro del chat::

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

    Descripción de los parámetros:

    • timeRango de tiempo, por ejemplo 2023-01-01 tal vez 2023-01-01~2023-12-31.
    • talker: ID de chat, ID de WeChat de apoyo, apodo o ID de chat de grupo.
    • limitDevuelve el número de registros.
    • offset: Paging offset.
    • formatFormato de salida (jsonycsv (o texto).
  • Lista de contactos::

    GET /api/v1/contact
    

  • Lista de grupos de chat::

    GET /api/v1/chatroom
    

  • Sesiones recientes::

    GET /api/v1/session
    

• Vista del navegador
  Después de iniciar el servicio HTTP, abra un navegador y visite http://127.0.0.1:5030. La página muestra registros de chat, contactos y otros contenidos, admite la clasificación por tiempo u objeto y funciona de forma intuitiva.

Función destacada Operación

La singularidad de Chatlog radica en su diseño de código abierto y la integración de AI, aquí están los detalles de las características:

• Integración del protocolo MCP SSE
  Chatlog es compatible con el protocolo MCP SSE para conectar con asistentes de IA (por ejemplo, ChatWise, Claude). Pasos de configuración:
  • Inicia el servicio HTTP de Chatlog.
  • Añade una nueva herramienta a la configuración del Asistente AI:
    • Tipo:sse.
    • URL:http://127.0.0.1:5030/sse.
    • Marque "Herramientas de ejecución automatizada".
  • Tras la configuración, el asistente de IA puede consultar directamente los registros de chat. Por ejemplo, si escribes "Buscar chats con Xiaoming ayer" en ChatWise, el asistente te devolverá los registros correspondientes.
  • Si la herramienta de IA no admite MCP SSE, utilice la opción mcp-proxy Reenvía la solicitud. Por ejemplo Claude Edición en el escritorio config.json::

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

• Código abierto y personalización
  Chatlog se basa en la licencia Apache-2.0 y el código está disponible públicamente para que los usuarios puedan comprobar la seguridad o modificar la funcionalidad. Por ejemplo:
  • Añade un nuevo formato de exportación (por ejemplo, CSV):
    • compilador src/export.goAñadir lógica de exportación.
    • estar en movimiento go build Recompilar.
  • Optimizar la velocidad de consulta:
    • modificaciones src/query.goajustando el índice de la base de datos.
      El diseño de código abierto permite a los usuarios ampliar la funcionalidad según sus necesidades.

Funciones suplementarias (mencionadas en la descripción oficial pero ausentes en la presentación original)

• Soporte multisistema
  Chatlog es compatible tanto con Windows como con macOS, y el proceso es coherente para garantizar el acceso entre plataformas.
• Función de planificación (TODO)
  Según la nota oficial, Chatlog será compatible en el futuro:
  • Extracción de datos multimedia (por ejemplo, imágenes, voz).
  • Indexación de texto completo de los datos de chat para agilizar las búsquedas.
  • Panel de estadísticas de datos, que muestra los resultados de análisis como la frecuencia de los mensajes, las palabras clave, etc.
    Estas funciones aún no están activas, pero muestran la dirección de la mejora continua del proyecto.

advertencia

• seguridad de los datos: Chatlog sólo procesa datos locales y no los sube a la web. Los usuarios pueden comprobar el código a través de GitHub para confirmar la seguridad.
• Funcionamiento del SIPLos usuarios de macOS deben desactivar SIP sólo cuando extraigan claves y volver a activarlo cuando hayan terminado.
• Versión WeChatAsegúrate de que el cliente WeChat es de la versión 3.x o 4.0, otras versiones pueden no ser compatibles.
• Copia de seguridadSe recomienda realizar copias de seguridad periódicas de los archivos de base de datos de Microsoft para evitar pérdidas accidentales.

Con estos pasos, los usuarios pueden instalar Chatlog fácilmente, extraer registros de chat o analizar los datos con API y asistentes de IA.

escenario de aplicación

1. Organiza tus chats
   Los usuarios que quieran guardar mensajes de WeChat con amigos o chats de grupo, Chatlog puede extraer y organizar los registros para archivarlos o exportarlos fácilmente.
2. Gestión de grupos de chat
   Cuando un chat de grupo está sobrecargado de mensajes, Chatlog puede buscar rápidamente las intervenciones o palabras clave de miembros concretos, lo que lo hace idóneo para administradores de grupos.
3. análisis de datos
   Los desarrolladores necesitan estadísticas sobre la frecuencia de los chats o las palabras clave, y la API HTTP de Chatlog proporciona datos estructurados adecuados para la investigación o la elaboración de informes.
4. Colaboración en IA
   Los usuarios quieren que un asistente de IA averigüe sobre qué están chateando, y el soporte MCP SSE de Chatlog permite a la IA leer y analizar los datos directamente.

CONTROL DE CALIDAD

1. ¿Qué sistemas admite Chatlog?
   Admite Windows y macOS y es compatible con las versiones 3.x y 4.0 de WeChat.
2. ¿Cómo se garantiza la seguridad de los datos?
   Chatlog es una herramienta de código abierto en la que los datos sólo se procesan localmente, el código está a disposición del público para su inspección y no se sube a la web.
3. macOS ¿Por qué tengo que desactivar SIP?
   El mecanismo de seguridad de WeChat restringe la extracción de claves, y desactivar el SIP es una operación temporal que puede volver a activarse una vez finalizada.
4. ¿Qué consultas de datos admite la API?
   Soporte para registros de chat, contactos, chats de grupo y consultas de sesiones recientes en formatos JSON y CSV.
5. ¿Cómo se integra con los asistentes de IA?
   Inicie el servicio SSE de Chatlog y configure la URL de la herramienta del asistente AI para que sea http://127.0.0.1:5030/sse Listo para salir.