K0nd1us/QQ-agent

立志做使用起来最简单能实现的功能最全面的LLM机器人。

해결 과제

QQ Agent는 QQ 대화를 위한 로컬 AI 어시스턴트를 제공합니다. 모델 상호 작용, 세션 관리, 메모리, 페르소나 설정, 웹 검색 및 플러그인 기반 기능 확장을 처리합니다. 이 프로젝트는 현재 안정적인 베이스라인(0.4)과 모듈성 및 리소스 관리를 개선하기 위한 아키텍처 재작성 버전(0.5)으로 나뉘어 있습니다.

작동 방식

이 프로젝트는 사용자가 독립적으로 설치 및 구성해야 하는 OneBot v11 프로토콜을 통해 QQ에 연결됩니다. 에이전트는 애플리케이션 계층으로서 메시지를 처리하고 로직을 실행합니다. 버전 0.5는 구성 요소가 명확하게 정의된 "씬 커널(thin kernel)" 아키텍처를 도입하여 더 나은 구성 요소 교체, 표준화된 SDK 기반 확장 개발, 그리고 시작 또는 실패 시 더 안정적인 리소스 정리를 가능하게 합니다.

대상 사용자

QQ에서 로컬의 사용자 정의 가능한 AI 어시스턴트를 실행하려는 사용자를 위한 것입니다. 안정적인 기존 베이스라인이 필요한 사용자에게는 0.4 버전을 권장합니다. 0.5 버전은 개발자나 새로운 모듈식 아키텍처를 테스트하는 데 관심이 있는 사용자를 대상으로 하지만, 현재 미완성 상태이며 기능에 대한 수동 검증이 필요합니다.

주요 특징

  • 이중 버전 구조: 안정적인 베이스라인(0.4)과 진행 중인 아키텍처 재작성(0.5)을 분리하여 파괴적인 변경을 방지합니다.
  • 모듈식 아키텍처: 버전 0.5는 핵심 서비스, 프론트엔드 패널 및 플러그인 간의 명확한 경계에 집중하여 모듈 간 의존성을 줄입니다.
  • 확장 가능한 설계: 정의된 SDK, 권한 경계 및 수명 주기 관리를 갖춘 플러그인과 스킬을 지원합니다.
  • 프로토콜 독립성: OneBot v11을 사용하여 QQ와 인터페이스하므로 사용자가 프로토콜 측 설치 및 자격 증명을 직접 관리할 수 있습니다.
  • 리소스 제어: 구성 요소와 확장이 리소스를 관리하는 방식을 개선하여 메모리 누수나 잔류 작업을 방지합니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트