MaiBot(MaiSaka)은 주로 QQ 그룹 채팅에서 플러그인 시스템을 통해 사람처럼 편안한 말투로 대화하는 LLM 기반 에이전트입니다.
tencent-connect/dsh-qqbot
공식 QQ Bot API를 통해 DeepSeek Harness(dsh) AI 에이전트를 QQ 개인 채팅과 그룹 채팅에 연결하는 플러그인입니다.
- 스타
- 557
- 포크
- 68
- 열린 이슈
- 36
- 마지막 커밋
- 4일 전
어떤 프로젝트인가요?
dsh-qqbot은 deepseek-harness(dsh)용 플러그인으로, AI 에이전트가 QQ 메시지에 응답할 수 있게 합니다. QQ 개인 채팅 사용자마다, 그룹 채팅마다 별도의 에이전트 세션이 생성되며, 응답은 Markdown으로 전송되고 긴 메시지는 여러 부분으로 나뉩니다.
데스크톱 앱에서 모바일 QQ로 QR 코드를 스캔하거나, 명령줄에서 npx를 사용해 설정할 수 있습니다. 계정을 연동하면 인증 정보가 프로필에 저장되어 다음에 실행할 때는 QR 코드를 다시 스캔하지 않아도 됩니다. 개인 채팅이나 그룹별로 접근 권한을 전체 허용, 허용 목록, 비활성화 모드 중에서 설정할 수 있으며, 그룹 채팅에서는 응답을 트리거하려면 @멘션이 필요하도록 설정할 수도 있습니다.
플러그인은 멀티미디어와 상호작용도 지원합니다. 사용자가 보낸 이미지와 동영상을 분석하고, 경로 허용 목록에 따라 로컬 파일을 사용자에게 전송하며, 인라인 버튼으로 객관식 질문을 하고 민감한 작업에 대한 승인을 요청할 수 있습니다. 내장 슬래시 명령으로 새 세션 시작, 컨텍스트 압축, 모델 전환, 프리셋 적용을 처리합니다.
핵심 기능
- 01QQ Bot API를 통해 DeepSeek 에이전트를 QQ 개인 채팅과 그룹 채팅에 연결합니다.
- 02개인 사용자와 그룹마다 별도의 에이전트 세션을 제공합니다.
- 03QR 코드를 스캔해 계정을 연동하고 인증 정보를 저장해 다음 실행부터 재사용합니다.
- 04전체 허용, 허용 목록, 비활성화 모드로 채팅별 접근을 제어합니다.
- 05이미지와 동영상을 이해하고 로컬 파일을 사용자에게 전송합니다.
- 06질문과 승인 요청에 인라인 버튼을 사용합니다.
활용 사례
- 커뮤니티 QQ 그룹에서 DeepSeek 기반 어시스턴트 봇을 운영합니다.
- 허용 목록을 적용해 QQ 사용자별로 비공개 AI 도우미를 제공합니다.
- 로컬 프로젝트 파일을 바탕으로 질문에 답하는 QQ 봇을 만듭니다.
- QQ 플랫폼에서 대화형 봇을 프로토타이핑합니다.
빠른 시작
- 1
플러그인을 dsh 프로필에 설치합니다
npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot - 2
봇을 시작하고 모바일 QQ로 QR 코드를 스캔해 인증 정보를 연결합니다
npx @deepseek-ai/dsh --profile qqbot
사용 전 알아둘 점
- 실행하려면 deepseek-harness(dsh) 런타임이 필요합니다.
- 연결하려면 QQ Bot 계정과 QR 코드를 스캔할 모바일 QQ가 필요합니다. 또는 AppID와 AppSecret을 직접 설정할 수 있습니다.
- 기본적으로 그룹 채팅에서는 @멘션이 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- dsh-qqbot은(는) 무엇인가요?
- 공식 QQ Bot API를 통해 DeepSeek Harness(dsh) AI 에이전트를 QQ 개인 채팅과 그룹 채팅에 연결하는 플러그인입니다. dsh-qqbot은 deepseek-harness(dsh)용 플러그인으로, AI 에이전트가 QQ 메시지에 응답할 수 있게 합니다. QQ 개인 채팅 사용자마다, 그룹 채팅마다 별도의 에이전트 세션이 생성되며, 응답은 Markdown으로 전송되고 긴 메시지는 여러 부분으로 나뉩니다.
- dsh-qqbot은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- dsh-qqbot은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- dsh-qqbot은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. dsh-qqbot의 마지막 커밋은 2026년 11월 3일입니다.
- dsh-qqbot은(는) 어디에 사용할 수 있나요?
- 커뮤니티 QQ 그룹에서 DeepSeek 기반 어시스턴트 봇을 운영합니다. 허용 목록을 적용해 QQ 사용자별로 비공개 AI 도우미를 제공합니다. 로컬 프로젝트 파일을 바탕으로 질문에 답하는 QQ 봇을 만듭니다. QQ 플랫폼에서 대화형 봇을 프로토타이핑합니다.
- dsh-qqbot는 어떻게 설치하나요?
- 플러그인을 dsh 프로필에 설치합니다: npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot 봇을 시작하고 모바일 QQ로 QR 코드를 스캔해 인증 정보를 연결합니다: npx @deepseek-ai/dsh --profile qqbot
- dsh-qqbot은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tencent-connect/dsh-qqbot
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
QQ 및 기타 채팅 봇에 LLM 대화 기능을 추가하는 Koishi 봇 플러그인으로, 다양한 모델 제공자와 프리셋, 여러 출력 형식을 지원합니다.
DuckDuckGo, Bing 등으로 무료 키 없는 웹 검색을 제공하고 엔진 간 자동 대체를 지원하는 DeepSeek Harness 플러그인입니다.
여러 코딩 에이전트 폴더에 있는 로컬 Agent Skills를 확인하고 켜고 끄거나 설치·업데이트·복원할 수 있는 DSH 플러그인입니다.