TL;DR

WeChat-AI는 Tencent iLink에 직접 연결해 WeChat 안에서 AI 역할극과 사용자 간 대화 중계를 제공하는 self-hosted 서비스입니다. TypeScript 모노레포 안에서 iLink 클라이언트, Redis 저장소, OpenAI 호환 LLM 연동, 페르소나·기억·Chatflow 엔진을 분리하고 LINUX DO OAuth로 사용자와 관리자를 인증합니다. Docker Compose 단일 배포부터 공유 Redis와 Cloudflare Worker를 이용한 다중 노드 운영까지 지원하며, 스티커·이미지 이해·음성 전사 같은 WeChat 기능도 포함합니다. 다만 iLink가 실측 기반의 변경 가능한 프로토콜이고 개인 Bot의 제한 위험과 LLM API 외부 전송이 있으므로, Tencent 연동 안정성과 개인정보 정책을 직접 감당할 운영자에게 적합합니다.

핵심 포인트

• WeChat-AI는 별도 호스팅하는 WeChat 역할극 대화 서비스입니다. Tencent iLink로 WeChat 메시지를 받고 OpenAI 호환 LLM을 거쳐 답장을 보냅니다. LINUX DO OAuth 기반 사용자·관리자 인증이 필요한 독립형 애플리케이션입니다.
• 사용자는 웹 사용자 센터에서 WeChat 봇을 QR 코드로 등록하고 승인된 대화 상대와 P2P 중계를 설정합니다. 페르소나와 기억은 Redis 저장소 및 core 엔진이 관리합니다. `/chatflow` 편집기로 prompt 또는 시각적 대화 흐름을 선택할 수 있습니다.
• apps/api, packages/core, packages/llm, packages/db로 API·대화 엔진·모델 연결·Redis 저장소를 분리한 TypeScript 모노레포입니다. `huggingface/wechat-ai-tools`를 별도 배포하면 사용자 지정 LLM과 웹 검색 요청을 단일 외부 AI 출구로 보낼 수 있습니다. 이미지 이해는 `VISION_ENABLED`로 제어하고 음성은 WeChat 기본 전사를 사용합니다.
• Docker Compose로 단일 노드를 실행하고 같은 이미지를 여러 서버에 배포할 수 있습니다. 공유 Upstash Redis와 Cloudflare Worker의 상태 확인·라운드로빈 분산으로 다중 노드를 구성합니다. iLink 프로토콜 변경, 개인 봇의 제한·제재, LLM API로 전송되는 역할극 데이터가 도입 전 확인할 위험 요소입니다.