ops120/wechat-local-viewer

해결하는 문제

이 프로젝트는 내보낸 WeChat 채팅 기록을 탐색하고 검색하기 위한 로컬 전용 인터페이스를 제공합니다. 공식 앱 내에서 관리하거나 검색하기 어려운 대량의 채팅 데이터(수십만 개의 메시지)를 처리하는 문제를 해결합니다.

작동 방식

사용자는 복호화된 WeChat 데이터베이스 파일(연락처, 세션, 메시지)을 특정 디렉토리에 넣습니다. 이 도구는 Python 기반 ETL(추출, 변환, 로드) 프로세스를 사용하여 FTS5(전체 텍스트 검색) 인덱스가 있는 로컬 SQLite 데이터베이스로 데이터를 가져옵니다. FastAPI 백엔드가 이 데이터를 Vue.js 프론트엔드에 제공하여 채팅 기록의 빠른 검색, 필터링, 내보내기를 가능하게 합니다. 또한 OpenAI 호환 LLM API와 통합하여 로컬 채팅 데이터를 기반으로 요약 및 Q&A 기능을 제공합니다.

대상 사용자

자신의 데이터 복호화를 처리할 기술적 능력이 있고 완전히 오프라인이고 개인적인 환경에서 개인 채팅 기록에 대한 고급 분석, 검색 또는 AI 지원 요약을 수행하려는 사용자를 위해 설계되었습니다.

주요 기능

• 로컬 우선 아키텍처: 모든 데이터 처리와 저장은 사용자 머신에서 이루어지며 외부 종속성이나 데이터 유출이 없습니다.
• 고성능 검색: SQLite FTS5를 활용하여 대규모 메시지 데이터 세트에서 거의 즉각적인 전체 텍스트 검색을 제공합니다.
• LLM 통합: DeepSeek 또는 Ollama와 같은 OpenAI 호환 서비스의 스트리밍 응답을 지원하여 채팅 기록에 대한 요약 또는 질문 답변을 제공합니다.
• 데이터 이식성: 연락처 및 세션 데이터를 CSV 또는 JSON 형식으로 내보낼 수 있습니다.
• 제로 구성 설정: Windows에서 원클릭 시작을 위한 간단한 배치 스크립트가 포함되어 있습니다.