diff --git a/README.md b/README.md index 8a148eb..2beb376 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ - 게임 PC: 포터블 `GameVoiceRecorder.exe` 하나로 디스코드 봇, STT 엔진, 기록 저장소, 설정 화면이 돈다 - 사이트 서버: 디스코드 로그인(서버 멤버만), 게임 PC 연결 확인·잠금 화면, 기록 중계 (기록은 게임 PC 에만 있음) - 설계·계획: [`docs/gemnoki-project-plan.pdf`](docs/gemnoki-project-plan.pdf), 개발 구조·인터페이스: [`docs/dev/ARCHITECTURE.md`](docs/dev/ARCHITECTURE.md) -- 범인찾기 · 리플레이 동기화 계획서 v1.1: [`docs/culprit-finder-plan.pdf`](docs/culprit-finder-plan.pdf) · 원본 · 비용 계산 · 프롬프트 초안: `docs/report/culprit/` (실제로 쓰는 프롬프트는 `site/server/prompt/`) +- 범인찾기 · 리플레이 동기화 계획서 v1.2 (결정 반영): [`docs/culprit-finder-plan.pdf`](docs/culprit-finder-plan.pdf) · 원본 · 비용 계산 · 프롬프트 초안: `docs/report/culprit/` (실제로 쓰는 프롬프트는 `site/server/prompt/`) - **제작 완료 보고서 (M0~M8)**: [`docs/gemnoki-final-report.pdf`](docs/gemnoki-final-report.pdf) · 단계별 테스트 기록: [`docs/dev/test-results.md`](docs/dev/test-results.md) - Windows 실행 파일: Gitea 릴리스 [v1.0.0](https://git.tkrmagid.kr/tkrmagid/game_voice_recorder/releases/tag/v1.0.0) (`GameVoiceRecorder-1.0.0-win-x64.zip` 권장, 단일 파일 `GameVoiceRecorder-1.0.0-portable.exe`) diff --git a/app/scripts/culprit-shots.mts b/app/scripts/culprit-shots.mts index 202a082..902298f 100644 --- a/app/scripts/culprit-shots.mts +++ b/app/scripts/culprit-shots.mts @@ -1,6 +1,6 @@ // 범인찾기 화면 확인: 실제 앱 코어(범인찾기 · 기록 DB) + 실제 사이트 서버 + 헤드리스 브라우저. // AI 는 부르지 않는다: CULPRIT_ANSWER(JSON 파일)를 AI 답으로 돌려준다 (없으면 기본 답 생성). -// node --import tsx scripts/culprit-shots.mts [답.json] [스크린샷 폴더] +// [SCALE=2] node --import tsx scripts/culprit-shots.mts [답.json] [스크린샷 폴더] import fs from 'node:fs'; import os from 'node:os'; import path from 'node:path'; @@ -93,8 +93,9 @@ await page.exposeFunction('__csp', (v: string) => csp.push(v)); await page.evaluateOnNewDocument(() => document.addEventListener('securitypolicyviolation', (e) => (window as any).__csp(`${e.violatedDirective} ${e.blockedURI}`))); fs.mkdirSync(shotDir, { recursive: true }); const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms)); +const SCALE = Number(process.env.SCALE || 1); const shot = async (name: string, w = 1440, h = 900, full = false) => { - await page.setViewport({ width: w, height: h }); + await page.setViewport({ width: w, height: h, deviceScaleFactor: SCALE }); await sleep(600); await page.screenshot({ path: path.join(shotDir, name), fullPage: full }); console.log('screenshot', name); diff --git a/docs/culprit-finder-plan.pdf b/docs/culprit-finder-plan.pdf index 3b6d719..1107582 100644 Binary files a/docs/culprit-finder-plan.pdf and b/docs/culprit-finder-plan.pdf differ diff --git a/docs/report/culprit/build.py b/docs/report/culprit/build.py index 9eb8c2e..d561d28 100644 --- a/docs/report/culprit/build.py +++ b/docs/report/culprit/build.py @@ -6,8 +6,8 @@ STYLE = src[src.index('')] B = d['base']; PM = d['per_model']; SC = d['scenarios']; MED = d['opus_medium'] import re as _re -def _load(f): return html.escape(_re.sub(r'\n?', '', open('prompt/' + f).read(), flags=_re.S).strip()) -FIX = {'valorant': 3900, 'lol': 5000} +def _load(f): return html.escape(_re.sub(r'\n?', '', open('../../../site/server/prompt/' + f).read(), flags=_re.S).strip()) +FIX = {'valorant': 6649, 'lol': 8204} # 토큰 세기 API 실측 (v1.2) def usd(x, n=2): return f"${x:.{n}f}" def k(x): return f"{x/1000:.1f}k" if x >= 1000 else f"{x:.0f}" @@ -61,7 +61,7 @@ opus = PM['opus-5.5'] days = 31 per_day = opus['p50'] / days -HTML = f'''
| 프로젝트 | 겜녹이 (Game Voice Recorder) · v1.2.2 다음 기능 |
| 문서 | 계획서 v1.1 · 코드 작성 전 검토용 (v1.0 + 리플레이 동기화 · 프롬프트 · 지식 묶음) |
| 문서 | 계획서 v1.2 · 정해 주신 8가지 반영 (v1.1 + 결정 사항 · 실제 화면 · 토큰 실측) |
| 진행 | 범인찾기 C1~C3(앱 · 사이트 서버 · 화면) 구현 완료, 배포 전 · 리플레이 동기화는 API 확인 뒤 결정 |
| 작성일 | 2026-10-15 |
| AI | Claude API (Anthropic) · 기본 모델 Claude Opus 5.5 |
| 예산 | API 크레딧 $100 (2026-11-15 만료) |








| 보는 것 | 발로란트 | 리그 오브 레전드 | |
|---|---|---|---|
| 플레이 | 첫 킬 · 첫 데스, 전투 점수(ACS), 라운드당 피해량, 클러치, 스파이크 설치 · 해체, 연속 데스 | 포지션별 기준: 라인 CS · 골드 차, 킬 관여율, 딜량 · 받은 피해, 데스 시점(오브젝트 직전 등) | |
| 기록 | 지금 저장하는 것 | 범인찾기를 위해 더 저장할 것 |
|---|---|---|
| 기록 | 원래 저장하던 것 | 범인찾기를 위해 더 저장 (구현 완료) |
| 음성 대화 | 유저별 문장, 시각, 경기 · 라운드 연결 (텍스트는 계속 남음) | 없음. 음성 파일은 7일 뒤 지워져도 분석은 텍스트로 함 |
| 발로란트 경기 | 10명 KDA · 전투 점수 · 랭크, 라운드 결과, 라운드별 경제(쓴 돈 · 무기), 킬(무기 · 헤드샷 · 위치) | 라운드별 피해량, 스파이크 설치 · 해체한 사람, 스킬 사용 횟수 (Riot 경기 결과에 이미 있음, 지금은 버림) |
| 롤 경기 | 10명 KDA · CS · 골드 · 아이템, 골드 차 그래프, 킬 · 오브젝트 이벤트 | 포지션, 딜량 · 받은 피해, 시야 점수 · 와드, 분당 골드 · CS (LCU 경기 기록에 이미 있음, 지금은 버림) |
| 발로란트 경기 | 10명 KDA · 전투 점수 · 랭크, 라운드 결과, 라운드별 경제(쓴 돈 · 무기), 킬(무기 · 헤드샷 · 위치) | 선수별 준 피해 · 헤드샷 비율 · 첫킬/첫데스 · 설치/해체 · 스킬 사용 · 요원 역할, 라운드별 공격/수비 · 장비 값 · 선수별 킬/피해 |
| 롤 경기 | 10명 KDA · CS · 골드 · 아이템, 골드 차 그래프, 킬 · 오브젝트 이벤트 | 포지션(추정), 챔피언 피해 · 받은 피해, 시야 점수 · 와드 설치/제거/제어 와드, 오브젝트 · 포탑 피해, CC 시간, 10분 · 15분 CS · 골드 |
| 채팅 | 팀 · 전체 채팅 (API · OCR) | 없음 |
| 디스코드 ↔ 게임 계정 | Riot ID로 누가 누구인지 연결 | 연결 안 된 화자는 디스코드 이름으로 보내고 “게임 계정 모름”으로 표시 |
ANTHROPIC_API_KEY, root만 읽기). 봇 토큰과 같은 원칙으로, exe에도 브라우저에도 가지 않습니다. 게임 PC가 직접 부르게 하면 키가 PC에 남아 꺼낼 수 있어서 쓰지 않습니다.culprit_analyses). 기록은 게임 PC에만 둔다는 지금 원칙을 지킵니다. 서버에는 비용 장부만 남깁니다(경기 번호 · 누른 사람 · 토큰 수 · 비용 · 시각, 대화 내용 없음).# 경기 발로란트 경쟁전 · 어센트 · 11:13 (우리 팀 패배) · 24라운드 · 44분 -# 참가자 (번호 · 이름 · 팀 · 요원 · K/D/A · ACS · 라운드당 피해 · 첫킬/첫데스 · 음성) -P1 승한 우리 제트 24/15/5 272 168 8/3 음성O -P4 현우 우리 오멘 14/19/6 171 121 2/7 음성O -P9 Kiwi 상대 스카이 9/18/7 132 88 1/4 음성X -# R21 우리 공격 · 경제 우리 3,900 / 상대 4,300 · 결과 패배(전멸) 11:10 -[e512] 0:29 킬 Nox(P7) → 현우(P4) 고스트 · 첫 데스 -[u3301] 0:22 승한: 현우야 같이 가 기다려 둘 있어 -[u3302] 0:25 현우: 아 그냥 간다 내가 뚫을게 -[c41] 1:12 전체채팅 Kiwi: ff 그냥-
[u…] = 대화 문장, [e…] = 게임 이벤트, [c…] = 채팅 번호. AI는 근거를 이 번호로 답하고, 서버가 번호를 확인합니다. 숫자 덩어리(JSON)가 아니라 이런 줄글로 보내 토큰을 아낍니다.
+# 경기 발로란트 경쟁전 · 어센트 · 13:9 (우리 팀 승리) · 22라운드 · 46분 +# 참가자 (번호 이름 팀 요원(역할) K/D/A ACS 라운드당피해 첫킬/첫데스 헤드샷 설치/해체 스킬사용 음성) +P1 승한 우리 제트(타격대) 19/12/7 ACS244 ADR148 첫킬1/첫데스2 HS15% 설치0/해체0 랭크:플래티넘 1 음성O +P5 Duck 우리 킬조이(감시자) 12/15/8 ACS194 ADR92 첫킬2/첫데스2 HS16% 설치0/해체1 랭크:골드 3 음성X +[e1] R1 0:08 킬 P2 → P6 (클래식) +[u1] R3 0:05 P1: 현우야 같이 가 기다려 둘 있어 +[u2] R3 0:09 P2: 아 그냥 간다 내가 뚫을게 +[r3] R3 우리 공격 라운드 끝 · 패배(전멸) 2:1 · 평균 장비 우리 3,714 / 상대 3,582 · 선수 장비/피해: P1 2.4k/185 P2 4.3k/0 … +[u3] R5 0:02 도윤(게임 계정 모름): 나 돈 없어 세이브할게+
앱이 실제로 만드는 모양입니다(시연 경기). [u…] = 대화 문장, [e…] = 게임 이벤트, [c…] = 채팅, [r…] = 라운드 요약, [s:P…] = 그 사람 경기 전체 스탯 번호. AI는 근거를 이 번호로 답하고, 서버가 번호를 확인합니다. 숫자 덩어리(JSON)가 아니라 이런 줄글로 보내 토큰을 아낍니다.
| 파일 (미리 써 둠) | 내용 | 토큰(추정) |
|---|---|---|
prompt/system.md 지시문 | 역할 · 할 일 · 판단 원칙 · 태그 · 말투(순한맛/중간맛/매운맛) · 출력 규칙 | 약 1,600 |
prompt/knowledge-valorant.md | 규칙 · 경제 · 역할별 기준 · 지표 기준 · 콜아웃 · 은어 · 음성 인식 오류 + 자동 갱신(요원 29명 역할 · 맵 13개 · 무기 가격) | 약 1,600 |
prompt/knowledge-lol.md | 기본 규칙 · 포지션별 기준 · 지표 기준 · 은어 · 음성 인식 오류 + 자동 갱신(챔피언 173명 분류) | 약 2,700 |
prompt/output-schema.json | 결과 JSON 형식: 요약 · 확신도 · 팀별 범인 · 10명 평가 · 근거 번호 | 약 700 |
| 파일 | 내용 | |
prompt/system.md 지시문 v1.1 | 역할 · 할 일 · 범인 기준(종합 판단) · 판단 원칙 · 태그 · 말투(중간맛) · 자료 약어 설명 · 출력 규칙 | |
prompt/knowledge-valorant.md | 규칙 · 경제 · 역할별 기준 · 지표 기준 · 콜아웃 · 은어 · 음성 인식 오류 + 자동 갱신(요원 29명 역할 · 맵 13개 · 무기 가격) | |
prompt/knowledge-lol.md | 기본 규칙 · 포지션별 기준 · 지표 기준 · 은어 · 음성 인식 오류 + 자동 갱신(챔피언 173명 분류) | |
prompt/output-schema.json | 결과 JSON 형식: 요약 · 확신도 · 팀별 범인 · 10명 평가 · 근거 번호 |
파일은 docs/report/culprit/prompt/에 있고 전문은 부록에 있습니다. 구현할 때 사이트 서버로 옮깁니다. 토큰 수는 글자 수로 넉넉하게 잡은 값이고, 구현 때 토큰 세기 API(무료)로 다시 잽니다.
파일은 site/server/prompt/에 있고(사이트 서버가 그대로 읽음) 전문은 부록에 있습니다. 토큰 세기 API(claude-opus-5-5)로 잰 고정 부분(지시문 + 지식 묶음 + 출력 형식)은 발로란트 {FIX['valorant']:,} · 롤 {FIX['lol']:,}토큰입니다. v1.1에서 글자 수로 잡은 3,900 · 5,000보다 많아서 7장 비용을 다시 계산했습니다(경기당 약 +$0.017).
tools/gen-dictionary.mjs)라 같이 갱신| 부분 | 토큰 | 비용 | 설명 |
|---|---|---|---|
| 지시문 · 지식 묶음 · 출력 형식 | 약 {(FIX['valorant']+FIX['lol'])//2:,} | {usd((FIX['valorant']+FIX['lol'])/2*4/1e6,3)} | 6장 파일 실측. 발로 {FIX['valorant']:,} · 롤 {FIX['lol']:,} |
| 경기 기록 (10명 · 라운드 · 이벤트) | 약 6,100 | $0.025 | 발로 약 8,100 · 롤 약 4,200 |
| 지시문 · 지식 묶음 · 출력 형식 | 약 {(FIX['valorant']+FIX['lol'])//2:,} | {usd((FIX['valorant']+FIX['lol'])/2*4/1e6,3)} | 토큰 세기 API 실측. 발로 {FIX['valorant']:,} · 롤 {FIX['lol']:,} |
| 경기 기록 (10명 · 라운드 · 이벤트) | 약 6,100 | $0.025 | 가정: 발로 약 8,100 · 롤 약 4,200. 시연 경기 실측: 발로 22라운드 약 9,400 · 롤 28분 약 1,900 |
| 음성 대화 | 약 {B['lines']['mean']*24:,.0f} | {usd(B['lines']['mean']*24*4/1e6,3)} | 평균 {B['lines']['mean']:.0f}문장 × 24토큰. 가장 크게 흔들리는 값 |
| 채팅 | 약 250 | $0.001 | |
| AI 답 (10명 평가 · 범인 · 근거) | 약 3,300 | $0.066 | JSON |
| 리그 오브 레전드 | 발로란트 | |
|---|---|---|
| 리플레이 | 클라이언트 “경기 기록”에서 내려받아 재생 (.rofl 파일, 같은 패치 안에서만) | 2025년 9월(패치 11.06)에 생김. 패치 12.10부터 경쟁전 · 일반전 · 신속플레이 · 프리미어 · 사용자 지정 게임, 친구 경기도 경력 탭에서 볼 수 있음. 내전(사용자 지정)은 방장이 경기마다 시작 전에 사용자 지정 옵션에서 녹화를 켜야 리플레이가 남음. 보관 기간은 짧고(액트 단위로 안내됨) 바뀔 수 있어 R0에서 확인 |
| 리플레이 감지 | 계획: 롤 클라이언트(LCU) 상태가 “리플레이 보는 중”인지 + 게임 프로그램이 연 리플레이 파일 이름(지역-경기번호.rofl)으로 어느 경기인지 찾음. 이 두 가지는 공식 문서에 없는 방법이라 R0에서 검증. 안 되면 경기 시간 길이 · 챔피언 구성으로 후보를 좁히고 사용자가 고름 | 공식 방법 없음. Riot 로컬 클라이언트 상태로 리플레이 화면인지 확인을 시도하고, 안 되면 화면 글자 인식(OCR)으로 판단. 어느 경기인지는 맵 · 최종 점수 · 날짜로 기록과 맞춤. 여러 경기가 맞으면 팝업에 후보를 보여 주고 사용자가 고름(잘못 연결 방지) |
| 재생 시간 읽기 | Riot 공식 Replay API(이 PC 안 127.0.0.1:2999/replay/playback): 재생 시간 · 멈춤 · 배속을 0.25초마다 읽음 | 시간을 알려 주는 API 없음 → 지금 있는 채팅 OCR 기능으로 화면 위쪽 라운드 번호 · 라운드 타이머를 1초에 2~4번 읽고, 우리 기록의 라운드 시작 시각과 합쳐 위치를 계산. 타이머가 멈추면 멈춤, 빨리 줄면 배속 |
| exe → 리플레이 | 됨: 동기화 창에서 줄을 누르면 리플레이를 그 시간으로 옮김(같은 API) | 안 됨(한쪽 동기화). 리플레이에서 직접 옮기면 exe가 따라감 |
| 정확도 목표 | ±0.5초 | ±1초 (구매 시간 · 라운드 사이처럼 타이머가 안 보이는 순간은 직전 값으로 추정) |
| 준비 | 롤 설정 파일(game.cfg)에 EnableReplayApi=1 한 줄 필요(Riot 공식 문서 방법). 앱이 처음 한 번 동의를 받고 넣어 줌(게임이 꺼져 있을 때) | 게임을 테두리 없는 창 모드로 둬야 OCR · 팝업이 잘 됨 |
| 확실도 | 재생 시간 읽기 · 옮기기는 Riot 공식 문서에 있는 API. 리플레이 감지와 경기 식별은 R0 검증 대상이고, 안 되면 후보 고르기로 대신 | 먼저 기술 검증(R0) 필요. 리플레이 화면 구성이 OCR로 읽히는지, 감지 방법이 있는지 Windows 실기로 확인한 뒤 확정 |
| 리플레이 | 클라이언트 “경기 기록”에서 내려받아 재생 (.rofl 파일, 같은 패치 안에서만) | 패치 12.10부터 경쟁전 · 일반전 · 신속플레이 · 프리미어 · 사용자 지정 게임, 친구 경기도 경력 탭에서 볼 수 있음. 내전(사용자 지정)은 방장이 경기마다 시작 전에 녹화를 켜야 리플레이가 남음 |
| 확인할 API | ① 롤 클라이언트 로컬 API(LCU, 비공식): 리플레이 보는 중인지, 어느 경기(경기 번호)인지 ② 게임 로컬 API(이 PC 안 127.0.0.1:2999): 설정을 바꾸지 않은 상태에서 리플레이 중에 게임 시간이 나오는지③ 공식 Replay API( /replay/playback): 재생 시간 · 멈춤 · 배속 · 옮기기. game.cfg 에 한 줄을 넣어야 켜지므로 앱이 켜지 않음. 이미 켜져 있는 PC에서만 씀 | ① Riot 클라이언트 로컬 API(비공식, 지금 경기 감지에 쓰는 상태 정보): 리플레이 보는 중인지, 어느 경기인지 ② 같은 API에서 리플레이 재생 시간이나 라운드가 나오는지 |
| 되면 | 시간을 0.25초마다 읽어 동기화(목표 오차 ±0.5초). ③이 켜져 있으면 줄을 눌러 리플레이도 옮김 | 시간을 읽어 동기화. 정확도는 API가 주는 값의 간격에 따라 R0에서 정함 |
| 안 되면 | 그 게임은 리플레이 동기화를 넣지 않습니다. 화면 글자 인식(OCR) · 수동 맞춤 · 설정 파일 고치기로 대신하지 않습니다. | |
| 확인 방법 | 새 exe에 “리플레이 API 확인” 기능을 넣어, 리플레이를 1판씩 틀고 버튼을 누르면 위 API들이 리플레이 중에 무엇을 주는지 기록 파일로 남깁니다. 그 기록으로 게임별로 만들지 정합니다. | |
| 단계 | 할 일 | 확인 방법 | |
|---|---|---|---|
| C1 기록 보강 | 경기 상세를 받을 때 피해량 · 시야 · 포지션 등 추가 지표 저장. “분석 가능” 판정. 분석 자료(압축 텍스트) 만드는 앱 API | 저장된 22라운드 · 롤 경기 테스트 자료로 판정 · 자료 모양 테스트. 녹음 공백 · 변환 대기 경기가 막히는지 | |
| C2 서버 분석 | Claude 호출, JSON 형식 고정, 근거 번호 확인, 예산 장부 · 하루 횟수 · 중복 방지, 결과를 게임 PC에 저장 | 가짜 AI 응답으로 테스트(없는 근거 번호 · 9명만 온 응답 · 예산 초과 · 동시 클릭). 실제 Claude 1회 호출로 비용 기록 확인 | |
| C3 화면 | 범인찾기 탭, 진행 단계, 결과 화면(PC · 휴대폰), 근거 → 타임라인 · 듣기, 경기 화면 버튼 | 사이트 화면 캡처로 확인, 보안 정책(CSP) 켠 상태에서 동작 | |
| C4 실측 · 조정 | 실제 경기 3~5개 분석, 결과 품질과 실제 비용 확인, 지시문 · 지식 묶음 · 생각 깊이 조정, 7장 표 갱신 | 사용자와 같이 결과 검토 (범인 판정이 납득되는지) | |
| C5 배포 | 사이트 서버 배포(API 키 넣기), 앱 새 버전 exe 빌드 | 배포 전 백업, 배포 뒤 상태 확인 · 실제 분석 1회 | |
| R0 리플레이 기술 검증 | Windows 실기: 롤 Replay API 켜기 · 시간 읽기 · 옮기기, LCU 상태 · 리플레이 파일 이름으로 경기 찾기 / 발로란트 리플레이 감지 방법, 라운드 · 타이머 OCR 정확도, 내전 녹화 옵션을 켠 경기의 리플레이 확인 | 롤 리플레이 1판, 발로란트 리플레이 1판으로 10분 재생해 오차 측정. 결과로 발로란트 방식 확정 | |
| R1 감지 · 팝업 | 리플레이 감지, 경기 찾기(못 찾거나 여러 개면 후보 고르기), 남은 기록 확인, 팝업 · 단축키 · Windows 알림, “다시 묻지 않기” | 가짜 Replay API · 녹화한 화면으로 자동 테스트, 실기에서 팝업 확인 | |
| R2 동기화 창 (롤) | exe 새 창: 시간 따라가기, 단어 짚기, 음성 재생 · 멈춤 · 배속, 줄 누르면 리플레이 이동, ±0.5초 조정, 범인 근거 표시 | 실제 롤 리플레이로 멈춤 · 배속 · 되감기 따라가는지, 오차 ±0.5초 | |
| R3 동기화 (발로란트) | R0 결과대로 OCR 동기화. 안 되는 부분은 수동 맞춤(라운드 고르고 시작)으로 대신 | 실제 발로란트 리플레이로 오차 ±1초 | |
| 단계 | 할 일 | 확인 방법 | 상태 |
| C1 기록 보강 | 경기 상세에서 추가 지표 저장(4장). “분석 가능” 판정(경기 결과 · 녹음 공백 1분 · 음성 변환). 근거 번호가 달린 분석 자료 만들기, 결과 저장. 녹음 안내 문구에 AI 분석 안내 | 시연 22라운드 · 롤 경기로 판정 · 자료 모양 자동 테스트. 녹음 늦게 시작 · 변환 대기 · 녹음 제외 경기가 막히는지 | 완료 |
| C2 서버 분석 | Claude 호출(구조화 출력), 근거 번호 확인, 예산 장부 · 하루 횟수 · 중복 방지, 결과를 게임 PC에 저장 | 가짜 AI 응답 자동 테스트(없는 근거 · 빠진 사람 · 예산 초과 · 동시 클릭 · 거절). 실제 Claude 1회 호출 성공 | 완료 |
| C3 화면 | 범인찾기 탭, 진행 단계, 결과 화면(PC · 휴대폰), 근거 → 듣기 · 타임라인, 경기 화면 버튼 | 실제 앱 코어 + 사이트 서버 + 브라우저로 화면 캡처(2장), 보안 정책(CSP) 위반 · 오류 없음 | 완료 |
| C5 배포 | 사이트 서버 배포(API 키 넣기), 앱 새 버전(v1.3.0) exe 빌드 · 릴리스 | 배포 전 백업, 배포 뒤 상태 확인 · 실제 분석 1회 | 승인 대기 |
| C4 실측 · 조정 | 새 exe로 실제 경기 3~5판 분석, 결과 품질과 실제 비용 확인, 지시문 · 지식 묶음 · 생각 깊이 조정, 7장 표 갱신 | 같이 결과 검토 (범인 판정이 납득되는지) | 배포 뒤 |
| R0 리플레이 API 확인 | 새 exe의 “리플레이 API 확인” 기능으로 롤 · 발로란트 리플레이 중 API가 주는 값 기록(8장) | 롤 리플레이 1판, 발로란트 리플레이 1판 | 배포 뒤 |
| R1~R3 리플레이 동기화 | R0에서 API로 시간을 읽을 수 있는 게임만: 감지 · 팝업, 동기화 창(시간 따라가기 · 음성 · 범인 근거 표시) | 가짜 API로 자동 테스트, 실제 리플레이로 멈춤 · 배속 · 되감기 따라가는지 | R0 결과에 따라 |
범인찾기(C1~C5)와 리플레이 동기화(R0~R3)는 따로 진행할 수 있습니다. R0은 실제 게임 리플레이가 있는 Windows PC에서 해야 해서, 승한님 PC에서 리플레이를 한 번 틀어 주셔야 할 수 있습니다.
-앱(게임 PC)도 바뀌므로(추가 지표 저장, 분석 자료 API, 결과 저장) 새 exe가 필요합니다. 예전 exe로도 사이트는 열리지만 범인찾기는 “앱을 업데이트해 주세요”로 막습니다.
+예전 exe로도 사이트는 열리지만 범인찾기는 “게임 PC 앱을 업데이트해 주세요”로 막습니다. 코드: 앱 app/src/core/culprit.ts, 서버 site/server/src/culprit.ts, 화면 site/web/src/pages/CulpritPage.tsx.
EnableReplayApi=1 한 줄이 있어야 리플레이 시간을 읽습니다. → 추천: 앱이 처음 한 번 동의를 받고 자동으로 넣기. 직접 넣으시려면 안내만 띄웁니다.| 질문 | 답 (2026-10-15) | 반영 |
|---|---|---|
| ① "범인"의 뜻 | 가장 못했다 + 가장 발목을 잡았다 + 패배의 원인 등 모두 종합 | 지시문 v1.1에 세 기준을 종합하도록 넣음. 팀마다 1명, 팀 최저점(서버 확인) |
| ② 분석 버튼 | (가) 등록된 앱 유저 이상 | 서버가 앱 유저 명단으로 확인. 다시 분석은 관리자 이상, 결과 보기는 모두 |
| ③ 모델 | Opus 5.5 | Claude Opus 5.5 · 생각 깊이 high |
| ④ API 키 | 받음 | 동작 확인. 서버 비밀 저장소에만 보관, 배포 때 사이트 서버 환경 변수로만 넣음 |
| ⑤ 말투 | (나) 중간맛 | 기본 말투 medium |
| ⑥ 멤버 공지 | TTS 문구에 추가 | 녹음 안내 문구 · 기본 음성 교체 (5장) |
| ⑦ 발로란트 리플레이 | 비공식 API에 없으면 추가하지 않기 | OCR 안 함. R0에서 API 확인 뒤 결정 (8장) |
| ⑧ 롤 리플레이 | 비공식 API에 없으면 추가하지 않기 | 앱이 game.cfg 를 고치지 않음. R0에서 API 확인 뒤 결정 (8장) |
2026-10-15 초안. 구현 · 시험 경기(6장)를 거치며 고칩니다. 지시문의 tone 자리는 말투 설정으로 바뀝니다. 자동 갱신 칸은 패치마다 다시 만듭니다.
+사이트 서버가 실제로 쓰는 원문(site/server/prompt/, 지시문 v1.1). 실제 경기 분석(C4)과 시험 경기(6장)를 거치며 고칩니다. 지시문의 tone 자리는 말투 설정(중간맛)으로 바뀌고, 자동 갱신 칸은 사이트 서버가 하루에 한 번 공식 데이터로 다시 만듭니다.
prompt/system.md{_load('system.md')}
prompt/knowledge-valorant.md| 프로젝트 | 겜녹이 (Game Voice Recorder) · v1.2.2 다음 기능 |
| 문서 | 계획서 v1.1 · 코드 작성 전 검토용 (v1.0 + 리플레이 동기화 · 프롬프트 · 지식 묶음) |
| 문서 | 계획서 v1.2 · 정해 주신 8가지 반영 (v1.1 + 결정 사항 · 실제 화면 · 토큰 실측) |
| 진행 | 범인찾기 C1~C3(앱 · 사이트 서버 · 화면) 구현 완료, 배포 전 · 리플레이 동기화는 API 확인 뒤 결정 |
| 작성일 | 2026-10-15 |
| AI | Claude API (Anthropic) · 기본 모델 Claude Opus 5.5 |
| 예산 | API 크레딧 $100 (2026-11-15 만료) |








| 보는 것 | 발로란트 | 리그 오브 레전드 |
|---|---|---|
| 플레이 | 첫 킬 · 첫 데스, 전투 점수(ACS), 라운드당 피해량, 클러치, 스파이크 설치 · 해체, 연속 데스 | 포지션별 기준: 라인 CS · 골드 차, 킬 관여율, 딜량 · 받은 피해, 데스 시점(오브젝트 직전 등) |
| 기록 | 지금 저장하는 것 | 범인찾기를 위해 더 저장할 것 |
|---|---|---|
| 기록 | 원래 저장하던 것 | 범인찾기를 위해 더 저장 (구현 완료) |
| 음성 대화 | 유저별 문장, 시각, 경기 · 라운드 연결 (텍스트는 계속 남음) | 없음. 음성 파일은 7일 뒤 지워져도 분석은 텍스트로 함 |
| 발로란트 경기 | 10명 KDA · 전투 점수 · 랭크, 라운드 결과, 라운드별 경제(쓴 돈 · 무기), 킬(무기 · 헤드샷 · 위치) | 라운드별 피해량, 스파이크 설치 · 해체한 사람, 스킬 사용 횟수 (Riot 경기 결과에 이미 있음, 지금은 버림) |
| 롤 경기 | 10명 KDA · CS · 골드 · 아이템, 골드 차 그래프, 킬 · 오브젝트 이벤트 | 포지션, 딜량 · 받은 피해, 시야 점수 · 와드, 분당 골드 · CS (LCU 경기 기록에 이미 있음, 지금은 버림) |
| 발로란트 경기 | 10명 KDA · 전투 점수 · 랭크, 라운드 결과, 라운드별 경제(쓴 돈 · 무기), 킬(무기 · 헤드샷 · 위치) | 선수별 준 피해 · 헤드샷 비율 · 첫킬/첫데스 · 설치/해체 · 스킬 사용 · 요원 역할, 라운드별 공격/수비 · 장비 값 · 선수별 킬/피해 |
| 롤 경기 | 10명 KDA · CS · 골드 · 아이템, 골드 차 그래프, 킬 · 오브젝트 이벤트 | 포지션(추정), 챔피언 피해 · 받은 피해, 시야 점수 · 와드 설치/제거/제어 와드, 오브젝트 · 포탑 피해, CC 시간, 10분 · 15분 CS · 골드 |
| 채팅 | 팀 · 전체 채팅 (API · OCR) | 없음 |
| 디스코드 ↔ 게임 계정 | Riot ID로 누가 누구인지 연결 | 연결 안 된 화자는 디스코드 이름으로 보내고 “게임 계정 모름”으로 표시 |
ANTHROPIC_API_KEY, root만 읽기). 봇 토큰과 같은 원칙으로, exe에도 브라우저에도 가지 않습니다. 게임 PC가 직접 부르게 하면 키가 PC에 남아 꺼낼 수 있어서 쓰지 않습니다.culprit_analyses). 기록은 게임 PC에만 둔다는 지금 원칙을 지킵니다. 서버에는 비용 장부만 남깁니다(경기 번호 · 누른 사람 · 토큰 수 · 비용 · 시각, 대화 내용 없음).# 경기 발로란트 경쟁전 · 어센트 · 11:13 (우리 팀 패배) · 24라운드 · 44분 -# 참가자 (번호 · 이름 · 팀 · 요원 · K/D/A · ACS · 라운드당 피해 · 첫킬/첫데스 · 음성) -P1 승한 우리 제트 24/15/5 272 168 8/3 음성O -P4 현우 우리 오멘 14/19/6 171 121 2/7 음성O -P9 Kiwi 상대 스카이 9/18/7 132 88 1/4 음성X -# R21 우리 공격 · 경제 우리 3,900 / 상대 4,300 · 결과 패배(전멸) 11:10 -[e512] 0:29 킬 Nox(P7) → 현우(P4) 고스트 · 첫 데스 -[u3301] 0:22 승한: 현우야 같이 가 기다려 둘 있어 -[u3302] 0:25 현우: 아 그냥 간다 내가 뚫을게 -[c41] 1:12 전체채팅 Kiwi: ff 그냥-
[u…] = 대화 문장, [e…] = 게임 이벤트, [c…] = 채팅 번호. AI는 근거를 이 번호로 답하고, 서버가 번호를 확인합니다. 숫자 덩어리(JSON)가 아니라 이런 줄글로 보내 토큰을 아낍니다.
+# 경기 발로란트 경쟁전 · 어센트 · 13:9 (우리 팀 승리) · 22라운드 · 46분 +# 참가자 (번호 이름 팀 요원(역할) K/D/A ACS 라운드당피해 첫킬/첫데스 헤드샷 설치/해체 스킬사용 음성) +P1 승한 우리 제트(타격대) 19/12/7 ACS244 ADR148 첫킬1/첫데스2 HS15% 설치0/해체0 랭크:플래티넘 1 음성O +P5 Duck 우리 킬조이(감시자) 12/15/8 ACS194 ADR92 첫킬2/첫데스2 HS16% 설치0/해체1 랭크:골드 3 음성X +[e1] R1 0:08 킬 P2 → P6 (클래식) +[u1] R3 0:05 P1: 현우야 같이 가 기다려 둘 있어 +[u2] R3 0:09 P2: 아 그냥 간다 내가 뚫을게 +[r3] R3 우리 공격 라운드 끝 · 패배(전멸) 2:1 · 평균 장비 우리 3,714 / 상대 3,582 · 선수 장비/피해: P1 2.4k/185 P2 4.3k/0 … +[u3] R5 0:02 도윤(게임 계정 모름): 나 돈 없어 세이브할게+
앱이 실제로 만드는 모양입니다(시연 경기). [u…] = 대화 문장, [e…] = 게임 이벤트, [c…] = 채팅, [r…] = 라운드 요약, [s:P…] = 그 사람 경기 전체 스탯 번호. AI는 근거를 이 번호로 답하고, 서버가 번호를 확인합니다. 숫자 덩어리(JSON)가 아니라 이런 줄글로 보내 토큰을 아낍니다.
| 파일 (미리 써 둠) | 내용 | 토큰(추정) |
|---|---|---|
prompt/system.md 지시문 | 역할 · 할 일 · 판단 원칙 · 태그 · 말투(순한맛/중간맛/매운맛) · 출력 규칙 | 약 1,600 |
prompt/knowledge-valorant.md | 규칙 · 경제 · 역할별 기준 · 지표 기준 · 콜아웃 · 은어 · 음성 인식 오류 + 자동 갱신(요원 29명 역할 · 맵 13개 · 무기 가격) | 약 1,600 |
prompt/knowledge-lol.md | 기본 규칙 · 포지션별 기준 · 지표 기준 · 은어 · 음성 인식 오류 + 자동 갱신(챔피언 173명 분류) | 약 2,700 |
prompt/output-schema.json | 결과 JSON 형식: 요약 · 확신도 · 팀별 범인 · 10명 평가 · 근거 번호 | 약 700 |
| 파일 | 내용 | |
prompt/system.md 지시문 v1.1 | 역할 · 할 일 · 범인 기준(종합 판단) · 판단 원칙 · 태그 · 말투(중간맛) · 자료 약어 설명 · 출력 규칙 | |
prompt/knowledge-valorant.md | 규칙 · 경제 · 역할별 기준 · 지표 기준 · 콜아웃 · 은어 · 음성 인식 오류 + 자동 갱신(요원 29명 역할 · 맵 13개 · 무기 가격) | |
prompt/knowledge-lol.md | 기본 규칙 · 포지션별 기준 · 지표 기준 · 은어 · 음성 인식 오류 + 자동 갱신(챔피언 173명 분류) | |
prompt/output-schema.json | 결과 JSON 형식: 요약 · 확신도 · 팀별 범인 · 10명 평가 · 근거 번호 |
파일은 docs/report/culprit/prompt/에 있고 전문은 부록에 있습니다. 구현할 때 사이트 서버로 옮깁니다. 토큰 수는 글자 수로 넉넉하게 잡은 값이고, 구현 때 토큰 세기 API(무료)로 다시 잽니다.
파일은 site/server/prompt/에 있고(사이트 서버가 그대로 읽음) 전문은 부록에 있습니다. 토큰 세기 API(claude-opus-5-5)로 잰 고정 부분(지시문 + 지식 묶음 + 출력 형식)은 발로란트 6,649 · 롤 8,204토큰입니다. v1.1에서 글자 수로 잡은 3,900 · 5,000보다 많아서 7장 비용을 다시 계산했습니다(경기당 약 +$0.017).
tools/gen-dictionary.mjs)라 같이 갱신이 값으로 2만 경기의 비용을 계산하고, $100을 다 쓸 때까지 분석하는 시행을 1,500번 돌렸습니다. 실패 · 다시 분석 여유로 5%를 더 잡았습니다. 계산 코드: docs/report/culprit/cost_sim.py
| 부분 | 토큰 | 비용 | 설명 |
|---|---|---|---|
| 지시문 · 지식 묶음 · 출력 형식 | 약 4,450 | $0.018 | 6장 파일 실측. 발로 3,900 · 롤 5,000 |
| 경기 기록 (10명 · 라운드 · 이벤트) | 약 6,100 | $0.025 | 발로 약 8,100 · 롤 약 4,200 |
| 지시문 · 지식 묶음 · 출력 형식 | 약 7,426 | $0.030 | 토큰 세기 API 실측. 발로 6,649 · 롤 8,204 |
| 경기 기록 (10명 · 라운드 · 이벤트) | 약 6,100 | $0.025 | 가정: 발로 약 8,100 · 롤 약 4,200. 시연 경기 실측: 발로 22라운드 약 9,400 · 롤 28분 약 1,900 |
| 음성 대화 | 약 15,234 | $0.061 | 평균 635문장 × 24토큰. 가장 크게 흔들리는 값 |
| 채팅 | 약 250 | $0.001 | |
| AI 답 (10명 평가 · 범인 · 근거) | 약 3,300 | $0.066 | JSON |
| AI 생각 | 약 10,717 | $0.214 | 출력 값으로 계산. 비용의 절반 이상 |
| 합계 | 입력 26,077 · 출력 13,997 | $0.384 | 발로 $0.40 · 롤 $0.37 |
| AI 생각 | 약 10,969 | $0.219 | 출력 값으로 계산. 비용의 절반 이상 |
| 합계 | 입력 29,053 · 출력 14,249 | $0.401 | 발로 $0.42 · 롤 $0.39 |
| 설정 | 경기당 평균 | $100당 경기 수 (5~95%) | 배치(반값)라면 |
|---|---|---|---|
| Opus 5.5 · 생각 high (추천) | $0.38 | 248 (242~253) | 약 496 |
| Opus 5.5 · 생각 medium | $0.30 | 318 (312~324) | 약 636 |
| Sonnet 5.5 | $0.19 | 496 | 약 992 |
| Haiku 4.5 | $0.10 | 992 | 약 1,984 |
| Opus 5.5 · 생각 high (추천) | $0.40 | 237 (232~242) | 약 474 |
| Opus 5.5 · 생각 medium | $0.32 | 301 (295~307) | 약 602 |
| Sonnet 5.5 | $0.20 | 475 | 약 950 |
| Haiku 4.5 | $0.10 | 950 | 약 1,900 |
| Opus 5.5 · 방 분위기별 | 발로란트만 | 롤만 | 반반 |
|---|---|---|---|
| 조용한 방 (1분 9문장) | 270경기 | 290경기 | 279경기 |
| 보통 (1분 18문장) | 237경기 | 259경기 | 247경기 |
| 말 많은 방 (1분 32문장) | 200경기 | 222경기 | 210경기 |
| 조용한 방 (1분 9문장) | 257경기 | 274경기 | 266경기 |
| 보통 (1분 18문장) | 227경기 | 248경기 | 237경기 |
| 말 많은 방 (1분 32문장) | 195경기 | 215경기 | 203경기 |
이 숫자는 아직 실제 경기 녹음이 없어 가정값으로 계산한 것입니다. 만들고 나서 실제 경기 3~5개로 토큰을 재고(토큰 세기 API는 무료) 이 표를 고칩니다.
+Opus 5.5로 $100이면 약 237경기(방 분위기에 따라 약 203~266경기)입니다. 경기 길이가 무작위여도 판 수가 많아 평균에 가까워지므로, 가정한 조건 안에서는 1,500번 시행 중 10번에 9번꼴로 232~242경기(5~95% 범위)가 나왔습니다. 이 범위는 계산에 넣은 가정 안의 결과이고, 실제 비용을 보장하는 범위는 아닙니다. 더 크게 흔들리는 것은 방에서 말하는 양과 AI가 생각하는 길이입니다.고정 프롬프트는 실측값이고, 경기 기록 · 대화 양 · AI 생각 길이는 아직 가정값입니다. 실제 경기 3~5판을 분석하면 사이트 서버 비용 장부에 실제 토큰 · 비용이 남으므로, 그 값으로 이 표를 다시 고칩니다.




| 리그 오브 레전드 | 발로란트 | |
|---|---|---|
| 리플레이 | 클라이언트 “경기 기록”에서 내려받아 재생 (.rofl 파일, 같은 패치 안에서만) | 2025년 9월(패치 11.06)에 생김. 패치 12.10부터 경쟁전 · 일반전 · 신속플레이 · 프리미어 · 사용자 지정 게임, 친구 경기도 경력 탭에서 볼 수 있음. 내전(사용자 지정)은 방장이 경기마다 시작 전에 사용자 지정 옵션에서 녹화를 켜야 리플레이가 남음. 보관 기간은 짧고(액트 단위로 안내됨) 바뀔 수 있어 R0에서 확인 |
| 리플레이 감지 | 계획: 롤 클라이언트(LCU) 상태가 “리플레이 보는 중”인지 + 게임 프로그램이 연 리플레이 파일 이름(지역-경기번호.rofl)으로 어느 경기인지 찾음. 이 두 가지는 공식 문서에 없는 방법이라 R0에서 검증. 안 되면 경기 시간 길이 · 챔피언 구성으로 후보를 좁히고 사용자가 고름 | 공식 방법 없음. Riot 로컬 클라이언트 상태로 리플레이 화면인지 확인을 시도하고, 안 되면 화면 글자 인식(OCR)으로 판단. 어느 경기인지는 맵 · 최종 점수 · 날짜로 기록과 맞춤. 여러 경기가 맞으면 팝업에 후보를 보여 주고 사용자가 고름(잘못 연결 방지) |
| 재생 시간 읽기 | Riot 공식 Replay API(이 PC 안 127.0.0.1:2999/replay/playback): 재생 시간 · 멈춤 · 배속을 0.25초마다 읽음 | 시간을 알려 주는 API 없음 → 지금 있는 채팅 OCR 기능으로 화면 위쪽 라운드 번호 · 라운드 타이머를 1초에 2~4번 읽고, 우리 기록의 라운드 시작 시각과 합쳐 위치를 계산. 타이머가 멈추면 멈춤, 빨리 줄면 배속 |
| exe → 리플레이 | 됨: 동기화 창에서 줄을 누르면 리플레이를 그 시간으로 옮김(같은 API) | 안 됨(한쪽 동기화). 리플레이에서 직접 옮기면 exe가 따라감 |
| 정확도 목표 | ±0.5초 | ±1초 (구매 시간 · 라운드 사이처럼 타이머가 안 보이는 순간은 직전 값으로 추정) |
| 준비 | 롤 설정 파일(game.cfg)에 EnableReplayApi=1 한 줄 필요(Riot 공식 문서 방법). 앱이 처음 한 번 동의를 받고 넣어 줌(게임이 꺼져 있을 때) | 게임을 테두리 없는 창 모드로 둬야 OCR · 팝업이 잘 됨 |
| 확실도 | 재생 시간 읽기 · 옮기기는 Riot 공식 문서에 있는 API. 리플레이 감지와 경기 식별은 R0 검증 대상이고, 안 되면 후보 고르기로 대신 | 먼저 기술 검증(R0) 필요. 리플레이 화면 구성이 OCR로 읽히는지, 감지 방법이 있는지 Windows 실기로 확인한 뒤 확정 |
| 리플레이 | 클라이언트 “경기 기록”에서 내려받아 재생 (.rofl 파일, 같은 패치 안에서만) | 패치 12.10부터 경쟁전 · 일반전 · 신속플레이 · 프리미어 · 사용자 지정 게임, 친구 경기도 경력 탭에서 볼 수 있음. 내전(사용자 지정)은 방장이 경기마다 시작 전에 녹화를 켜야 리플레이가 남음 |
| 확인할 API | ① 롤 클라이언트 로컬 API(LCU, 비공식): 리플레이 보는 중인지, 어느 경기(경기 번호)인지 ② 게임 로컬 API(이 PC 안 127.0.0.1:2999): 설정을 바꾸지 않은 상태에서 리플레이 중에 게임 시간이 나오는지③ 공식 Replay API( /replay/playback): 재생 시간 · 멈춤 · 배속 · 옮기기. game.cfg 에 한 줄을 넣어야 켜지므로 앱이 켜지 않음. 이미 켜져 있는 PC에서만 씀 | ① Riot 클라이언트 로컬 API(비공식, 지금 경기 감지에 쓰는 상태 정보): 리플레이 보는 중인지, 어느 경기인지 ② 같은 API에서 리플레이 재생 시간이나 라운드가 나오는지 |
| 되면 | 시간을 0.25초마다 읽어 동기화(목표 오차 ±0.5초). ③이 켜져 있으면 줄을 눌러 리플레이도 옮김 | 시간을 읽어 동기화. 정확도는 API가 주는 값의 간격에 따라 R0에서 정함 |
| 안 되면 | 그 게임은 리플레이 동기화를 넣지 않습니다. 화면 글자 인식(OCR) · 수동 맞춤 · 설정 파일 고치기로 대신하지 않습니다. | |
| 확인 방법 | 새 exe에 “리플레이 API 확인” 기능을 넣어, 리플레이를 1판씩 틀고 버튼을 누르면 위 API들이 리플레이 중에 무엇을 주는지 기록 파일로 남깁니다. 그 기록으로 게임별로 만들지 정합니다. | |
| 단계 | 할 일 | 확인 방법 | |
|---|---|---|---|
| C1 기록 보강 | 경기 상세를 받을 때 피해량 · 시야 · 포지션 등 추가 지표 저장. “분석 가능” 판정. 분석 자료(압축 텍스트) 만드는 앱 API | 저장된 22라운드 · 롤 경기 테스트 자료로 판정 · 자료 모양 테스트. 녹음 공백 · 변환 대기 경기가 막히는지 | |
| C2 서버 분석 | Claude 호출, JSON 형식 고정, 근거 번호 확인, 예산 장부 · 하루 횟수 · 중복 방지, 결과를 게임 PC에 저장 | 가짜 AI 응답으로 테스트(없는 근거 번호 · 9명만 온 응답 · 예산 초과 · 동시 클릭). 실제 Claude 1회 호출로 비용 기록 확인 | |
| C3 화면 | 범인찾기 탭, 진행 단계, 결과 화면(PC · 휴대폰), 근거 → 타임라인 · 듣기, 경기 화면 버튼 | 사이트 화면 캡처로 확인, 보안 정책(CSP) 켠 상태에서 동작 | |
| C4 실측 · 조정 | 실제 경기 3~5개 분석, 결과 품질과 실제 비용 확인, 지시문 · 지식 묶음 · 생각 깊이 조정, 7장 표 갱신 | 사용자와 같이 결과 검토 (범인 판정이 납득되는지) | |
| C5 배포 | 사이트 서버 배포(API 키 넣기), 앱 새 버전 exe 빌드 | 배포 전 백업, 배포 뒤 상태 확인 · 실제 분석 1회 | |
| R0 리플레이 기술 검증 | Windows 실기: 롤 Replay API 켜기 · 시간 읽기 · 옮기기, LCU 상태 · 리플레이 파일 이름으로 경기 찾기 / 발로란트 리플레이 감지 방법, 라운드 · 타이머 OCR 정확도, 내전 녹화 옵션을 켠 경기의 리플레이 확인 | 롤 리플레이 1판, 발로란트 리플레이 1판으로 10분 재생해 오차 측정. 결과로 발로란트 방식 확정 | |
| R1 감지 · 팝업 | 리플레이 감지, 경기 찾기(못 찾거나 여러 개면 후보 고르기), 남은 기록 확인, 팝업 · 단축키 · Windows 알림, “다시 묻지 않기” | 가짜 Replay API · 녹화한 화면으로 자동 테스트, 실기에서 팝업 확인 | |
| R2 동기화 창 (롤) | exe 새 창: 시간 따라가기, 단어 짚기, 음성 재생 · 멈춤 · 배속, 줄 누르면 리플레이 이동, ±0.5초 조정, 범인 근거 표시 | 실제 롤 리플레이로 멈춤 · 배속 · 되감기 따라가는지, 오차 ±0.5초 | |
| R3 동기화 (발로란트) | R0 결과대로 OCR 동기화. 안 되는 부분은 수동 맞춤(라운드 고르고 시작)으로 대신 | 실제 발로란트 리플레이로 오차 ±1초 | |
| 단계 | 할 일 | 확인 방법 | 상태 |
| C1 기록 보강 | 경기 상세에서 추가 지표 저장(4장). “분석 가능” 판정(경기 결과 · 녹음 공백 1분 · 음성 변환). 근거 번호가 달린 분석 자료 만들기, 결과 저장. 녹음 안내 문구에 AI 분석 안내 | 시연 22라운드 · 롤 경기로 판정 · 자료 모양 자동 테스트. 녹음 늦게 시작 · 변환 대기 · 녹음 제외 경기가 막히는지 | 완료 |
| C2 서버 분석 | Claude 호출(구조화 출력), 근거 번호 확인, 예산 장부 · 하루 횟수 · 중복 방지, 결과를 게임 PC에 저장 | 가짜 AI 응답 자동 테스트(없는 근거 · 빠진 사람 · 예산 초과 · 동시 클릭 · 거절). 실제 Claude 1회 호출 성공 | 완료 |
| C3 화면 | 범인찾기 탭, 진행 단계, 결과 화면(PC · 휴대폰), 근거 → 듣기 · 타임라인, 경기 화면 버튼 | 실제 앱 코어 + 사이트 서버 + 브라우저로 화면 캡처(2장), 보안 정책(CSP) 위반 · 오류 없음 | 완료 |
| C5 배포 | 사이트 서버 배포(API 키 넣기), 앱 새 버전(v1.3.0) exe 빌드 · 릴리스 | 배포 전 백업, 배포 뒤 상태 확인 · 실제 분석 1회 | 승인 대기 |
| C4 실측 · 조정 | 새 exe로 실제 경기 3~5판 분석, 결과 품질과 실제 비용 확인, 지시문 · 지식 묶음 · 생각 깊이 조정, 7장 표 갱신 | 같이 결과 검토 (범인 판정이 납득되는지) | 배포 뒤 |
| R0 리플레이 API 확인 | 새 exe의 “리플레이 API 확인” 기능으로 롤 · 발로란트 리플레이 중 API가 주는 값 기록(8장) | 롤 리플레이 1판, 발로란트 리플레이 1판 | 배포 뒤 |
| R1~R3 리플레이 동기화 | R0에서 API로 시간을 읽을 수 있는 게임만: 감지 · 팝업, 동기화 창(시간 따라가기 · 음성 · 범인 근거 표시) | 가짜 API로 자동 테스트, 실제 리플레이로 멈춤 · 배속 · 되감기 따라가는지 | R0 결과에 따라 |
범인찾기(C1~C5)와 리플레이 동기화(R0~R3)는 따로 진행할 수 있습니다. R0은 실제 게임 리플레이가 있는 Windows PC에서 해야 해서, 승한님 PC에서 리플레이를 한 번 틀어 주셔야 할 수 있습니다.
-앱(게임 PC)도 바뀌므로(추가 지표 저장, 분석 자료 API, 결과 저장) 새 exe가 필요합니다. 예전 exe로도 사이트는 열리지만 범인찾기는 “앱을 업데이트해 주세요”로 막습니다.
+예전 exe로도 사이트는 열리지만 범인찾기는 “게임 PC 앱을 업데이트해 주세요”로 막습니다. 코드: 앱 app/src/core/culprit.ts, 서버 site/server/src/culprit.ts, 화면 site/web/src/pages/CulpritPage.tsx.
EnableReplayApi=1 한 줄이 있어야 리플레이 시간을 읽습니다. → 추천: 앱이 처음 한 번 동의를 받고 자동으로 넣기. 직접 넣으시려면 안내만 띄웁니다.| 질문 | 답 (2026-10-15) | 반영 |
|---|---|---|
| ① "범인"의 뜻 | 가장 못했다 + 가장 발목을 잡았다 + 패배의 원인 등 모두 종합 | 지시문 v1.1에 세 기준을 종합하도록 넣음. 팀마다 1명, 팀 최저점(서버 확인) |
| ② 분석 버튼 | (가) 등록된 앱 유저 이상 | 서버가 앱 유저 명단으로 확인. 다시 분석은 관리자 이상, 결과 보기는 모두 |
| ③ 모델 | Opus 5.5 | Claude Opus 5.5 · 생각 깊이 high |
| ④ API 키 | 받음 | 동작 확인. 서버 비밀 저장소에만 보관, 배포 때 사이트 서버 환경 변수로만 넣음 |
| ⑤ 말투 | (나) 중간맛 | 기본 말투 medium |
| ⑥ 멤버 공지 | TTS 문구에 추가 | 녹음 안내 문구 · 기본 음성 교체 (5장) |
| ⑦ 발로란트 리플레이 | 비공식 API에 없으면 추가하지 않기 | OCR 안 함. R0에서 API 확인 뒤 결정 (8장) |
| ⑧ 롤 리플레이 | 비공식 API에 없으면 추가하지 않기 | 앱이 game.cfg 를 고치지 않음. R0에서 API 확인 뒤 결정 (8장) |
2026-10-15 초안. 구현 · 시험 경기(6장)를 거치며 고칩니다. 지시문의 tone 자리는 말투 설정으로 바뀝니다. 자동 갱신 칸은 패치마다 다시 만듭니다.
+사이트 서버가 실제로 쓰는 원문(site/server/prompt/, 지시문 v1.1). 실제 경기 분석(C4)과 시험 경기(6장)를 거치며 고칩니다. 지시문의 tone 자리는 말투 설정(중간맛)으로 바뀌고, 자동 갱신 칸은 사이트 서버가 하루에 한 번 공식 데이터로 다시 만듭니다.
prompt/system.md너는 겜녹이의 경기 분석가다. 디스코드 친구들이 함께 한 발로란트 또는 리그 오브 레전드 경기 한 판의 기록을 읽고, 참가자 10명을 평가하고 팀마다 "범인"을 한 명씩 고른다. 결과는 친구들이 재미로 보는 사이트에 그대로 뜬다. 정확하고 공정해야 웃고 넘길 수 있다.
@@ -518,16 +529,22 @@ user 메시지의 <match> 안에 경기 자료가 온다.
- [e번호] 게임 이벤트 (킬, 스파이크, 오브젝트, 라운드 결과 등)
- [u번호] 음성 문장. 디스코드 음성채널에서 자동 음성 인식으로 받아 적은 것이라 글자가 틀릴 수 있다.
- [c번호] 인게임 채팅 (팀 / 전체)
- - [r번호] 라운드 요약 (발로란트), [s:P번호] 그 사람의 경기 전체 스탯
+ - [r번호] 라운드 요약 (발로란트): 우리 팀 공격/수비, 승패와 끝난 이유, 점수, 팀 평균 장비 값, "선수 장비/피해" = 그 라운드 장비 값(k=1,000 크레드)/준 피해
+ - [s:P번호] 그 사람의 경기 전체 스탯 (참가자 줄)
+- 줄의 시간: 발로란트 "R7 0:42" = 7라운드 교전 시작 뒤 42초("R7 구매" = 구매 시간), 롤 "12:18" = 게임 시간.
+- 참가자 줄 약어: ACS = 라운드당 전투 점수, ADR = 라운드당 준 피해, HS = 헤드샷 비율, 롤 "10분 78·3450" = 10분 CS·골드. "?" 는 기록 없음.
+- "(게임 계정 모름)" 이 붙은 화자는 디스코드 이름만 알고 어느 참가자인지 모른다. 참가자 평가에 그 사람 말을 붙이지 않는다.
+- "기본 기록만 있다" 고 적힌 경기는 피해량·첫킬·시야 같은 지표가 없다. 없는 지표로 판단하지 않는다.
- 음성은 봇이 있던 음성채널 사람만 있다. 상대 팀은 보통 음성이 없다.
</input_format>
<task>
1. 경기 흐름을 먼저 파악한다. 어느 라운드·시간대에서 승부가 갈렸는지 찾는다.
2. 10명 모두 평가한다: 평점(1.0~10.0, 0.5 단위), 태그 하나, 한 줄 평(40자 안팎).
-3. 팀마다 범인을 한 명씩 고른다.
- - 진 팀의 범인: 패배에 가장 큰 책임이 있는 사람.
- - 이긴 팀의 범인: 이기는 데 가장 발목을 잡은 사람.
+3. 팀마다 범인을 한 명씩 고른다. 범인은 아래를 모두 합쳐 종합으로 판단한다. 한 가지만 보지 않는다.
+ - 가장 못한 사람: 자기 역할·포지션 기준으로 플레이가 가장 나빴다.
+ - 가장 발목을 잡은 사람: 팀의 계획·경제·콜을 가장 많이 망쳤다.
+ - 결과의 원인: 진 팀이면 패배에 가장 큰 책임, 이긴 팀이면 이기는 데 가장 방해가 된 사람.
- 범인은 그 팀에서 평점이 가장 낮아야 한다. 동점이면 근거가 더 분명한 사람.
4. 범인마다 이유(2~3문장)와 근거 3~4개, 나머지 사람은 근거 0~2개를 단다.
5. 경기 전체 한 줄 요약(1~2문장)을 쓴다.
diff --git a/docs/report/culprit/sim.json b/docs/report/culprit/sim.json
index 73b2ef9..f23bebf 100644
--- a/docs/report/culprit/sim.json
+++ b/docs/report/culprit/sim.json
@@ -29,238 +29,234 @@
"mean": 634.7355
},
"in": {
- "p10": 17205.3752,
- "p50": 25073.3193,
- "p90": 36040,
- "p99": 48952,
- "mean": 26076.9607
+ "p10": 20325,
+ "p50": 28033,
+ "p90": 38881,
+ "p99": 51878.8871,
+ "mean": 29052.8009
},
"out": {
- "p10": 9700.6198,
- "p50": 13363.0168,
- "p90": 19185.7409,
- "p99": 26501.8314,
- "mean": 13996.5323
+ "p10": 9851.5492,
+ "p50": 13599.4192,
+ "p90": 19550.2369,
+ "p99": 27056.5033,
+ "mean": 14248.8196
},
"cost": {
- "p10": 0.2848,
- "p50": 0.3712,
- "p90": 0.5006,
- "p99": 0.6606,
- "mean": 0.3842
+ "p10": 0.3002,
+ "p50": 0.3879,
+ "p90": 0.5193,
+ "p99": 0.6824,
+ "mean": 0.4012
},
"cost_val": {
- "p10": 0.3,
- "p50": 0.3883,
- "p90": 0.5192,
- "p99": 0.6756,
- "mean": 0.4013
+ "p10": 0.3139,
+ "p50": 0.4037,
+ "p90": 0.5366,
+ "p99": 0.6964,
+ "mean": 0.4169
},
"cost_lol": {
- "p10": 0.2723,
- "p50": 0.3545,
- "p90": 0.4767,
- "p99": 0.6358,
- "mean": 0.3671
+ "p10": 0.2887,
+ "p50": 0.3725,
+ "p90": 0.4968,
+ "p99": 0.6606,
+ "mean": 0.3854
}
},
"hist": [
- [
- 0.15,
- 1
- ],
[
0.175,
- 12
+ 4
],
[
0.2,
- 106
+ 26
],
[
0.225,
- 406
+ 191
],
[
0.25,
- 950
+ 574
],
[
0.275,
- 1655
+ 1186
],
[
0.3,
- 2209
+ 1883
],
[
0.325,
- 2490
+ 2349
],
[
0.35,
- 2528
+ 2509
],
[
0.375,
- 2257
+ 2430
],
[
0.4,
- 1928
+ 2103
],
[
0.425,
- 1525
+ 1772
],
[
0.45,
- 1087
+ 1372
],
[
0.475,
- 829
+ 1007
],
[
0.5,
- 600
+ 733
],
[
0.525,
- 443
+ 560
],
[
0.55,
- 300
+ 392
],
[
0.575,
- 213
+ 280
],
[
0.6,
- 157
+ 199
],
[
0.625,
- 72
+ 134
],
[
0.65,
- 72
+ 78
],
[
0.675,
- 58
+ 64
],
[
0.7,
- 28
+ 54
],
[
0.725,
- 29
+ 31
],
[
0.75,
- 21
+ 30
],
[
0.775,
- 14
+ 18
],
[
0.8,
- 6
+ 13
],
[
0.825,
- 2
+ 4
],
[
0.85,
- 1
+ 2
],
[
0.875,
- 1
+ 2
]
],
"hist_n": 20000,
"per_model": {
"opus-5.5": {
- "p5": 242,
- "p50": 248,
- "p95": 253,
- "mean": 247.55533333333332,
- "batch_p50": 496
+ "p5": 232,
+ "p50": 237,
+ "p95": 242,
+ "mean": 237.06733333333332,
+ "batch_p50": 474
},
"sonnet-5.5": {
- "p5": 488,
- "p50": 496,
- "p95": 504,
- "mean": 495.95733333333334,
- "batch_p50": 992
+ "p5": 467,
+ "p50": 475,
+ "p95": 483,
+ "mean": 474.98066666666665,
+ "batch_p50": 950
},
"haiku-4.5": {
- "p5": 980,
- "p50": 992,
- "p95": 1004,
- "mean": 992.2046666666666,
- "batch_p50": 1984
+ "p5": 939,
+ "p50": 950,
+ "p95": 961,
+ "mean": 950.174,
+ "batch_p50": 1900
}
},
"scenarios": {
"quiet/valorant": {
- "mean": 0.3526,
- "p90": 0.4543,
- "per100": 270
+ "mean": 0.3694,
+ "p90": 0.4733,
+ "per100": 257
},
"quiet/lol": {
- "mean": 0.3282,
- "p90": 0.4234,
- "per100": 290
+ "mean": 0.3464,
+ "p90": 0.4494,
+ "per100": 274
},
"quiet/mix": {
- "mean": 0.3404,
- "p90": 0.4405,
- "per100": 279
+ "mean": 0.3577,
+ "p90": 0.4614,
+ "per100": 266
},
"normal/valorant": {
- "mean": 0.4008,
- "p90": 0.5197,
- "per100": 237
+ "mean": 0.4184,
+ "p90": 0.5415,
+ "per100": 227
},
"normal/lol": {
- "mean": 0.3675,
- "p90": 0.4812,
- "per100": 259
+ "mean": 0.384,
+ "p90": 0.4974,
+ "per100": 248
},
"normal/mix": {
- "mean": 0.3846,
- "p90": 0.5037,
- "per100": 247
+ "mean": 0.4004,
+ "p90": 0.5156,
+ "per100": 237
},
"loud/valorant": {
- "mean": 0.4756,
- "p90": 0.6177,
- "per100": 200
+ "mean": 0.488,
+ "p90": 0.6328,
+ "per100": 195
},
"loud/lol": {
- "mean": 0.4282,
- "p90": 0.5629,
- "per100": 222
+ "mean": 0.4426,
+ "p90": 0.5776,
+ "per100": 215
},
"loud/mix": {
- "mean": 0.4519,
- "p90": 0.598,
- "per100": 210
+ "mean": 0.4685,
+ "p90": 0.6171,
+ "per100": 203
}
},
"opus_medium": {
- "p5": 312,
- "p50": 318,
- "p95": 324,
- "mean": 318.2026666666667
+ "p5": 295,
+ "p50": 301,
+ "p95": 307,
+ "mean": 301.1546666666667
}
}