Community코딩 & 개발github.com

qq9935215/wechat-chat-sync-skill

Codex 스킬: 로컬 WeChat 채팅을 증분 방식으로 Markdown 지식 베이스에 동기화합니다.

wechat-chat-sync-skill란 무엇인가요?

이 스킬은 Codex(예: Claude Code, Cursor 등)에서 사용할 수 있는 기능으로, 로컬 WeChat 채팅 기록을 증분(incremental) 방식으로 Markdown 파일로 동기화하여 지식 베이스를 구축합니다. 사용자는 이를 통해 WeChat 대화 내용을 체계적으로 관리하고, AI 에이전트가 검색 및 요약에 활용할 수 있는 구조화된 마크다운 문서로 변환할 수 있습니다. 주로 Windows/macOS 환경에서 WeChat 데이터베이스 파일을 읽어와 처리하며, 별도의 서버나 복잡한 설정 없이 로컬에서 실행됩니다. 이 스킬은 특히 긴 대화, 파일 공유, 링크 등의 다양한 WeChat 메시지 유형을 지원하여 완전한 채팅 아카이브를 생성하는 데 유용합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add qq9935215/wechat-chat-sync-skill

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

wechat-chat-sync-skill은(는) 무엇을 하나요?

Codex 스킬: 로컬 WeChat 채팅을 증분 방식으로 Markdown 지식 베이스에 동기화합니다.

이 스킬은 Codex 에이전트(예: Claude Code, Cursor, Codex CLI)에서 사용할 수 있도록 설계되었습니다. 로컬 WeChat 데이터베이스에서 증분(incremental) 동기화를 수행하여 채팅 기록을 구조화된 Markdown 문서로 변환합니다.

사용법

  1. 에이전트에게 이 스킬이 활성화되었는지 확인합니다.
  2. sync 명령어를 호출하여 최신 채팅 데이터를 동기화합니다.
  3. 생성된 Markdown 파일을 검토하거나 에이전트의 지식 베이스에 추가합니다.

기능

  • WeChat 데이터베이스에서 메시지 읽기
  • 증분 동기화 지원 (이미 동기화된 채팅은 건너뜀)
  • Markdown 변환 (메시지 유형별 템플릿 포함)
  • 파일 첨부 및 이미지 지원

요구 사항

  • Windows 또는 macOS
  • WeChat 데스크톱 클라이언트 설치 및 로그인
  • Python 3.8 이상 (SQLite 및 파일 접근 권한 필요)

설치

pip install -r requirements.txt

실행

from wechat_sync import WeChatSync

sync = WeChatSync()
sync.sync_all()

출력

출력 파일은 output/ 디렉토리에 저장됩니다. 각 대화는 별도의 Markdown 파일로 저장되며, 파일명은 대화방 이름을 기반으로 생성됩니다.

주의 사항

  • WeChat 데이터베이스 파일은 암호화되어 있으므로, 이 스킬은 WeChat 데스크톱 클라이언트가 실행 중일 때만 접근 가능합니다.
  • 개인 정보 보호를 위해 동기화된 데이터는 로컬에서만 관리하세요.
  • 자세한 내용은 GitHub 저장소를 참조하세요.

관련 스킬