WeChatBridge란
중국어 이름이 “微信流”인 WeChatBridge는 기본 기능을 활용하고 가볍게 작동하며 완전히 로컬에서 실행되는 macOS 도구입니다. macOS용 WeChat 4.1.13 이상에서 제공하는 “병합 전달” 기능을 이용해 채팅 기록에서 생성된 TXT, 이미지 및 동영상을 보관하고, 시스템 공유 확장을 통해 AI Agent, 로컬 지식 베이스, 클립보드 또는 기타 지정된 앱으로 전송합니다.
WeChat 데이터베이스를 읽거나 WeChat 프로세스를 복호화, 주입 또는 수정하지 않습니다. 채팅 내용은 WeChat에서 사용자가 직접 내보낸 파일에서만 가져오며, 보관 파일, 상황 설정 및 전달 기록은 모두 로컬에 저장됩니다.
주요 기능
9개의 기본 전달 대상
공유 확장을 설치하고 활성화하면 WeChat의 “다른 앱으로 전달” 메뉴에서 다음 대상을 바로 선택할 수 있으며, WeChatBridge 기본 창을 미리 열 필요가 없습니다.
- Codex로 보내기: ChatGPT/Codex를 활성화하고 채팅 보관 파일을 붙여 넣습니다.
- Claude로 보내기: Claude를 활성화하고 채팅 보관 파일을 붙여 넣습니다.
- Doubao로 보내기: Doubao를 활성화하고 채팅 보관 파일을 붙여 넣습니다.
- Qianwen Office로 보내기: Qianwen Office를 활성화하고 채팅 보관 파일을 붙여 넣습니다.
- WorkBuddy로 보내기: WorkBuddy를 활성화하고 채팅 보관 파일을 붙여 넣습니다.
- WeSight로 보내기: WeSight를 활성화하고 채팅 보관 파일을 붙여 넣습니다.
- Obsidian에 보관하기: Markdown 노트를 만들고 원본 첨부 파일을 저장합니다.
- 클립보드에 복사: 파일을 유지하고 사용자가 직접 붙여 넣습니다.
- 사용자 지정 대상으로 보내기: 사용자가 관리하는 macOS 앱 목록으로 전달합니다.
상황, 스킬 및 로컬 기록
WeChatBridge에서는 다양한 그룹 채팅이나 작업에 사용할 상황별 프롬프트를 저장하고 적용할 Agent를 지정할 수 있습니다. 스킬 센터에서는 호환되는 Agent의 SKILL.md를 관리할 수 있습니다. 기본 앱은 로컬 배치 기록도 저장하므로 상태 확인, 재전송, 내용 복사, 파일 위치 확인 또는 기록 삭제가 가능합니다.
실패 시 대체 처리
대상 앱이 설치되어 있지 않거나 시스템 권한이 부족한 경우에도 WeChatBridge는 파일을 클립보드에 보관하므로 후속 작업을 수동으로 완료할 수 있습니다.
설치 전 준비
WeChatBridge를 사용하기 전에 다음 요구 사항을 충족하는지 확인하세요.
- macOS 14 Sonoma 이상.
- 자동으로 붙여 넣으려면 시스템 설정에서 손쉬운 사용 권한을 부여해야 합니다.
- WeChat 제목 표시줄의 채팅 이름을 인식하려면 화면 기록 권한을 부여해야 합니다.
- 소스에서 빌드하려면 Xcode 16 또는 Swift 6과 호환되는 Command Line Tools가 필요합니다.
화면 기록 권한은 WeChat 제목 표시줄의 채팅 이름을 인식하는 데만 사용되며, 이미지는 메모리에서만 처리됩니다. 손쉬운 사용 권한은 대상 앱을 활성화하고 붙여 넣기를 실행하는 데만 사용됩니다.
방법 1: 릴리스 버전 설치
WeChatBridge GitHub Releases를 열고 최신 DMG를 다운로드합니다. README에 Developer ID 서명과 Apple 공증을 거친 설치 패키지가 릴리스되었다고 안내되어 있습니다.
DMG를 열고 “微信流”를 “응용 프로그램” 디렉터리로 드래그합니다. 설치 패키지는 Apple Silicon과 Intel Mac을 모두 지원합니다.
WeChatBridge를 실행하고 “설정 → 진입점”으로 이동합니다.
Claude, Codex, Obsidian 또는 클립보드 복사 등 필요한 공유 대상을 활성화합니다.
진입점이 시스템 공유 메뉴에 나타나지 않으면 “시스템 설정 → 일반 → 로그인 항목 및 확장 프로그램 → 공유”로 이동하여 해당 확장이 활성화되어 있는지 확인합니다.
방법 2: 소스에서 빌드
개발자는 저장소를 복제하고 테스트를 실행한 뒤 릴리스 빌드를 생성할 수 있습니다.
git clone https://github.com/freestylefly/WeChatBridge.git
cd WeChatBridge
swift test
CONFIG=release Scripts/make-app.sh빌드가 완료되면 앱은 dist/微信流.app에 생성됩니다. 다음 스크립트를 사용하면 개발 버전을 현재 사용자의 “응용 프로그램” 디렉터리에 설치하고 공유 확장을 등록할 수 있습니다.
Scripts/install-dev-build.sh설치 후 “微信流 → 설정 → 진입점”을 열고 필요한 공유 대상을 활성화합니다.
로컬 빌드에서는 키체인에 있는 Apple Development 또는 Developer ID 인증서를 우선 사용합니다. 사용 가능한 인증서가 없으면 ad-hoc 서명을 사용하며, 이 경우 macOS에서 손쉬운 사용 권한을 다시 부여해야 할 수 있습니다.
기본 사용법: WeChat 채팅을 AI Agent로 보내기
macOS용 WeChat에서 대상 채팅을 엽니다.
처리할 채팅 기록을 여러 개 선택하고 “병합 전달”을 선택합니다.
“다른 앱으로 전달”로 이동한 뒤 “Claude로 보내기”, “Codex로 보내기” 또는 활성화한 다른 AI 대상을 선택합니다.
WeChatBridge가 WeChat에서 생성한 ZIP 보관 파일을 받습니다. 여기에는 TXT, 이미지 및 동영상이 포함될 수 있습니다.
WeChatBridge가 대상 앱을 활성화하고 선택한 상황 지침을 첨부한 다음 채팅 보관 파일을 자동으로 붙여 넣습니다.
예를 들어 업무 그룹의 논의를 처리할 때 먼저 “회의 정리” 상황을 만들고 다음과 같은 작업 지침을 저장할 수 있습니다.
이 채팅 보관 파일을 바탕으로 다음을 정리해 주세요.
1. 확인된 결정 사항
2. 할 일과 담당자
3. 아직 해결되지 않은 문제
4. 관련 링크와 첨부 파일전달할 때 이 상황을 선택하면 호환되는 Agent가 정해진 구조에 따라 내용을 처리합니다. 상황별 프롬프트는 사용자가 직접 관리하며, 실제 실행 결과는 사용하는 대상 앱과 모델에 따라 달라집니다.
기본 사용법: Obsidian에 보관하기
WeChatBridge에서 “Obsidian에 보관하기” 진입점이 활성화되어 있는지 확인합니다.
WeChat에서 기록을 여러 개 선택하고 “병합 전달”을 실행합니다.
공유 메뉴에서 “Obsidian에 보관하기”를 선택합니다.
WeChatBridge가 Markdown 노트를 생성하고 원본 ZIP 및 관련 첨부 파일을 저장합니다.
내용은 채팅 이름별로 정리되므로 로컬 지식 베이스에서 검색하고 계속 정리하기 쉽습니다.
이 방식은 프로젝트 논의, 학습 자료 또는 그룹 채팅의 중요한 정보를 축적하면서 WeChat에서 내보낸 원본 보관 파일도 유지하려는 경우에 적합합니다.
클립보드 및 사용자 지정 대상 사용
클립보드에 복사
다른 앱을 바로 열고 싶지 않다면 “클립보드에 복사”를 선택할 수 있습니다. WeChatBridge가 파일을 보관하므로 나중에 대상 앱으로 직접 전환해 붙여 넣으면 됩니다. 권한이 부족하거나 대상 앱이 설치되어 있지 않을 때도 유용한 대체 방법입니다.
사용자 지정 앱으로 보내기
기본 제공 대상 외에도 macOS 앱 목록을 직접 관리할 수 있습니다. 터미널 앱의 경우 파일 경로만 받도록 구성하면 기존 스크립트나 명령줄 워크플로에 채팅 보관 파일을 전달하기 편리합니다. 구체적인 대상은 현재 Mac에 설치된 앱에 맞게 설정해야 합니다.
고급 활용법
작업별 상황 만들기
모든 채팅에 같은 프롬프트를 사용하지 마세요. 회의 요약, 요구 사항 분석, 고객 피드백, 링크 추출 또는 학습 노트 등의 상황을 각각 만들고 각 상황에 적합한 Agent를 지정할 수 있습니다. 이렇게 하면 반복 입력을 줄이고 결과 구조를 일관되게 유지할 수 있습니다.
필요한 진입점만 활성화
9개의 공유 대상은 개별적으로 켜고 끌 수 있습니다. 평소 사용하는 대상만 남기면 WeChat 공유 메뉴를 더 간결하게 만들 수 있습니다. WeChatBridge는 아직 설치되지 않은 대상 앱도 표시하므로 구성을 확인하기 쉽습니다.
Agent 스킬 관리
스킬 센터는 호환되는 Agent의 SKILL.md를 관리하는 기능입니다. 워크플로에서 그룹 채팅의 링크, 동영상 또는 특정 유형의 자료를 처리해야 한다면 프로젝트에 내장된 스킬이나 직접 관리하는 스킬 설정을 활용할 수 있습니다. 단, 대상 Agent가 해당 형식을 지원하는지 먼저 확인해야 합니다.
로컬 기록으로 재시도
전달 후 기본 앱에서 배치 상태를 확인할 수 있습니다. 전송이 중단되면 WeChat에서 같은 메시지를 다시 선택하지 않고도 기록에서 재전송하거나, 내용을 복사하거나, 보관 파일 위치를 확인할 수 있습니다.
기록 정기 삭제
이미지, 동영상 및 원본 ZIP 파일은 디스크 공간을 계속 차지할 수 있습니다. 중요한 내용이 지식 베이스에 저장되었는지 확인한 뒤 로컬 기록에서 더 이상 필요하지 않은 배치를 삭제할 수 있습니다.
개발 및 검증 명령
소스 코드를 수정한 후에는 저장소에서 제공하는 스크립트를 사용해 테스트, 리소스 검증 및 개발 미리 보기를 실행할 수 있습니다.
# 테스트 실행
swift test
# 중국어 및 영어 리소스 검증
swift Scripts/check-localizations.swift
# 서명, Bundle ID, App Group 및 릴리스 구성 확인
Scripts/check-release-config.sh
# 개발 버전 빌드, 설치 및 실행
Scripts/dev-preview.sh프로젝트는 Swift Package Manager로 소스 코드와 Sparkle 종속성을 관리합니다. Scripts/make-app.sh는 기본 프로그램과 9개의 Share Extension을 하나의 완전한 macOS 앱으로 구성합니다. GitHub Releases 자동 업데이트 메커니즘을 위한 설정은 마련되어 있지만 현재 소스 구성에서는 자동 확인 기능이 활성화되어 있지 않습니다.
개인정보 보호 및 보안 범위
- WeChat에서 사용자가 직접 내보낸 채팅 파일만 처리합니다.
- WeChat 데이터베이스를 읽지 않으며, 복호화, 주입 또는 프로세스 수정을 수행하지 않습니다.
- 채팅 보관 파일, 상황 및 기록은 모두 로컬에 저장됩니다.
- Share Extension은 macOS 샌드박스에서 실행되며 네트워크 권한이 없습니다.
- 화면 기록은 채팅 이름 인식에만 사용되며, 이미지는 메모리에서만 처리됩니다.
- 손쉬운 사용 권한은 앱을 활성화하고 붙여 넣기를 실행하는 데만 사용됩니다.
마무리
WeChatBridge는 WeChat의 기본 병합 전달 기능, AI Agent 및 로컬 지식 베이스를 간결한 macOS 워크플로로 연결합니다. 일반 사용자는 DMG를 바로 설치하고 공유 대상을 활성화할 수 있으며, 개발자는 소스에서 빌드하고 확장할 수도 있습니다. 상황별 프롬프트, 스킬 관리, 사용자 지정 대상 및 Obsidian 보관 기능을 활용하면 WeChat 데이터베이스를 읽지 않고도 채팅 정보를 더 효율적으로 처리하고 축적할 수 있습니다.