일반 소개
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는 약간의 기술적 조작이 필요하며 기본적인 지식이 있는 사용자에게 적합합니다. 다음은 설치 단계입니다:
- 환경 준비하기
컴퓨터에 다음 소프트웨어가 설치되어 있는지 확인합니다:- 이동최신 버전을 권장하며, 설치 지침은 Go 웹사이트를 참조하세요.
- Xcode(macOS 사용자): 앱 스토어에서 다운로드하여 키를 추출합니다.
- WeChat 클라이언트설치 및 로그인되어 있고 채팅 로그를 내 컴퓨터로 마이그레이션해야 하는지 확인합니다.
- 소스에서 설치
터미널을 열고 다음 명령을 실행하여 Chatlog를 설치합니다:go install github.com/sjzar/chatlog@latest
설치 후에는 명령줄에서 바로 Chatlog를 실행할 수 있습니다.
- 사전 컴파일된 버전 다운로드
소스에서 컴파일하지 않으려면 GitHub 릴리스를 방문하여 사용 중인 시스템(예: Windows 또는 macOS)에 맞게 미리 컴파일된 버전을 다운로드하세요. 다운로드가 완료되면 압축을 풀고 사용하세요. - macOS 사용자가 SIP를 끕니다.
macOS 시스템의 경우 보안 제한으로 인해 다음과 같이 키를 추출할 때 SIP를 일시적으로 비활성화해야 합니다:- 복구 모드로 들어갑니다:
- 인텔 Mac전원을 끈 후 길게 누릅니다.
Command + R
키를 눌러 Apple 로고가 나타날 때까지 컴퓨터를 켭니다. - Apple 실리콘 맥컴퓨터를 끈 후 부팅 옵션이 표시될 때까지 전원 버튼을 길게 누릅니다.
- 인텔 Mac전원을 끈 후 길게 누릅니다.
- 터미널을 열고 입력합니다:
csrutil disable
- 시스템을 재부팅합니다:
sudo reboot
- 키를 추출한 후 SIP를 다시 활성화하는 것이 좋습니다(
csrutil enable
(그리고 재부팅).
- 복구 모드로 들어갑니다:
- 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
를 클릭하고 데이터베이스 인덱스를 조정합니다.
오픈 소스 설계를 통해 사용자는 필요에 따라 기능을 확장할 수 있습니다.
- 수정
- 새 내보내기 형식(예: CSV)을 추가합니다:
보조 기능(공식 설명에는 언급되었지만 원래 프레젠테이션에는 누락됨)
- 다중 시스템 지원
Chatlog는 Windows 및 macOS와 모두 호환되며, 크로스 플랫폼 액세스를 보장하기 위해 일관된 프로세스를 갖추고 있습니다. - 계획 기능(TODO)
공식 노트에 따르면 향후 채팅로그가 지원될 예정입니다:- 멀티미디어 데이터(예: 이미지, 음성) 추출.
- 채팅 데이터의 전체 텍스트 인덱싱을 통해 검색 속도를 높입니다.
- 메시지 빈도, 키워드 등의 분석 결과를 보여주는 데이터 통계 대시보드입니다.
이러한 기능은 아직 출시되지는 않았지만 프로젝트의 지속적인 개선 방향을 보여줍니다.
주의
- 데이터 보안채팅로그는 로컬 데이터만 처리하며 웹에 업로드하지 않습니다. 사용자는 GitHub를 통해 코드를 확인하여 보안을 확인할 수 있습니다.
- SIP 작업macOS 사용자는 키를 추출할 때만 SIP를 비활성화하고, 추출이 끝나면 다시 활성화해야 합니다.
- 위챗 버전WeChat 클라이언트가 버전 3.x 또는 4.0인지 확인하세요. 다른 버전은 호환되지 않을 수 있습니다.
- 백업 데이터실수로 인한 손실을 방지하기 위해 Microsoft 데이터베이스 파일을 정기적으로 백업하는 것이 좋습니다.
이 단계를 통해 사용자는 쉽게 Chatlog를 설치하고, 채팅 로그를 추출하거나, API 및 AI 어시스턴트를 사용하여 데이터를 분석할 수 있습니다.
애플리케이션 시나리오
- 채팅 정리하기
사용자가 친구 또는 그룹 채팅과 나눈 WeChat 메시지를 저장하고자 할 때, Chatlog는 기록을 추출하고 정리하여 쉽게 보관하거나 내보낼 수 있습니다. - 그룹 채팅 관리
그룹 채팅에 메시지가 넘쳐나는 경우 Chatlog는 특정 구성원의 발언이나 키워드를 빠르게 조회할 수 있어 그룹 관리자에게 적합합니다. - 데이터 분석
개발자는 채팅 빈도나 키워드에 대한 통계가 필요하며, Chatlog의 HTTP API는 연구나 보고에 적합한 구조화된 데이터를 제공합니다. - AI 협업
사용자는 AI 어시스턴트가 채팅 내용을 파악하기를 원하며, Chatlog의 MCP SSE 지원으로 AI가 데이터를 직접 읽고 분석할 수 있습니다.
QA
- Chatlog는 어떤 시스템을 지원하나요?
Windows 및 macOS를 지원하며 WeChat 버전 3.x 및 4.0과 호환됩니다. - 데이터 보안은 어떻게 보장하나요?
Chatlog는 데이터가 로컬에서만 처리되는 오픈 소스 도구로, 코드는 공개적으로 검사할 수 있으며 웹에는 업로드되지 않습니다. - macOS SIP를 꺼야 하는 이유는 무엇인가요?
WeChat의 보안 메커니즘은 키 추출을 제한하며, SIP 비활성화는 일시적인 작업으로 완료 후 다시 활성화할 수 있습니다. - API는 어떤 데이터 쿼리를 지원하나요?
채팅 로그, 연락처, 그룹 채팅 및 최근 세션 쿼리를 JSON 및 CSV 형식으로 지원합니다. - AI 어시스턴트와 어떻게 통합되나요?
Chatlog의 SSE 서비스를 시작하고 AI 어시스턴트의 도구 URL을 다음과 같이 구성합니다.http://127.0.0.1:5030/sse
준비 완료.
© 저작권 정책
이 글은 저작권이 있으며 무단으로 복제해서는 안 됩니다.
관련 문서
댓글 없음...