디테봇(Dite Bot) 개요
디테봇은 디스코드(Discord) 생태계에서 활동하는 고성능 하이브리드 대화 AI 시스템입니다. Gemini-3.1-Flash-Lite 모델을 메인 신경망으로 활용하며, 디스코드 봇 구동 중 발생할 수 있는 자원 및 계정 한도 초과 오류를 능동적으로 우회하기 위해 다중 API 로테이션 및 실시간 검증 모듈을 내장하고 있습니다. 단순 응답을 넘어 로컬 SQLite 데이터베이스를 기반으로 동작하여 유저의 행동 양식, 누적 채팅, 제재 상태 및 영속 기억들을 실시간 보정 동기화합니다.
다중 API 로테이션
API 키를 풀(Pool) 단위로 유지하고, 순차 로테이션을 가동하여 특정 키 만료 시 401 오류를 탐지해 실시간 격리합니다.
하이브리드 병렬 검색
DuckDuckGo Lite GET 및 Wikipedia API를 비동기 병렬 조회하여 최적화된 출처 각주 마크다운 리포트를 자동 완성합니다.
비파괴 소프트 삭제
사용자나 관리자가 기억 초기화를 시행할 때, 실제 런타임 풀에서만 삭제하고 DB 아카이브 격리실에 영구 백업 보존합니다.
스마트 타임 정지 가드
`30m`, `5h`, `7d` 등의 한글/영문 융합 정지 기한 포맷을 파싱하여 타겟 사용자 ID를 정교하게 차단 관리합니다.
디테 아키텍처 상세 백서
직접 배포 및 가동 안내
디테봇은 간결하게 가상 서버(VPS), 라즈베리 파이, 토이 서버 등 환경에서 즉시 구동될 수 있도록 개발되었습니다. 설치를 완료한 후 아래 실행 커맨드를 이용해 패키지를 구축하세요.
가동 절차
- Python 3.11 이상 버전 및 SQLite 패키지가 활성화되어 있는지 확인합니다.
pip install -r requirements.txt명령어를 실행하여 외부 종속성을 수집합니다.- 같은 루트 경로에 디스코드 봇 토큰 및 제반 환경이 기입된
.env파일을 설정합니다. python ver_7.3.py명령어로 즉시 가동을 시작합니다.
# 1. 소스 디렉터리로 이동 cd /your/ditebot/directory # 2. 필수 라이브러리 일괄 자동 다운로드 pip install discord.py google-genai python-dotenv beautifulsoup4 aiohttp selenium # 3. 디테봇 v7.3 서버 데몬 백그라운드 구동 (로그 보전) nohup python ver_7.3.py > ditebot.log 2>&1 &
SQLite3 통합 데이터베이스 명세서
디테봇 내부 데이터 저장소인 bot_data.db의 상세 테이블 스키마 정의 및 샘플 데이터를 시뮬레이션 형태로 탑재했습니다. 테이블명을 선택하여 실제 SQL 구조와 들어가는 샘플값을 교차 매핑하여 볼 수 있습니다.
TABLE 명세
테이블을 왼쪽에서 선택하면 상세 명세 및 수록 샘플 데이터 열람이 가동됩니다.
SQL 필드 정보 (Ddl Schema)
| 필드 이름 | 타입 | 제약 조건 | 설명 |
|---|
샘플 레코드 (Mock Row Data)
// JSON 형태로 로컬 레코드 데이터 샘플을 출력합니다.
디테봇 명령어 사전 및 옵션 가이드
디테봇 v7.3 소스 코드에 명세된 모든 디스코드 슬래시 및 일반 접두사 명령어의 완벽한 명세서입니다. 유저용과 관리자 전용 제어 기전이 엄격하게 가드 처리되어 있습니다.
/대화 질문: [문자열] 파일: [첨부파일]
일반 유저디테봇과 실시간 채팅을 나눕니다. 텍스트 문서 파일이나 이미지를 업로드하여 정밀 분석을 수행할 수 있습니다.
/기억초기화
일반 유저자신이 디테와 나누었던 이전 모든 대화 기억들을 비우고 첫 대화 상태로 포맷합니다.
deleted_memories 격리실로 자동 비파괴 보존 이식
/설정
봇 개발자 전용디테봇의 핵심 동적 제어를 처리하는 관리자 종합 패널 GUI를 반환합니다.
!기억초기화
일반 유저슬래시 명령어를 사용하기 곤란한 환경에서 일반 채팅 메시지로 대화 역사 세션을 지우고 초기화합니다.
디테 정보
일반 유저등록된 Gemini 클라이언트의 활성 키별 호출 성공/실패 횟수, 지연(Latency), 가동 중인 신경망 AI 모델을 정밀 임베드로 반환합니다.
디테 통계 / 디테 채팅랭크
일반 유저해당 디스코드 서버 내 누적 채팅 점수를 매겨 멤버들의 실시간 참여 랭킹 페이징 리더보드 뷰를 반환합니다.
디테봇 가상 작동 시뮬레이션 샌드박스
디테봇 v7.3 소스코드의 런타임 알고리즘을 100% 모사한 가상 에뮬레이터입니다. 단순 검색을 포함해, 부적절한 멘션 도배 경고, 차단된 유저 제재 처리, 생각 과정 마스킹, 출처 마크다운 자동 융합까지 종합 테스트해 볼 수 있습니다.
시뮬레이터 제어 센터
자주 묻는 질문 템플릿
실시간 파이프라인 로그
// 대화 전송 시 디테의 실시간 데이터 파이핑 처리가 여기에 디버깅됩니다.
디테 봇
현재 채널 작동 허용됨
안녕! 🌟 나는 실시간 검색 정보와 최신 가요 멜론 차트 파싱 엔진이 결합된 상냥한 AI 비서 **디테**야! 나랑 같이 깊이 있는 대화를 시작해 볼래? 어떤 것이든 친절하게 알려줄게! 😊