a2487e6241d05dbbaffa1aedb3d12fd4c166aa08
- 확인 요청마다 세대 번호를 붙이고, 새 확인 · 잠금(등록 해제) · 로그아웃 · 새 로그인 뒤에 도착한 이전 응답(성공 · 실패 모두)은 버린다. 보낸 토큰과 지금 토큰이 다르면 역시 버린다 - 로그아웃은 서버 응답을 기다리기 전에 로컬에서 먼저 지우고 잠근다 - 회귀 테스트: 등록 해제 뒤 / 로그아웃 뒤 늦은 200 (이전 코드에서 둘 다 실패 확인) 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~M8):
docs/gemnoki-final-report.pdf· 단계별 테스트 기록:docs/dev/test-results.md - Windows 실행 파일: Gitea 릴리스 v1.0.0 (
GameVoiceRecorder-1.0.0-win-x64.zip권장, 단일 파일GameVoiceRecorder-1.0.0-portable.exe)
로그인 · 관리자 (v1.2.0~)
- exe 는 등록된 디스코드 계정으로 로그인해야 열린다. 로그인 버튼 → 브라우저에서 디스코드 로그인 → 사이트 서버(gvr.tkrmagid.kr)가 등록 명단을 확인한다. 등록되지 않은 아이디면 "등록되지 않은 아이디입니다"와 디스코드 아이디를 보여 주고 앱을 열지 않는다.
- 역할: 최고 관리자(
293719842274541579,1352267557213573160, 서버에 고정) · 관리자 · 유저. 유저 등록 · 역할 변경 · 등록 해제는 최고 관리자만, 등록 명단 보기와 관리자 전용 설정은 관리자도 할 수 있다. - 설정 창 🛡️ 관리자 탭(관리자에게만 보임): 유저 등록(디스코드 아이디 + 역할), 등록 계정 목록(역할 · 마지막 접속 · 앱 버전 · 등록한 사람), 관리자 전용 기능 목록.
- 관리자 전용 (일반 유저 화면에서는 🔒 잠김, 메인 프로세스에서도 막음): 다른 봇으로 바꾸기 · 봇 토큰, 녹음 안내(TTS) 끄기 · 문구, 음성 보관 기간, 사이트 서버 주소 · PC 이름 · 등록/해제, 학습 데이터 삭제, 파인튜닝.
- 앱은 시작할 때와 10분마다 등록 여부를 다시 확인한다. 등록이 해제되면 바로 잠그고 봇 · 녹음 · 사이트 연결을 멈춘다. 사이트 서버에 못 붙으면 마지막 확인 뒤 3일까지는 그대로 쓴다.
- 서버 쪽:
site/server/src/app-auth.ts(/auth/app/*,/app/me,/app/admin/users), 앱 쪽:app/src/core/auth.ts, 권한 목록:app/src/core/roles.ts. 로그인 E2E:app/scripts/login-e2e.mts.
디스코드 봇
- 기본은 겜녹이 봇으로 진행: 로그인하면 사이트 서버가 겜녹이 봇 토큰을 내려주므로(암호화 저장) 토큰을 넣지 않아도 바로 연결된다.
- 다른 봇으로 진행하기(관리자만)를 고르면 직접 만든 봇 토큰을 넣는다 (암호화 저장). v1.0.0 에서 토큰을 넣어 쓰던 설치는 다른 봇 모드로 그대로 이어진다.
- v1.2.0 부터 exe 안에 봇 토큰이 없다 (v1.1.0 은 빌드 때 감춰 넣었다). 등록되지 않은 사람은 exe 를 받아도 겜녹이 봇을 쓸 수 없고, 등록이 해제되면 받아 둔 토큰도 지운다. 빌드에 비밀값이 필요 없어 공개 릴리스에 올려도 된다.
진행 현황
| 단계 | 내용 | 상태 |
|---|---|---|
| M0 기술 검증 | DAVE 음성 연결, faster-whisper STT·음량·잡음·사전, 게임 로컬 API 처리, 게임 PC 진단 기능 | ✅ 완료 (결과) |
| M1 녹음 + STT 기본 | 따라가기·명령 참여, TTS 안내, 유저별 녹음, 대기열 STT, /녹음제외·참여 | ✅ 완료 (실음성 테스트) |
| M2 사이트 서버 · 사이트 v1 | 디스코드 로그인, 연결 확인·잠금, 타임라인·따라 읽기·필터·검색·실시간 | ✅ 완료 · https://gvr.tkrmagid.kr 배포 |
| M3 발로란트 연동 | 경기 감지, 킬·라운드·채팅, 라운드 시간 + 경기 경과 시간, 경기 상세 | ✅ 완료 (전체 스택 테스트) |
| M4 롤 연동 · 채팅 OCR | 게임 API 이벤트, LCU 결과·타임라인, 채팅 OCR·로그, 롤 경기 상세 | ✅ 완료 (Windows 실기 확인: 기록) |
| M5 exe · 설정 · 모델 | 포터블 exe, 첫 실행 마법사, GPU 감지·모델 다운로드, 암호화 저장, 7일 삭제 | ✅ 완료 (Windows 빌드·실행 확인) |
| M6 단어사전 · UI/UX | 핫워드·교정 사전, 사이트 교정 반영, 테마·애니메이션·효과음 | ✅ 완료 (사전 효과) |
| M7 실사용 테스트 | 통합 테스트, 성능·안정화 | ✅ 완료 (GPU 실음성: CER 3.6%, 지연 1.05초 · 기록) |
| M8 파인튜닝 | 교정 데이터 + 합성 음성 LoRA 학습, 오류율 비교 후 교체 | ✅ 완료 (GPU 시험 학습: CER 4.8% → 1.8%) |
저장소 구조
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
# 사이트 (가짜 데이터로 화면 개발: http://127.0.0.1:5173)
cd site/web && npm install && npm run dev
cd site/server && npm install && npm test
deploy/site/deploy.sh # .5 배포 (deploy/README.md)
# 앱 코어 (헤드리스)
cd app && npm install && npm test
npm run core -- --diagnose # 게임 PC 진단 (GPU·STT 속도·Riot API·OCR)
Description