EJClaw 35d2cab792 앱 v1.1.0: 겜녹이 봇 기본 연결 + '다른 봇으로 진행하기'
- 설정 discord.botMode (builtin 기본 / custom). 겜녹이 봇은 토큰 입력 없이 연결
- 겜녹이 봇 토큰은 저장소에 두지 않고 빌드 때 GVR_BUILTIN_BOT_TOKEN 에서 읽어 감춘 값으로 박는다
- 마법사·디스코드 탭에 봇 선택 카드, 다른 봇일 때만 토큰 입력. 오가도 넣은 토큰 유지
- v1.0.0 에서 토큰을 넣어 쓰던 설치는 custom 으로 이어짐
- win-ci full 빌드가 서버 비밀 저장소에서 토큰을 넣고, smoke 에 기본 봇 로그인 결과 기록
- 테스트 6개 추가 (기본·다른 봇·전환·이전 설치·기본 봇 없는 빌드·개발 env)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 04:54:48 +09:00

겜녹이 (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.1.0~)

  • 기본은 겜녹이 봇으로 진행: exe 안에 겜녹이 봇 토큰이 들어 있어 첫 실행 마법사에서 토큰을 넣지 않아도 바로 연결된다.
  • 다른 봇으로 진행하기를 고르면 직접 만든 봇 토큰을 넣는다 (암호화 저장). 설정 창 디스코드 탭에서 언제든 두 방식을 바꿀 수 있고, 넣어 둔 토큰은 바꿔도 지워지지 않는다. v1.0.0 에서 토큰을 넣어 쓰던 설치는 다른 봇 모드로 그대로 이어진다.
  • 토큰은 저장소에 없다. 빌드할 때 GVR_BUILTIN_BOT_TOKEN 환경변수에서 읽어 감춘 값으로 박는다 (app/build.mjs, win-ci 는 tools/win-ci/run.sh full 이 서버 비밀 저장소에서 넣는다). 환경변수 없이 빌드하면 기본 봇이 없는 빌드가 된다.
  • 감춘 것일 뿐 암호화가 아니다. exe 를 풀면 토큰을 꺼낼 수 있으니 기본 봇이 든 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
No description provided
Readme 92 MiB
v1.12.1 Latest
2026-11-21 12:22:47 +09:00
Languages
TypeScript 68.6%
C# 12.6%
Python 7.5%
CSS 4.8%
JavaScript 3.6%
Other 2.9%