7c9146cd2d513eb04805ec2c1099f80f042108ca
- docs/dev/ARCHITECTURE.md: 코어-워커-사이트 인터페이스 계약 - worker/: faster-whisper 한국어 STT, 음량 정규화, 4단계 잡음 판정, 사전 교정, GPU 감지·모델/CUDA 다운로드, 롤 채팅 OCR·r3dlog, 파인튜닝 파이프라인 (39 tests) - app/src/core: 디스코드 DAVE 음성 녹음(Ogg Opus), STT 대기열, 발로란트/롤 로컬 API 어댑터, 타임라인·기록 API, 사이트 중계, 7일 음성 삭제, 진단 - tools/gen-dictionary.mjs: 공식 게임 데이터 기반 기본 단어사전 (1993단어) - M0 결과: DAVE 연결 1.06s Ready, CPU tiny STT 3.6s→0.31s, 가짜 Riot 서버 통합 테스트 통과 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
겜녹이 (Game Voice Recorder, GVR)
디스코드 음성채널에 봇이 들어가 참가자 각자의 목소리를 따로 녹음하고, 게임 PC의 NVIDIA GPU로 한국어 텍스트(STT)로 바꾼 뒤, 발로란트·리그 오브 레전드 경기 데이터(킬·라운드·오브젝트·인게임 채팅)와 같은 타임라인에 묶어 https://gvr.tkrmagid.kr 에서 보고 듣는 프로그램입니다.
- 게임 PC: 포터블
GameVoiceRecorder.exe하나로 디스코드 봇, STT 엔진, 기록 저장소, 설정 화면이 돈다 - 사이트 서버: 디스코드 로그인(서버 멤버만), 게임 PC 연결 확인·잠금 화면, 기록 중계 (기록은 게임 PC 에만 있음)
- 설계·계획:
docs/gemnoki-project-plan.pdf, 개발 구조·인터페이스:docs/dev/ARCHITECTURE.md
진행 현황
| 단계 | 내용 | 상태 |
|---|---|---|
| M0 기술 검증 | DAVE 음성 연결, faster-whisper STT·음량·잡음·사전, 게임 로컬 API 처리, 게임 PC 진단 기능 | ✅ 완료 (결과) |
| M1 녹음 + STT 기본 | 따라가기·명령 참여, TTS 안내, 유저별 녹음, 대기열 STT, /녹음제외·참여 | ⏳ |
| M2 사이트 서버 · 사이트 v1 | 디스코드 로그인, 연결 확인·잠금, 타임라인·따라 읽기·필터·검색·실시간 | ⏳ |
| M3 발로란트 연동 | 경기 감지, 킬·라운드·채팅, 라운드 시간 + 경기 경과 시간, 경기 상세 | ⏳ |
| M4 롤 연동 · 채팅 OCR | 게임 API 이벤트, LCU 결과·타임라인, 채팅 OCR·로그, 롤 경기 상세 | ⏳ |
| M5 exe · 설정 · 모델 | 포터블 exe, 첫 실행 마법사, GPU 감지·모델 다운로드, 암호화 저장, 7일 삭제 | ⏳ |
| M6 단어사전 · UI/UX | 핫워드·교정 사전, 사이트 교정 반영, 테마·애니메이션·효과음 | ⏳ |
| M7 실사용 테스트 | 통합 테스트, 성능·안정화 | ⏳ |
| M8 파인튜닝 | 교정 데이터 + 합성 음성 LoRA 학습, 오류율 비교 후 교체 | ⏳ |
저장소 구조
app/ 게임 PC 앱 (Electron + Node.js 코어, TypeScript)
worker/ STT 워커 (Python, faster-whisper, OCR, 모델 관리, 파인튜닝)
site/server/ 사이트 서버 (Fastify, Discord OAuth2, 기기 중계)
site/web/ 사이트 화면 (React + Vite)
packages/shared/ 앱·사이트 공통 타입
deploy/ 사이트 서버 배포 (.5 Docker, gvr.tkrmagid.kr)
tools/ 사전 생성기 등
docs/ 설명서·계획서, 개발 문서, 브랜드
assets/ 앱·사이트 아이콘·배너
개발
# STT 워커
cd worker && uv venv --python 3.11 .venv && uv pip install --python .venv/bin/python -r requirements-dev.txt
.venv/bin/python -m pytest -q
# 앱 코어 (헤드리스)
cd app && npm install && npm test
npm run core -- --diagnose # 게임 PC 진단 (GPU·STT 속도·Riot API·OCR)
Description