bojieli/greenbubbles

해결하는 문제

GreenBubbles를 사용하면 데이터를 수동으로 내보낼 필요 없이 macOS에서 자신의 WeChat 채팅 기록에 액세스하고 검색할 수 있습니다. 특히 AI 에이전트(Claude Code 또는 Codex 등)가 이 기록을 실시간으로 읽어 대화를 바탕으로 구조화된 메모, 개인 위키 또는 생활 요약을 생성할 수 있도록 지원합니다.

작동 방식

이 도구는 Mac CLI 및 선택적 앱으로 작동하며, 기기에 로컬로 저장된 WeChat의 원본 암호화 데이터베이스를 읽습니다. 실행 중인 WeChat 앱에서 계정 암호화 키를 캡처하기 위해 일회성 설정(관리자 권한 필요)이 필요합니다. 키를 획득하면 GreenBubbles는 라이브 데이터베이스를 직접 쿼리하여 사람이나 AI 에이전트가 사용할 수 있는 JSON Lines 형식으로 결과를 반환합니다. 또한 코딩 에이전트가 CLI를 사용하여 채팅 데이터를 검색하고 정리하는 방법을 안내하는 '스킬'(Markdown 지침 파일)도 제공합니다.

대상 사용자

개인 지식 관리를 위해 프로그래밍 방식으로 WeChat 기록에 액세스하거나 AI 에이전트에 개인적인 맥락을 추가하려는 기술적인 macOS 사용자(Apple silicon, macOS 14+).

주요 특징

• 실시간 액세스: 라이브 데이터베이스를 직접 읽으므로 수동 내보내기나 중복 복사본을 유지할 필요가 없습니다.
• 에이전트 통합: 인기 있는 코딩 에이전트를 위한 사전 정의된 스킬을 제공하여 대화를 인용이 포함된 Markdown 메모로 변환합니다.
• 로컬 우선 개인정보 보호: 모든 읽기, 검색 및 저장은 Mac에서 로컬로 이루어집니다. 사용자가 명시적으로 클라우드 기반 AI 제공업체를 사용하지 않는 한 데이터는 기기를 떠나지 않습니다.
• 암호화된 백업: 24단어 복구 문구로 보호되는 채팅 기록의 암호화된 스냅샷 생성을 지원합니다.
• 포괄적인 CLI: 채팅 목록 표시, 메시지 검색, 활성 대화 순위 지정 및 개인 정보 삭제를 위한 도구가 포함되어 있습니다.