TL;DR

WeQ는 QQ NT 로컬 메시지 데이터베이스의 마스터 키를 획득해 복호화·파싱하고 채팅·앨범·收藏 등을 브라우저/데스크톱 UI로 살펴보고 JSON·XLSX·HTML 등으로 내보낼 수 있는 도구입니다. 동작 방식은 프로세스 패킷 가로채기 또는 함수 후킹으로 키를 얻어 로컬 DB를 직접 읽는 형태이므로 보안과 법적 위험에 각별히 주의해야 합니다. 개인 백업·포렌식 분석·채팅 통계 목적이라면 실용적이며 웹 서버 모드로 NAS·WSL 환경에서 접근 가능하지만 CC BY-NC-SA 4.0 라이선스와 비상업적 제한을 반드시 확인해야 합니다.

핵심 포인트

• WeQ는 QQ NT(Next-Gen QQ) 로컬 메시지 데이터베이스의 마스터 키를 추출해 복호화·파싱하고 다양한 형식으로 내보내는 독립 데스크톱/웹 도구입니다. 구현 방식은 로컬 프로세스에서 직접 패킷을 가로채거나 수신 함수에 후킹해 데이터베이스 키를 확보한 뒤 TypeScript 코드로 SQLite 등 내부 파일을 읽어 파싱하는 흐름을 따른다고 README에서 안내합니다. 개인 데이터 백업과 채팅 아카이빙, 채팅 분석 용도로 설계되어 있으며 마스터 키를 추출하는 특성 때문에 보안 및 법적 주의가 반드시 필요합니다.
• 기능 면에서는 QQ 스타일의 채팅 UI 렌더링, 채팅·그룹 앨범·QQ空间 등 각종 리소스 보기, 삭제된 메시지 복원·방지(방문 삭제 방지)와 로컬 메시지 편집 기능을 포함하고 있습니다. 내보내기 형식은 JSON/JSONL/XLSX/CSV/TXT/HTML 등 다수를 지원하며 웹 서버 모드(weq-web, Node ≥ 22 필요)로 NAS나 WSL 같은 환경에서도 동일한 인터페이스로 접근할 수 있게 설계되어 있습니다. 이러한 기능 조합은 개인 보관용 아카이브 생성이나 오프라인 조사, 채팅 통계 분석을 빠르게 수행하려는 개발자나 보유자에게 실용적 이점을 제공합니다.
• 보안·법적 조건은 README에서 명확히 경고하고 있으며 동작 방식으로 인해 마스터 키를 직접 획득하는 행위가 포함됩니다. 프로젝트는 개인 백업·분석 목적으로만 사용하도록 제한하고 있고 라이선스는 CC BY-NC-SA 4.0으로 상업적 이용을 금지합니다. 따라서 상업적 통합이나 유료 서비스에 포함시키려는 계획이 있다면 라이선스와 기술적 위험 때문에 사용을 재검토해야 합니다.
• 설치와 개발 흐름은 릴리스에서 바이너리를 내려받아 사용하는 방식과, web 서버 버전은 tar.gz를 풀고 Node로 실행하는 방식 두 가지를 제공합니다. 개발자는 pnpm을 권장하고 pnpm i · pnpm dev로 로컬에서 빌드·실행할 수 있으며 기여 전 CONTRIBUTING.md와 원리 문서를 참고하도록 안내하고 있습니다. GitHub 상의 스타 수는 126개로 커뮤니티 관심이 중간 수준이며 이슈·토론을 통해 실사용 사례와 버그 피드백이 이루어지고 있습니다.

이미지 분석