formulahendry/wechat-acp

해결하는 문제

wechat-acp는 Copilot CLI, Claude Code, Gemini 등 ACP 호환 AI 에이전트에 WeChat 1:1 메시지를 통해 직접 접근할 수 있도록 해주는 브리지입니다. 터미널이나 전용 AI 앱을 사용할 필요 없이, WeChat 메시지를 로컬 AI 에이전트로 라우팅하고 에이전트의 응답을 사용자에게 다시 전송함으로써 작업 흐름을 간소화합니다.

작동 방식

이 도구는 WeChat iLink 봇 API를 통해 로그인하고, 수신된 1:1 메시지를 폴링합니다. 메시지가 도착하면, 로컬에서 실행 중인 설정된 ACP 에이전트(Stdio를 통해)로 내용을 전달하고, 각 WeChat 사용자별로 전용 세션을 관리합니다. 다양한 데이터 유형을 처리하며, 이미지, 오디오, 파일과 같은 에이전트 출력을 네이티브 WeChat 메시지로 변환합니다. 또한 여러 WeChat 메시지(텍스트, 이미지, 파일)를 하나의 에이전트 요청으로 결합하는 버퍼링 모드를 제공하여 별도의 타ーン을 여러 번 트리거하는 것을 방지합니다.

대상 사용자

모바일 메시징 인터페이스를 통해 로컬 AI 에이전트나 CLI 기반 AI 도구에 접근하고 싶은 개발자 및 고급 사용자, 또는 로컬 인젝션 명령어를 사용해 WeChat을 통해 AI 상호작용을 자동화하고 싶은 사용자.

주요 기능

• 다중 에이전트 지원: Claude, Gemini, Qwen, Copilot 등 인기 에이전트용 내장 프리셋 제공.
• 세션 관리: 사용자별로 분리된 세션을 지원하며, 재시작 후에도 선택적으로 상태를 유지 가능.
• 리치 미디어 처리: WeChat과 에이전트 간 이미지, 오디오, 파일을 전달; 수신된 바이너리 파일은 디스크에 저장되어 에이전트가 접근 가능.
• 브리지 명령어: 세션 재시작(/acp-new), 타ーン 취소(/acp-cancel), 설정(/acp-config)용 내장 슬래시 명령어 제공.
• 로컬 인젝션: 외부 스크립트나 cron 작업에서 에이전트가 처리하고 WeChat으로 응답할 수 있도록 메시지를 큐에 넣을 수 있음.
• 인스턴스 격리: 서로 다른 WeChat 계정과 프로젝트 디렉터리로 여러 브리지 인스턴스를 동시에 실행 가능.