pinganbbOvO/ai-companion-kit

해결하는 문제

오늘날의 AI 어시스턴트는 답변에는 강하지만 로봇처럼 느껴집니다. 답변이 한 번에 도착하고, 대화를 넘어 사용자를 기억하지 못하며, 휴대폰에서 조작하거나 소셜 플랫폼에 게시할 방법이 없습니다. 이 프로젝트는 두 가지 격차를 해결합니다. AI를 더 인간답게 만들고(사람 기억, 현실적인 타이핑 지연, 침묵할 때 알기), 손을 부여합니다(adb로 실제 휴대폰 제어, 자체 주도로 QQ Zone에 게시).

작동 방식

키트는 함께 또는 단독으로 사용할 수 있는 독립 패키지로 나뉩니다.

• ai-companion — 각 사람에 대한 정보를 기억하고(채팅 세션별이 아닌 사람별로 저장), 일기를 쓰고(기억과 분리, 최근 항목만 컨텍스트에 포함), 인간처럼 타이핑하며(타이핑 시간, 메시지 분할, 일시 중지, 밤에는 느림), 말할지 침묵할지 결정합니다("@에서만 깨어남", "그룹에서 이름이 불리지 않으면 침묵"과 같은 규칙 포함).
• phone-mcp — AI에 34개의 MCP 도구를 노출하여 탭, 스와이프, 중국어 입력, 스크린샷, 화면 녹화, 콤보 작업을 모두 adb를 통해 수행할 수 있습니다(실제 기기 또는 에뮬레이터에서 작동). NetEase Cloud Music도 제어할 수 있습니다.
• qzone + qzone-mcp — AI가 자체적으로 QQ Zone에 게시할 수 있게 하며, 6가지 도구를 제공합니다: 게시(텍스트 + 최대 9개 이미지), 내 게시물 보기, 친구 피드 보기, 다른 사용자 게시물 보기, 좋아요, 댓글(엄격한 속도 제한 포함). 원클릭 스크립트(npm run qzone)는 게이트웨이를 확인하고, 설정을 검증하며, AI가 게시할 수 있는 시기를 정의하는 역할 카드에 단락을 추가합니다.
• own-life(키트에 포함) — 2.5시간마다 AI를 조용히 알립니다(단, 3:00~8:00 제외, 하루 최대 6회). AI는 자체적으로 QQ Zone 업데이트를 게시하거나 일기 항목을 쓸지 결정할 수 있습니다. 상태를 저장하므로 재시작 시 메시지 홍수가 발생하지 않습니다.

키트에는 간편 설치 프로그램이 포함되어 있습니다. Windows에서 tools/安装.bat을 더블 클릭하면 Node 확인, QQ 브리지 다운로드, 종속성 설치, config.json 생성이 이루어집니다(당신의 QQ ID, 그녀의 QQ ID, 게이트웨이 토큰만 입력). Node.js와 QQ 게이트웨이(SnowLuma)는 별도로 설치해야 합니다(README에 스크린샷 가이드가 있습니다).

대상 사용자

• 비프로그래머: 살아있는 느낌의 QQ 컴패니언(기억, 인간다운 타이핑, 일기)을 원하고 QQ Zone에도 게시할 수 있는 사람. README는 AI 데스크톱 앱(DeepSeek, ChatGPT, Cursor)에 설치를 요청하는 방법을 설명합니다.
• 명령줄에 약간 익숙한 사람: 약 15분 안에 기본 채팅 전용 설정을 실행하려는 사람.
• 프로그래머: 완전한 제어를 원하는 사람. README에는 음성 인식, 휴대폰 제어, 음악 감상, 일기, 속도 제한 방지 팁에 대한 자세한 튜토리얼이 포함되어 있습니다(13장은 분당 20메시지에서 Tencent 속도 제한에 도달하는 것에 대해 경고합니다 — 건너뛰지 마세요).

주요 기능

• 사람별 기억 — AI는 각 연락처에 대한 정보를 개별적으로 기억하고 그룹 채팅과 DM에서 모두 유지합니다(예: 그룹에서 말한 사실은 개인 채팅에서도 회상됨).
• 인간다운 타이핑 — "입력 중..." 표시기를 보여주고, 메시지를 분할하여 일시 중지하며 보내고, 밤에는 타이핑이 느려집니다.
• 깨우기 전략 — 완전히 구성 가능: @, 톡, 소유자 메시지, 키워드에 반응하거나 그룹에서 이름이 불리지 않으면 침묵.
• 개성 있는 일기 — AI는 역할 카드, 최근 컨텍스트, 이전 일기 항목에서 직접 자신의 저널(1~4문장, 1인칭)을 씁니다. 반복적인 "오늘은 충실했다" 같은 채우기를 피합니다. 수동으로 항목을 추가할 수도 있습니다.
• 자체 주도 QQ Zone 게시 — AI는 자연스럽게 게시 시점을 결정합니다(예약 봇이 아님). 화이트리스트 디렉토리의 이미지만 게시할 수 있으며 삭제나 차단 기능이 없습니다 — README는 의도적인 안전 선택이라고 말합니다.
• 안전한 휴대폰 제어 — 탭, 스와이프, 입력, 스크린샷, 녹화, 콤보 작업이 가능하지만 README는 결제 또는 은행 앱이 있는 휴대폰에서 사용하지 말 것을 강력히 경고합니다. 에뮬레이터나 여분 기기를 사용하세요.
• 모든 데이터는 로컬 일반 텍스트 — 기억은 JSON, 채팅 흐름은 JSONL, 일기는 JSONL 및 일별 Markdown 파일. 언제든지 읽기, 편집, grep, 백업이 가능합니다.
• 각 레이어는 독립적으로 사용 가능 — 컴패니언만, 휴대폰 제어만, 또는 QQ Zone 게시만 사용할 수 있습니다.

(참고: 이 설명은 README에만 기반합니다. 설명된 모든 기능은 README에 있습니다.)