Chatlog: WeChat 채팅 로그 추출 및 쿼리를 위한 오픈 소스 도구

일반 소개

Chatlog는 WeChat의 로컬 데이터베이스에서 채팅 로그를 추출하고 쿼리하는 데 중점을 둔 오픈 소스 도구입니다. 이 도구는 Windows와 macOS 시스템을 모두 아우르는 WeChat 버전 3.x와 4.0을 지원합니다. 사용자는 명령줄, 터미널 인터페이스 또는 HTTP API 작업에서 채팅 로그, 연락처, 그룹 채팅 및 최근 대화를 볼 수 있으며, Chatlog는 다음 사항도 지원합니다. MCP 채팅 데이터를 빠르게 분석하기 위해 AI 어시스턴트(예: ChatWise)와 통합할 수 있는 SSE 프로토콜입니다. 이 프로젝트는 Apache-2.0 라이선스를 기반으로 하며, 코드는 개방적이고 안전하며 신뢰할 수 있어 WeChat 데이터를 정리하거나 분석해야 하는 사용자에게 적합합니다.

기능 목록

• WeChat의 로컬 데이터베이스에서 채팅 로그, 연락처, 그룹 채팅 및 최근 대화를 추출합니다.
• 다양한 데이터 형식과 호환되는 WeChat 버전 3.x 및 4.0을 지원합니다.
• 직관적인 조작을 위한 터미널 인터페이스(TUI) 및 명령줄 도구를 제공합니다.
• 채팅 로그, 연락처, 그룹 채팅 및 기타 정보 쿼리를 지원하는 HTTP API가 내장되어 있습니다.
• 호환 가능한 AI 어시스턴트와 원활하게 연결할 수 있도록 MCP SSE 프로토콜을 지원합니다.
• 사용자가 로컬 데이터에 안전하게 액세스할 수 있도록 데이터 암호 해독 기능을 제공합니다.
• 오픈 소스 코드를 통해 사용자는 보안을 확인하거나 기능을 사용자 지정할 수 있습니다.

도움말 사용

Chatlog의 목표는 사용자가 WeChat 채팅 로그를 쉽게 추출하고 쿼리할 수 있도록 하는 것입니다. 아래는 사용자가 빠르게 시작할 수 있도록 자세한 설치 및 사용 가이드를 제공합니다.

설치 프로세스

Chatlog는 약간의 기술적 조작이 필요하며 기본적인 지식이 있는 사용자에게 적합합니다. 다음은 설치 단계입니다:

1. 환경 준비하기
   컴퓨터에 다음 소프트웨어가 설치되어 있는지 확인합니다:
   • 이동최신 버전을 권장하며, 설치 지침은 Go 웹사이트를 참조하세요.
   • Xcode(macOS 사용자): 앱 스토어에서 다운로드하여 키를 추출합니다.
   • WeChat 클라이언트설치 및 로그인되어 있고 채팅 로그를 내 컴퓨터로 마이그레이션해야 하는지 확인합니다.
2. 소스에서 설치
   터미널을 열고 다음 명령을 실행하여 Chatlog를 설치합니다:

   go install github.com/sjzar/chatlog@latest
   

   설치 후에는 명령줄에서 바로 Chatlog를 실행할 수 있습니다.

3. 사전 컴파일된 버전 다운로드
   소스에서 컴파일하지 않으려면 GitHub 릴리스를 방문하여 사용 중인 시스템(예: Windows 또는 macOS)에 맞게 미리 컴파일된 버전을 다운로드하세요. 다운로드가 완료되면 압축을 풀고 사용하세요.
4. macOS 사용자가 SIP를 끕니다.
   macOS 시스템의 경우 보안 제한으로 인해 다음과 같이 키를 추출할 때 SIP를 일시적으로 비활성화해야 합니다:
   • 복구 모드로 들어갑니다:
     • 인텔 Mac전원을 끈 후 길게 누릅니다. Command + R 키를 눌러 Apple 로고가 나타날 때까지 컴퓨터를 켭니다.
     • Apple 실리콘 맥컴퓨터를 끈 후 부팅 옵션이 표시될 때까지 전원 버튼을 길게 누릅니다.
   • 터미널을 열고 입력합니다:

     csrutil disable
     

   • 시스템을 재부팅합니다:

     sudo reboot
     

   • 키를 추출한 후 SIP를 다시 활성화하는 것이 좋습니다( csrutil enable (그리고 재부팅).
5. WeChat 채팅 기록 마이그레이션
   휴대폰의 WeChat에서 작업하세요:
   • "나 - 설정 - 일반 - 채팅 기록 마이그레이션 및 백업 - 마이그레이션 - PC로 마이그레이션"을 엽니다.
   • 안내에 따라 채팅 기록을 컴퓨터 WeChat 클라이언트로 전송합니다. 이 작업은 휴대폰 데이터에는 영향을 미치지 않습니다.

주요 기능

Chatlog는 WeChat 채팅 데이터를 관리하는 다양한 방법을 제공하며, 핵심 기능을 사용하는 방법은 다음과 같습니다:

• 데이터 추출 및 암호 해독
  Chatlog를 실행하면 프로그램에서 WeChat 데이터베이스 경로를 묻는 메시지가 표시됩니다(일반적으로 macOS에서 찾을 수 있음). ~/Library/Containers/com.tencent.xinWeChat/Data/Library/Application Support/com.tencent.xinWeChat/ (또는 Windows의 경우 WeChat 설치 디렉토리)로 이동합니다. 경로를 입력한 후 다음 명령을 실행하여 데이터를 해독합니다:

  ./chatlog decrypt
  

  해독된 데이터는 쿼리 또는 디스플레이에 사용할 수 있습니다.

• 터미널 인터페이스(TUI) 작업
  터미널 인터페이스를 시작합니다:

  ./chatlog
  

  작동 방법:

  • 화살표 키를 사용하여 메뉴를 탐색합니다.
  • 를 누릅니다. Enter 옵션을 선택합니다.
  • 를 누릅니다. Esc 이전 레벨로 돌아갑니다.
  • 를 누릅니다. Ctrl+C 종료 절차.
    터미널 인터페이스에는 채팅 로그, 연락처 및 기타 정보를 빠르게 볼 수 있도록 표시합니다.
• 명령줄 쿼리
  Microsoft 데이터 키를 받습니다:

  ./chatlog key
  

  특정 데이터 쿼리(예: 채팅 로그)

  ./chatlog decrypt
  

  명령줄은 일괄 작업이나 스크립트 처리에 적합합니다.

• HTTP API 사용
  HTTP 서비스를 시작합니다(기본 포트 5030):

  ./chatlog
  

  브라우저를 통한 액세스 http://127.0.0.1:5030 데이터를 보거나 API를 사용하여 쿼리할 수 있습니다:

  • 채팅 로그::

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

    매개변수 설명:

    • time시간 범위(예 2023-01-01 어쩌면 2023-01-01~2023-12-31.
    • talker채팅 아이디, 지원 WeChat 아이디, 닉네임 또는 그룹 채팅 아이디.
    • limit: 레코드 수를 반환합니다.
    • offset페이징 오프셋.
    • format출력 형식(json및csv (또는 텍스트)를 입력합니다.
  • 연락처 목록::

    GET /api/v1/contact
    

  • 그룹 채팅 목록::

    GET /api/v1/chatroom
    

  • 최근 세션::

    GET /api/v1/session
    

• 브라우저 보기
  HTTP 서비스를 시작한 후 브라우저를 열고 다음 사이트를 방문합니다. http://127.0.0.1:5030. 이 페이지는 채팅 기록, 연락처 및 기타 콘텐츠를 표시하고 시간 또는 대상별로 정렬을 지원하며 직관적으로 작동합니다.

주요 기능 작동

Chatlog의 독창성은 오픈 소스 설계와 AI 통합에 있으며, 자세한 기능은 다음과 같습니다:

• MCP SSE 프로토콜 통합
  Chatlog는 AI 어시스턴트(예: ChatWise, Claude)와 연결하기 위한 MCP SSE 프로토콜을 지원합니다. 설정 단계:
  • Chatlog의 HTTP 서비스를 시작합니다.
  • AI 어시스턴트 설정에 새 도구를 추가합니다:
    • 유형:sse.
    • URL:http://127.0.0.1:5030/sse.
    • "자동 실행 도구"를 선택합니다.
  • 구성 후에는 AI 어시스턴트가 채팅 기록을 직접 쿼리할 수 있습니다. 예를 들어 ChatWise에서 "어제 샤오밍과의 채팅 찾기"라고 입력하면 어시스턴트가 해당 레코드를 반환합니다.
  • AI 도구가 MCP SSE를 지원하지 않는 경우에는 mcp-proxy 요청을 전달합니다. 예를 들어 Claude 데스크톱에서 편집 config.json::

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

• 오픈 소스 및 사용자 지정
  Chatlog는 Apache-2.0 라이선스를 기반으로 하며 사용자가 보안을 확인하거나 기능을 수정할 수 있도록 코드가 공개적으로 제공됩니다. 예를 들어
  • 새 내보내기 형식(예: CSV)을 추가합니다:
    • 컴파일러 src/export.go를 클릭하고 내보내기 로직을 추가합니다.
    • 움직여야 합니다. go build 다시 컴파일합니다.
  • 쿼리 속도를 최적화하세요:
    • 수정 src/query.go를 클릭하고 데이터베이스 인덱스를 조정합니다.
      오픈 소스 설계를 통해 사용자는 필요에 따라 기능을 확장할 수 있습니다.

보조 기능(공식 설명에는 언급되었지만 원래 프레젠테이션에는 누락됨)

• 다중 시스템 지원
  Chatlog는 Windows 및 macOS와 모두 호환되며, 크로스 플랫폼 액세스를 보장하기 위해 일관된 프로세스를 갖추고 있습니다.
• 계획 기능(TODO)
  공식 노트에 따르면 향후 채팅로그가 지원될 예정입니다:
  • 멀티미디어 데이터(예: 이미지, 음성) 추출.
  • 채팅 데이터의 전체 텍스트 인덱싱을 통해 검색 속도를 높입니다.
  • 메시지 빈도, 키워드 등의 분석 결과를 보여주는 데이터 통계 대시보드입니다.
    이러한 기능은 아직 출시되지는 않았지만 프로젝트의 지속적인 개선 방향을 보여줍니다.

주의

• 데이터 보안채팅로그는 로컬 데이터만 처리하며 웹에 업로드하지 않습니다. 사용자는 GitHub를 통해 코드를 확인하여 보안을 확인할 수 있습니다.
• SIP 작업macOS 사용자는 키를 추출할 때만 SIP를 비활성화하고, 추출이 끝나면 다시 활성화해야 합니다.
• 위챗 버전WeChat 클라이언트가 버전 3.x 또는 4.0인지 확인하세요. 다른 버전은 호환되지 않을 수 있습니다.
• 백업 데이터실수로 인한 손실을 방지하기 위해 Microsoft 데이터베이스 파일을 정기적으로 백업하는 것이 좋습니다.

이 단계를 통해 사용자는 쉽게 Chatlog를 설치하고, 채팅 로그를 추출하거나, API 및 AI 어시스턴트를 사용하여 데이터를 분석할 수 있습니다.

애플리케이션 시나리오

1. 채팅 정리하기
   사용자가 친구 또는 그룹 채팅과 나눈 WeChat 메시지를 저장하고자 할 때, Chatlog는 기록을 추출하고 정리하여 쉽게 보관하거나 내보낼 수 있습니다.
2. 그룹 채팅 관리
   그룹 채팅에 메시지가 넘쳐나는 경우 Chatlog는 특정 구성원의 발언이나 키워드를 빠르게 조회할 수 있어 그룹 관리자에게 적합합니다.
3. 데이터 분석
   개발자는 채팅 빈도나 키워드에 대한 통계가 필요하며, Chatlog의 HTTP API는 연구나 보고에 적합한 구조화된 데이터를 제공합니다.
4. AI 협업
   사용자는 AI 어시스턴트가 채팅 내용을 파악하기를 원하며, Chatlog의 MCP SSE 지원으로 AI가 데이터를 직접 읽고 분석할 수 있습니다.

QA

1. Chatlog는 어떤 시스템을 지원하나요?
   Windows 및 macOS를 지원하며 WeChat 버전 3.x 및 4.0과 호환됩니다.
2. 데이터 보안은 어떻게 보장하나요?
   Chatlog는 데이터가 로컬에서만 처리되는 오픈 소스 도구로, 코드는 공개적으로 검사할 수 있으며 웹에는 업로드되지 않습니다.
3. macOS SIP를 꺼야 하는 이유는 무엇인가요?
   WeChat의 보안 메커니즘은 키 추출을 제한하며, SIP 비활성화는 일시적인 작업으로 완료 후 다시 활성화할 수 있습니다.
4. API는 어떤 데이터 쿼리를 지원하나요?
   채팅 로그, 연락처, 그룹 채팅 및 최근 세션 쿼리를 JSON 및 CSV 형식으로 지원합니다.
5. AI 어시스턴트와 어떻게 통합되나요?
   Chatlog의 SSE 서비스를 시작하고 AI 어시스턴트의 도구 URL을 다음과 같이 구성합니다. http://127.0.0.1:5030/sse 준비 완료.