EJClaw 9abda88046 M2: 사이트 서버 · 사이트 v1 - gvr.tkrmagid.kr 배포
- site/server: Discord OAuth2 + 봇 토큰 멤버 확인, 세션, 1회용 등록 코드·기기 키 인증, 게임 PC WebSocket 중계(JSON·음성 바이너리), 15초 무응답 잠금, 게임 이미지 캐시, 관리 CLI
- site/web: 타임라인·따라 읽기 재생(단어 강조·이어듣기·현장 모드·재생 게인)·필터·검색·실시간·교정, 발로란트/롤 경기 상세, 잠금 화면(관리자 등록 코드), 모바일, 효과음
- deploy/site: Dockerfile·compose·deploy.sh·make-env.sh (.5, 포트 2972)
- 앱 코어: 사이트 필터 묶음(킬·라운드)과 유저 필터 규칙 맞춤, hello 에 서버 ID

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 01:32:51 +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 기술 검증 DAVE 음성 연결, faster-whisper STT·음량·잡음·사전, 게임 로컬 API 처리, 게임 PC 진단 기능 ✅ 완료 (결과)
M1 녹음 + STT 기본 따라가기·명령 참여, TTS 안내, 유저별 녹음, 대기열 STT, /녹음제외·참여 ✅ 완료 (실음성 테스트)
M2 사이트 서버 · 사이트 v1 디스코드 로그인, 연결 확인·잠금, 타임라인·따라 읽기·필터·검색·실시간 ✅ 완료 · https://gvr.tkrmagid.kr 배포
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

# 사이트 (가짜 데이터로 화면 개발: 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%