Chatlog: ferramenta de código aberto para extrair e consultar os registros de bate-papo do WeChat

Introdução geral

O Chatlog é uma ferramenta de código aberto que se concentra na extração e consulta de registros de bate-papo do banco de dados local do WeChat. Ele é compatível com as versões 3.x e 4.0 do WeChat, abrangendo os sistemas Windows e macOS. Os usuários podem visualizar os registros de bate-papo, os contatos, os bate-papos em grupo e as conversas recentes na linha de comando, na interface do terminal ou nas operações da API HTTP. MCP Protocolo SSE, que pode ser integrado a assistentes de IA (por exemplo, ChatWise) para analisar rapidamente os dados de bate-papo. O projeto é baseado na licença Apache-2.0, e o código é aberto, seguro e confiável, adequado para usuários que precisam organizar ou analisar dados do WeChat.

Lista de funções

• Extraia logs de bate-papo, contatos, bate-papos em grupo e conversas recentes do banco de dados local do WeChat.
• Suporta WeChat versão 3.x e 4.0, compatível com vários formatos de dados.
• Fornece interface de terminal (TUI) e ferramentas de linha de comando para uma operação intuitiva.
• API HTTP integrada para oferecer suporte à consulta de registros de bate-papo, contatos, bate-papos em grupo e outras informações.
• Suporta o protocolo MCP SSE para conectividade perfeita com assistentes de IA compatíveis.
• Forneça a função de descriptografia de dados para garantir que os usuários possam acessar os dados locais com segurança.
• Código-fonte aberto, o usuário pode verificar a segurança ou personalizar a funcionalidade.

Usando a Ajuda

O objetivo do Chatlog é permitir que os usuários extraiam e consultem facilmente os registros de bate-papo do WeChat. Abaixo está um guia detalhado de instalação e uso para ajudar os usuários a começar rapidamente.

Processo de instalação

O Chatlog requer alguma operação técnica e é adequado para usuários com conhecimento básico. Veja a seguir as etapas de instalação:

1. Preparação do ambiente
   Verifique se os seguintes softwares estão instalados em seu computador:
   • IrRecomendamos a versão mais recente; consulte o site da Go para obter instruções de instalação.
   • Xcode(Usuários do macOS): Faça o download na App Store para extrair a chave.
   • Cliente WeChatVerifique se você está instalado e conectado, e se os registros de bate-papo precisam ser migrados para o seu computador.
2. Instalação a partir da fonte
   Abra um terminal e execute o seguinte comando para instalar o Chatlog:

   go install github.com/sjzar/chatlog@latest
   

   Após a instalação, o Chatlog pode ser executado diretamente da linha de comando.

3. Baixar a versão pré-compilada
   Se não quiser compilar a partir da fonte, visite GitHub Releases e baixe uma versão pré-compilada para seu sistema (por exemplo, Windows ou macOS). Após o download, descompacte-a e use-a.
4. Usuários do macOS desativam o SIP
   Para o sistema macOS, devido a restrições de segurança, o SIP deve ser temporariamente desativado ao extrair chaves, como segue:
   • Entre no modo de recuperação:
     • Intel MacPressione e mantenha pressionado após desligar Command + R para ligar o computador até que o logotipo da Apple seja exibido.
     • Apple Silicon MacPressione e mantenha pressionado o botão liga/desliga depois de desligar o computador até ver a opção de inicialização.
   • Abra um terminal e digite:

     csrutil disable
     

   • Reinicialize o sistema:

     sudo reboot
     

   • Após extrair a chave, é recomendável reativar o SIP (execute o comando csrutil enable (e reiniciar).
5. Migrar registros de bate-papo do WeChat
   Opere no WeChat em seu telefone celular:
   • Abra "Me - Settings - General - Chat History Migration & Backup - Migration - Migrate to PC".
   • Siga as instruções para transferir os registros de bate-papo para o cliente WeChat do seu computador. Essa operação não afetará os dados do telefone celular.

Funções principais

O Chatlog oferece várias maneiras de gerenciar os dados de bate-papo do WeChat. Veja a seguir como usar os principais recursos:

• Extrair e descriptografar dados
  Depois de executar o Chatlog, o programa solicitará o caminho para o banco de dados do WeChat (geralmente encontrado na pasta macOS ~/Library/Containers/com.tencent.xinWeChat/Data/Library/Application Support/com.tencent.xinWeChat/ (ou o diretório de instalação do WeChat no Windows). Depois de inserir o caminho, execute o seguinte comando para descriptografar os dados:

  ./chatlog decrypt
  

  Os dados descriptografados podem ser usados para consulta ou exibição.

• Operações da interface do terminal (TUI)
  Inicie a interface do terminal:

  ./chatlog
  

  Método de operação:

  • Use as teclas de seta para navegar pelo menu.
  • manter a mão sobre Enter Selecione a opção.
  • manter a mão sobre Esc Retornar ao nível anterior.
  • manter a mão sobre Ctrl+C Procedimento de saída.
    A interface do terminal exibe logs de bate-papo, contatos e outras informações, adequadas para visualização rápida.
• consulta de linha de comando
  Obtenha a chave de dados da Microsoft:

  ./chatlog key
  

  Consultar dados específicos (por exemplo, registros de bate-papo)

  ./chatlog decrypt
  

  A linha de comando é adequada para operações em lote ou processamento de scripts.

• Uso da API HTTP
  Inicie o serviço HTTP (porta padrão 5030):

  ./chatlog
  

  Acesso via navegador http://127.0.0.1:5030 Visualize os dados ou consulte-os usando a API:

  • Registro de bate-papo::

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

    Descrição do parâmetro:

    • timeIntervalo de tempo, por exemplo. 2023-01-01 talvez 2023-01-01~2023-12-31.
    • talkerID do bate-papo: ID do bate-papo, ID do WeChat, apelido ou ID do bate-papo em grupo.
    • limitNúmero de registros: retorna o número de registros.
    • offsetDeslocamento de paginação.
    • formatFormato de saída (jsonecsv (ou texto).
  • Lista de contatos::

    GET /api/v1/contact
    

  • Lista de bate-papo em grupo::

    GET /api/v1/chatroom
    

  • Sessões recentes::

    GET /api/v1/session
    

• Visualização do navegador
  Depois de iniciar o serviço HTTP, abra um navegador e visite http://127.0.0.1:5030. A página exibe registros de bate-papo, contatos e outros conteúdos, suporta a classificação por tempo ou objeto e funciona de forma intuitiva.

Operação da função em destaque

A singularidade do Chatlog está em seu design de código aberto e na integração de IA. Aqui estão os detalhes dos recursos:

• Integração do protocolo MCP SSE
  O Chatlog é compatível com o protocolo MCP SSE para conexão com assistentes de IA (por exemplo, ChatWise, Claude). Etapas de configuração:
  • Inicie o serviço HTTP do Chatlog.
  • Adicione uma nova ferramenta às configurações do AI Assistant:
    • Tipo:sse.
    • URL:http://127.0.0.1:5030/sse.
    • Assinale "Ferramentas de execução automatizada".
  • Após a configuração, o assistente de IA pode consultar diretamente os registros de bate-papo. Por exemplo, se você digitar "Find chats with Xiaoming yesterday" no ChatWise, o assistente retornará os registros correspondentes.
  • Se a ferramenta de IA não for compatível com o MCP SSE, use a opção mcp-proxy Encaminhar a solicitação. Por exemplo, o Claude Editar na área de trabalho config.json::

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

• Código aberto e personalização
  O Chatlog é baseado na licença Apache-2.0 e o código está disponível publicamente para que os usuários possam verificar a segurança ou modificar a funcionalidade. Por exemplo:
  • Adicionar um novo formato de exportação (por exemplo, CSV):
    • compilador src/export.goadicionar lógica de exportação.
    • estar em movimento go build Recompilar.
  • Otimize a velocidade de consulta:
    • modificações src/query.goajustando o índice do banco de dados.
      O design de código aberto permite que os usuários expandam a funcionalidade conforme necessário.

Funções suplementares (mencionadas na descrição oficial, mas ausentes na apresentação original)

• Suporte a vários sistemas
  O Chatlog é compatível com o Windows e o macOS, e o processo é consistente para garantir o acesso entre plataformas.
• Função de planejamento (TODO)
  De acordo com a nota oficial, o Chatlog terá suporte no futuro:
  • Extração de dados multimídia (por exemplo, imagens, fala).
  • Indexação de texto completo de dados de bate-papo para acelerar as pesquisas.
  • Painel de estatísticas de dados, mostrando os resultados de análises como frequência de mensagens, palavras-chave, etc.
    Esses recursos ainda não estão ativos, mas mostram a direção do aprimoramento contínuo do projeto.

advertência

• segurança de dadosO Chatlog processa somente dados locais e não faz upload para a Web. Os usuários podem verificar o código via GitHub para confirmar a segurança.
• Operação SIPNo entanto, os usuários do macOS precisam desativar o SIP somente ao extrair chaves e reativá-lo quando terminarem.
• Versão WeChatVerifique se o cliente WeChat é da versão 3.x ou 4.0, pois outras versões podem não ser compatíveis.
• Dados de backupRecomenda-se fazer backup dos arquivos de banco de dados da Microsoft regularmente para evitar perdas acidentais.

Com essas etapas, os usuários podem instalar facilmente o Chatlog, extrair logs de bate-papo ou analisar os dados com APIs e assistentes de IA.

cenário do aplicativo

1. Organize seus bate-papos
   Se os usuários quiserem salvar mensagens do WeChat com amigos ou bate-papos em grupo, o Chatlog pode extrair e organizar os registros para facilitar o arquivamento ou a exportação.
2. Gerenciamento de bate-papo em grupo
   Quando um bate-papo em grupo está sobrecarregado de mensagens, o Chatlog pode procurar rapidamente os discursos ou palavras-chave de membros específicos, o que o torna adequado para administradores de grupos.
3. análise de dados
   Os desenvolvedores precisam de estatísticas sobre frequência de bate-papo ou palavras-chave, e a API HTTP do Chatlog fornece dados estruturados adequados para pesquisas ou relatórios.
4. Colaboração de IA
   Os usuários querem que um assistente de IA descubra sobre o que eles estão conversando, e o suporte ao MCP SSE do Chatlog permite que a IA leia e analise os dados diretamente.

QA

1. Quais sistemas são compatíveis com o Chatlog?
   Suporta Windows e macOS e é compatível com as versões 3.x e 4.0 do WeChat.
2. Como você garante a segurança dos dados?
   O Chatlog é uma ferramenta de código aberto em que os dados são processados apenas localmente, o código está disponível publicamente para inspeção e não é carregado na Web.
3. macOS Por que preciso desativar o SIP?
   O mecanismo de segurança do WeChat restringe a extração de chaves, e a desativação do SIP é uma operação temporária que pode ser reativada após a conclusão.
4. Quais consultas de dados são compatíveis com a API?
   Suporte para logs de bate-papo, contatos, bate-papos em grupo e consultas de sessões recentes nos formatos JSON e CSV.
5. Como ele se integra aos assistentes de IA?
   Inicie o serviço SSE do Chatlog e configure o URL da ferramenta do assistente de IA para ser http://127.0.0.1:5030/sse Pronto para começar.