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'''겜녹이 범인찾기 · 리플레이 동기화 계획서 v1.1 +HTML = f'''겜녹이 범인찾기 · 리플레이 동기화 계획서 v1.2
@@ -80,13 +81,14 @@ tr.hl td {{ background:#fff3f4 !important; font-weight:700; }}
AI가 경기 기록을 읽고 10명 평가 · 팀별 범인을 찾습니다.
리플레이를 보면 그때 한 말을 시간에 맞춰 보여 줍니다.
- + +
프로젝트겜녹이 (Game Voice Recorder) · v1.2.2 다음 기능
문서계획서 v1.1 · 코드 작성 전 검토용 (v1.0 + 리플레이 동기화 · 프롬프트 · 지식 묶음)
문서계획서 v1.2 · 정해 주신 8가지 반영 (v1.1 + 결정 사항 · 실제 화면 · 토큰 실측)
진행범인찾기 C1~C3(앱 · 사이트 서버 · 화면) 구현 완료, 배포 전 · 리플레이 동기화는 API 확인 뒤 결정
작성일2026-10-15
AIClaude API (Anthropic) · 기본 모델 Claude Opus 5.5
예산API 크레딧 $100 (2026-11-15 만료)
-
-
gvr.tkrmagid.kr · 화면은 시안이고 이름 · 기록은 예시입니다
+
+
gvr.tkrmagid.kr · 표지 화면은 실제 구현 화면(시연 데이터 + 실제 Claude Opus 5.5 분석 결과)입니다
@@ -103,19 +105,22 @@ tr.hl td {{ background:#fff3f4 !important; font-weight:700; }}
  • 팀별 범인 1명씩(우리 팀 · 상대 팀), 왜 범인인지 설명, 근거 3~4개
  • 근거마다 실제 순간(대화 · 킬 · 라운드)이 연결돼 누르면 타임라인에서 바로 듣고 볼 수 있음
  • 대상 경기: 끝났고 기록이 모두 남아 있는 경기만 고를 수 있습니다. 녹음이 중간에 시작됐거나, 경기 결과를 못 받았거나, 음성 변환이 덜 끝난 경기는 이유를 보여 주고 막습니다 (4장).
  • -
  • AI는 사이트 서버가 부릅니다. API 키는 봇 토큰처럼 서버에만 두고, exe에는 넣지 않습니다 (5장).
  • -
  • 비용: 경기 길이와 말하는 양을 무작위로 바꿔 가며 2만 경기를 계산했습니다. Opus 5.5로 $100이면 약 {opus['p50']}경기입니다. 방이 조용하면 약 {SC['quiet/mix']['per100']}경기, 말이 많으면 약 {SC['loud/mix']['per100']}경기입니다 (7장).
  • +
  • 범인: 팀마다 1명. 가장 못한 사람 + 가장 발목을 잡은 사람 + 결과(패배)의 원인을 모두 합쳐 종합으로 고릅니다 (3장).
  • +
  • AI는 사이트 서버가 부릅니다. Claude Opus 5.5 · 말투 중간맛. API 키는 받아서 서버 비밀 저장소에만 두었고, 배포 때 사이트 서버 환경 변수로만 넣습니다. exe에는 넣지 않습니다 (5장).
  • +
  • 분석 버튼은 등록된 앱 유저 이상만 누를 수 있습니다(다시 분석은 관리자). 결과는 로그인한 멤버 모두가 봅니다.
  • +
  • 비용: 경기 길이와 말하는 양을 무작위로 바꿔 가며 2만 경기를 계산했습니다. Opus 5.5로 $100이면 약 {opus['p50']}경기입니다(지시문 · 지식 묶음 토큰을 실제로 재서 다시 계산, v1.1의 248경기에서 조정). 방이 조용하면 약 {SC['quiet/mix']['per100']}경기, 말이 많으면 약 {SC['loud/mix']['per100']}경기입니다 (7장).
  • 예산 보호: 월 $100 상한, 하루 횟수 제한, 경기당 최대 약 $1 상한, 한 경기는 한 번만 분석(다시 분석은 관리자만)을 둡니다.
  • 프롬프트 · 지식 묶음은 미리 써 두었습니다: 지시문, 발로란트 · 롤 지식 묶음(규칙 · 경제 · 역할 기준 · 은어 · 음성 인식 오류 · 최신 요원 · 챔피언 목록), 출력 형식. 매 분석마다 같이 보내 AI가 “배운 상태”로 분석합니다 (6장 · 부록).
  • -
  • 리플레이 동기화: 게임 안 리플레이를 보면 exe가 알아채고, 그 경기 기록이 남아 있으면 “리플레이와 동기화하시겠습니까?”를 묻습니다. 확인하면 exe 창이 리플레이 시간에 맞춰 대화 · 이벤트를 보여 주고 음성을 들려 줍니다. 롤은 공식 리플레이 API로 시간을 읽고 옮기는 양쪽 동기화(어느 경기인지 찾는 방법은 기술 검증 필요), 발로란트는 API가 없어 화면 글자 인식(OCR)으로 한쪽 동기화이고 먼저 기술 검증이 필요합니다 (8장). AI를 쓰지 않아 비용이 없습니다.
  • +
  • 멤버 공지: 녹음 안내(TTS) 문구에 “녹음된 대화는 AI 경기 분석에 쓰일 수 있어요”를 넣었습니다. 기본 문구를 쓰던 PC는 새 문구로 자동으로 바뀝니다.
  • +
  • 리플레이 동기화: 게임 안 리플레이를 보면 exe가 알아채고 “리플레이와 동기화하시겠습니까?”를 묻는 기능입니다. 게임이 API(공식 · 비공식)로 리플레이 시간을 알려 줄 때만 넣습니다. 화면 글자 인식(OCR)이나 게임 설정 파일 고치기는 하지 않습니다. 그래서 먼저 Windows PC에서 롤 · 발로란트가 어떤 API를 주는지 확인(R0)하고, 되는 게임만 만듭니다 (8장). AI를 쓰지 않아 비용이 없습니다.
  • -
    정해 주실 것 (자세한 내용은 10장) -① "범인"의 뜻 ② 분석 버튼을 누를 수 있는 사람 ③ 모델(Opus 5.5 추천) ④ Claude API 키 발급 ⑤ 말투(순한맛/매운맛) ⑥ 멤버들에게 AI 분석을 알릴지 ⑦ 발로란트 리플레이를 OCR로 맞추는 방식 ⑧ 롤 리플레이 API를 앱이 켜 줄지
    +
    정한 것 (2026-10-15 답변 · 자세한 내용은 10장) +① 범인 = 가장 못함 + 가장 발목 + 패배 원인 종합 ② 분석 버튼 = 등록된 앱 유저 이상 ③ 모델 = Opus 5.5 ④ API 키 = 받음(서버에만) ⑤ 말투 = 중간맛 ⑥ 공지 = 녹음 안내(TTS) 문구에 추가 ⑦ 발로란트 리플레이 = API에 없으면 넣지 않음(OCR 안 함) ⑧ 롤 리플레이 = API에 없으면 넣지 않음(설정 파일 안 고침)

    목차

    1. 한눈에 보기
    2. 쓰는 흐름 · 화면 예시
    3. 범인을 고르는 기준
    4. 분석에 쓰는 기록 · 분석할 수 있는 경기
    5. -
    6. 구조 · 보안 · 개인정보
    7. 범인찾기 프롬프트 · 지식 묶음
    8. 비용 예상: $100로 몇 경기?
    9. 리플레이 동기화
    10. 만드는 순서 · 확인 방법
    11. 정해 주실 것
    12. 부록: 프롬프트 · 지식 묶음 · 출력 형식 원문
    +
  • 구조 · 보안 · 개인정보
  • 범인찾기 프롬프트 · 지식 묶음
  • 비용 예상: $100로 몇 경기?
  • 리플레이 동기화
  • 만드는 순서 · 확인 방법
  • 정한 것 · 남은 일
  • 부록: 프롬프트 · 지식 묶음 · 출력 형식 원문
  • @@ -127,13 +132,13 @@ tr.hl td {{ background:#fff3f4 !important; font-weight:700; }}
    🧠
    AI 분석
    1~2분
    진행 단계 표시
    🚨
    결과
    팀별 범인 · 10명 평가
    모두가 같이 봄
    -
    화면 예시 1 · 범인찾기 탭 (경기 고르기) 왼쪽은 끝난 경기 목록입니다. 경기마다 분석 가능 · 분석 완료 · 준비 중 · 기록 부족을 표시하고, 기록이 부족하면 이유(“녹음이 12분 뒤에 시작됨” 등)를 보여 줍니다. 오른쪽은 고른 경기에서 분석에 쓰는 기록과 참가자 10명(음성이 있는 사람 표시), 예상 비용 · 남은 예산 · 오늘 남은 횟수입니다. 시안
    -
    화면 예시 2 · 분석 결과 (발로란트) 맨 위는 한 줄 요약, 가운데는 팀별 범인 카드(이유 + 근거), 아래는 10명 평가입니다. 근거의 대화는 ▶ 듣기로 그 문장 음성을 바로 재생하고(7일 보관 기간 안), 킬 · 라운드는 타임라인으로 이동합니다. 상대 팀처럼 음성이 없는 사람은 “게임 기록으로 판단”이라고 밝힙니다. 시안 · 이름과 기록은 예시
    +
    화면 1 · 범인찾기 탭 (경기 고르기) 왼쪽은 끝난 경기 목록입니다. 경기마다 분석 가능 · 분석 완료 · 준비 중 · 기록 부족을 표시하고, 기록이 부족하면 이유(“녹음이 12분 뒤에 시작됨” 등)를 보여 줍니다. 오른쪽은 고른 경기에서 분석에 쓰는 기록과 참가자 10명(음성이 있는 사람 표시), 예상 비용 · 남은 예산 · 오늘 남은 횟수입니다. 실제 화면 · 시연 데이터
    +
    화면 2 · 분석 결과 (발로란트) 맨 위는 한 줄 요약, 가운데는 팀별 범인 카드(이유 + 근거), 아래는 10명 평가입니다. 근거의 대화는 ▶ 듣기로 그 문장 음성을 바로 재생하고(7일 보관 기간 안), 킬 · 라운드는 타임라인으로 이동합니다. 상대 팀처럼 음성이 없는 사람은 “게임 기록으로 판단”이라고 밝힙니다. 결과 글은 실제 Claude Opus 5.5가 쓴 것입니다. 시연 데이터의 앞뒤가 안 맞는 곳을 AI가 스스로 찾아 확신도를 “낮음”으로 적었습니다. 실제 화면 · 시연 데이터
    -
    화면 예시 3 · 분석 결과 (롤, 휴대폰) 이긴 경기에서도 팀마다 범인을 뽑습니다. 휴대폰에서는 범인 카드를 먼저, 10명 평가를 아래로 이어 보여 줍니다. 시안
    +
    화면 3 · 분석 결과 (휴대폰) 이긴 경기에서도 팀마다 범인을 뽑습니다. 휴대폰에서는 요약, 범인 카드, 10명 평가를 차례로 보여 줍니다. 실제 화면 · 시연 데이터

    결과 화면에 들어가는 것

    @@ -155,8 +160,12 @@ tr.hl td {{ background:#fff3f4 !important; font-weight:700; }}

    3범인을 고르는 기준

    -
    "범인"의 뜻 (제안 · 8장에서 확인) -팀마다 그 팀 결과에 가장 나쁜 영향을 준 1명입니다. 진 팀은 “패배 책임이 가장 큰 사람”, 이긴 팀은 “이기는 데 가장 발목을 잡은 사람”입니다. 그래서 이긴 경기에도 범인이 있습니다.
    +
    "범인"의 뜻 (정함 · ①) +팀마다 1명을 고르고, 아래 셋을 모두 합쳐 종합으로 판단합니다. 한 가지만 보지 않습니다. +
    • 가장 못한 사람: 자기 역할 · 포지션 기준으로 플레이가 가장 나빴다
    • +
    • 가장 발목을 잡은 사람: 팀의 계획 · 경제 · 콜을 가장 많이 망쳤다
    • +
    • 결과의 원인: 진 팀이면 패배에 가장 큰 책임, 이긴 팀이면 이기는 데 가장 방해가 된 사람
    +그래서 이긴 경기에도 범인이 있습니다. 범인은 그 팀에서 평점이 가장 낮아야 합니다(서버가 확인).
    @@ -176,10 +185,10 @@ tr.hl td {{ background:#fff3f4 !important; font-weight:700; }}

    4분석에 쓰는 기록 · 분석할 수 있는 경기

    보는 것발로란트리그 오브 레전드
    플레이첫 킬 · 첫 데스, 전투 점수(ACS), 라운드당 피해량, 클러치, 스파이크 설치 · 해체, 연속 데스포지션별 기준: 라인 CS · 골드 차, 킬 관여율, 딜량 · 받은 피해, 데스 시점(오브젝트 직전 등)
    - + - - + +
    기록지금 저장하는 것범인찾기를 위해 더 저장할 것
    기록원래 저장하던 것범인찾기를 위해 더 저장 (구현 완료)
    음성 대화유저별 문장, 시각, 경기 · 라운드 연결 (텍스트는 계속 남음)없음. 음성 파일은 7일 뒤 지워져도 분석은 텍스트로 함
    발로란트 경기10명 KDA · 전투 점수 · 랭크, 라운드 결과, 라운드별 경제(쓴 돈 · 무기), 킬(무기 · 헤드샷 · 위치)라운드별 피해량, 스파이크 설치 · 해체한 사람, 스킬 사용 횟수 (Riot 경기 결과에 이미 있음, 지금은 버림)
    롤 경기10명 KDA · CS · 골드 · 아이템, 골드 차 그래프, 킬 · 오브젝트 이벤트포지션, 딜량 · 받은 피해, 시야 점수 · 와드, 분당 골드 · CS (LCU 경기 기록에 이미 있음, 지금은 버림)
    발로란트 경기10명 KDA · 전투 점수 · 랭크, 라운드 결과, 라운드별 경제(쓴 돈 · 무기), 킬(무기 · 헤드샷 · 위치)선수별 준 피해 · 헤드샷 비율 · 첫킬/첫데스 · 설치/해체 · 스킬 사용 · 요원 역할, 라운드별 공격/수비 · 장비 값 · 선수별 킬/피해
    롤 경기10명 KDA · CS · 골드 · 아이템, 골드 차 그래프, 킬 · 오브젝트 이벤트포지션(추정), 챔피언 피해 · 받은 피해, 시야 점수 · 와드 설치/제거/제어 와드, 오브젝트 · 포탑 피해, CC 시간, 10분 · 15분 CS · 골드
    채팅팀 · 전체 채팅 (API · OCR)없음
    디스코드 ↔ 게임 계정Riot ID로 누가 누구인지 연결연결 안 된 화자는 디스코드 이름으로 보내고 “게임 계정 모름”으로 표시
    @@ -212,29 +221,28 @@ tr.hl td {{ background:#fff3f4 !important; font-weight:700; }}
    6게임 PC결과 저장 → 사이트 실시간 알림

    AI에 보내는 자료 모양 (예시)

    -
    # 경기 발로란트 경쟁전 · 어센트 · 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)가 아니라 이런 줄글로 보내 토큰을 아낍니다.

    개인정보

    @@ -244,13 +252,13 @@ P9 Kiwi 상대 스카이 9/18/7 132 88 1/4 음성X
    "미리 학습"은 이렇게 합니다 Claude API는 우리가 모델을 따로 학습(파인튜닝)시킬 수 없습니다. 대신 분석할 때마다 지시문과 지식 묶음을 경기 자료 앞에 같이 보냅니다. 그래서 AI는 매번 게임 규칙 · 역할 기준 · 은어 · 음성 인식 오류를 “배운 상태”로 분석합니다. 이 부분은 경기마다 똑같아 프롬프트 캐시를 쓰면 1시간 안의 다음 분석부터 이 부분 값이 약 5%로 줄어듭니다(비용 계산에는 캐시 없이 넣었습니다).
    - - - - - + + + + +
    파일 (미리 써 둠)내용토큰(추정)
    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).

    지식 묶음 = 손으로 쓴 부분 + 패치마다 자동 갱신하는 부분

    @@ -264,7 +272,7 @@ Claude API는 우리가 모델을 따로 학습(파인튜닝)시킬 수 없습

    자동 갱신 부분 (패치마다 새로 만듦)

    @@ -319,8 +327,8 @@ Claude API는 우리가 모델을 따로 학습(파인튜닝)시킬 수 없습

    경기 하나에 드는 토큰 (Opus 5.5, 평균)

    - - + + @@ -346,7 +354,7 @@ Claude API는 우리가 모델을 따로 학습(파인튜닝)시킬 수 없습
    결론 Opus 5.5로 $100이면 약 {opus['p50']}경기(방 분위기에 따라 약 {SC['loud/mix']['per100']}~{SC['quiet/mix']['per100']}경기)입니다. 경기 길이가 무작위여도 판 수가 많아 평균에 가까워지므로, 가정한 조건 안에서는 1,500번 시행 중 10번에 9번꼴로 {opus['p5']}~{opus['p95']}경기(5~95% 범위)가 나왔습니다. 이 범위는 계산에 넣은 가정 안의 결과이고, 실제 비용을 보장하는 범위는 아닙니다. 더 크게 흔들리는 것은 방에서 말하는 양과 AI가 생각하는 길이입니다.
    크레딧은 11월 15일에 만료됩니다. {opus['p50']}경기를 다 쓰려면 하루 {per_day:.0f}판씩 분석해야 하므로, 크레딧을 아끼려고 더 싼 모델을 쓸 이유는 적습니다. 그래서 Opus 5.5를 추천합니다.
    -

    이 숫자는 아직 실제 경기 녹음이 없어 가정값으로 계산한 것입니다. 만들고 나서 실제 경기 3~5개로 토큰을 재고(토큰 세기 API는 무료) 이 표를 고칩니다.

    +

    고정 프롬프트는 실측값이고, 경기 기록 · 대화 양 · AI 생각 길이는 아직 가정값입니다. 실제 경기 3~5판을 분석하면 사이트 서버 비용 장부에 실제 토큰 · 비용이 남으므로, 그 값으로 이 표를 다시 고칩니다.

    @@ -370,28 +378,28 @@ Opus 5.5로 $100이면 약 {opus['p50']}경기(방 분위기에 따라
    🔗
    동기화
    리플레이 시간 따라
    대화 · 이벤트 · 음성
    ⏩
    계속 따라감
    멈춤 · 배속 · 되감기
    모두 따라감
    -
    화면 예시 4 · 동기화 묻기 (exe 팝업) 리플레이를 틀면 exe가 그 경기의 기록을 찾아 오른쪽 위에 묻습니다. 남은 기록(대화 텍스트 · 음성 파일 · 이벤트 · 범인 분석)을 보여 주고, 음성 파일이 7일이 지나 지워졌으면 “글자만 동기화”로 바뀝니다. 뒤 배경은 자리 표시용입니다. 시안
    -
    화면 예시 5 · 동기화 창 (exe) 리플레이 시간(오른쪽 위)에 맞춰 지금 말하는 문장을 단어 단위로 짚고 음성을 들려 줍니다. 지나간 줄은 흐리게, 다음 줄은 미리 보입니다. 아래 막대는 경기 전체의 대화 · 킬 · 오브젝트 · 범인 근거 위치입니다. 롤은 줄을 누르면 리플레이가 그 시간으로 옮겨 갑니다. 시안 · 이름과 기록은 예시
    +
    정한 원칙 (⑦ · ⑧): API로 될 때만 넣습니다 +게임이 공식 · 비공식 API로 리플레이 재생 시간을 알려 줄 때만 그 게임의 동기화를 만듭니다. 화면 글자 인식(OCR)으로 시간을 읽거나, 앱이 게임 설정 파일(game.cfg)을 고치는 방법은 쓰지 않습니다. 그래서 먼저 Windows PC에서 어떤 API가 리플레이 중에 무엇을 알려 주는지 확인(R0)하고, 되는 게임만 R1~R3을 진행합니다. 둘 다 안 되면 리플레이 동기화는 넣지 않습니다.
    +
    화면 예시 4 · 동기화 묻기 (exe 팝업) 리플레이를 틀면 exe가 그 경기의 기록을 찾아 오른쪽 위에 묻습니다. 남은 기록(대화 텍스트 · 음성 파일 · 이벤트 · 범인 분석)을 보여 주고, 음성 파일이 7일이 지나 지워졌으면 “글자만 동기화”로 바뀝니다. 뒤 배경은 자리 표시용입니다. 시안 · API 확인 뒤 만듦
    +
    화면 예시 5 · 동기화 창 (exe) 리플레이 시간(오른쪽 위)에 맞춰 지금 말하는 문장을 단어 단위로 짚고 음성을 들려 줍니다. 지나간 줄은 흐리게, 다음 줄은 미리 보입니다. 아래 막대는 경기 전체의 대화 · 킬 · 오브젝트 · 범인 근거 위치입니다. 리플레이를 옮기는 API까지 있으면 줄을 눌러 리플레이를 그 시간으로 옮깁니다. 시안 · 이름과 기록은 예시
    -

    게임별로 되는 것

    +

    R0에서 확인할 것 (Windows PC, 리플레이 1판씩)

    부분토큰비용설명
    지시문 · 지식 묶음 · 출력 형식약 {(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.066JSON
    - - - - - - - + + + + +
    리그 오브 레전드발로란트
    리플레이클라이언트 “경기 기록”에서 내려받아 재생 (.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들이 리플레이 중에 무엇을 주는지 기록 파일로 남깁니다. 그 기록으로 게임별로 만들지 정합니다.

    시간을 맞추는 원리

    @@ -402,42 +410,45 @@ Opus 5.5로 $100이면 약 {opus['p50']}경기(방 분위기에 따라
  • 동기화 창: exe의 새 창입니다. 두 번째 모니터에 두거나, 📌 항상 위 · 작게 보기로 게임 옆에 띄웁니다.
  • 음성: 리플레이를 멈추면 같이 멈추고, 되감으면 그 지점부터 다시 들려 줍니다. 2배속까지는 같이 빨라지고, 더 빠르면 글자만 보여 줍니다. 여러 명이 동시에 말한 구간은 겹쳐서 재생합니다. 음성 파일이 지워진 경기는 글자만 보여 줍니다.
  • 범인 분석과 연결: 분석 결과가 있으면 범인 근거 순간에 🔍 표시를 붙입니다.
  • -
  • 보안 · 비용: 모두 이 PC 안(127.0.0.1)에서만 일어나고 사이트 서버 · 인터넷 · AI를 쓰지 않습니다. 비용 0. 게임 메모리를 읽거나 게임 파일을 고치지 않습니다(롤 설정 한 줄은 공식 방법). Riot 로컬 API의 자체 서명 인증서는 지금처럼 이 PC 안 주소에만 예외를 둡니다.
  • +
  • 보안 · 비용: 모두 이 PC 안(127.0.0.1)에서만 일어나고 사이트 서버 · 인터넷 · AI를 쓰지 않습니다. 비용 0. 게임 메모리를 읽거나 게임 파일 · 설정 파일을 고치지 않고, 화면을 읽지도 않습니다. Riot 로컬 API의 자체 서명 인증서는 지금처럼 이 PC 안 주소에만 예외를 둡니다.
  • -

    9만드는 순서 · 확인 방법

    +

    9만드는 순서 · 진행 상황

    - - - - - - - - - - + + + + + + + +
    단계할 일확인 방법
    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.

    -

    10정해 주실 것

    -
    ①"범인"의 뜻
    제안: 팀마다 1명, 진 팀은 패배 책임 1위 · 이긴 팀은 가장 발목 잡은 사람. → 다르게 원하시면(예: 진 팀만 범인 1명) 알려 주세요.
    -
    ②분석 버튼을 누를 수 있는 사람
    (가) 등록된 앱 유저 이상 (나) 관리자 이상 (다) 사이트에 로그인한 서버 멤버 전원. 결과 보기는 모두 가능. → 추천: (가). 하루 20회 제한과 같이.
    -
    ③모델
    Opus 5.5(약 {opus['p50']}경기) · Sonnet 5.5(약 {PM['sonnet-5.5']['p50']}경기). → 추천: Opus 5.5. 크레딧 만료 전에 다 쓰기 어려운 양이라 품질을 우선합니다. 크레딧이 끝난 뒤 유료로 계속 쓰신다면 그때 Sonnet 5.5와 비교하겠습니다.
    -
    ④Claude API 키
    Claude Console(크레딧이 들어온 조직)에서 API 키를 만들어 주세요. 사이트 서버에만 넣습니다. Console에서 월 지출 한도 $100도 걸어 주시면 좋습니다. → 코드 작업(C1~C3)은 키 없이 시작할 수 있고, 키는 C2 실제 호출 전에만 있으면 됩니다.
    -
    ⑤말투
    (가) 순한맛: 담백한 평가 (나) 중간맛: 가볍게 놀림, 욕설 · 인신공격 없음 (다) 매운맛: 세게 놀림, 그래도 욕설 · 인신공격 없음. → 추천: (나). 시안 문구가 (나) 수준입니다.
    -
    ⑥멤버 공지
    대화 텍스트가 Claude API로 가서 분석된다는 것을 알릴지. → 추천: 디스코드 공지 한 번 + 녹음 안내(TTS) 문구에 “AI 분석에 쓰일 수 있어요” 추가.
    -
    ⑦발로란트 리플레이 동기화 방식
    발로란트는 재생 시간을 알려 주는 API가 없어 화면 OCR로 맞춥니다. 오차 ±1초 목표, exe에서 리플레이 시간을 옮길 수는 없습니다(한쪽). → 이 방식으로 R0 검증부터 해도 될지. 검증에서 안 되면 “라운드를 고르고 같이 시작” 수동 방식으로 대신합니다. 내전 리플레이는 방장이 경기마다 시작 전에 녹화 옵션을 켜야 남습니다.
    -
    ⑧롤 Replay API 켜기
    롤 설정 파일(game.cfg)에 EnableReplayApi=1 한 줄이 있어야 리플레이 시간을 읽습니다. → 추천: 앱이 처음 한 번 동의를 받고 자동으로 넣기. 직접 넣으시려면 안내만 띄웁니다.
    +

    10정한 것 · 남은 일

    + + + + + + + + + + +
    질문답 (2026-10-15)반영
    ① "범인"의 뜻가장 못했다 + 가장 발목을 잡았다 + 패배의 원인 등 모두 종합지시문 v1.1에 세 기준을 종합하도록 넣음. 팀마다 1명, 팀 최저점(서버 확인)
    ② 분석 버튼(가) 등록된 앱 유저 이상서버가 앱 유저 명단으로 확인. 다시 분석은 관리자 이상, 결과 보기는 모두
    ③ 모델Opus 5.5Claude Opus 5.5 · 생각 깊이 high
    ④ API 키받음동작 확인. 서버 비밀 저장소에만 보관, 배포 때 사이트 서버 환경 변수로만 넣음
    ⑤ 말투(나) 중간맛기본 말투 medium
    ⑥ 멤버 공지TTS 문구에 추가녹음 안내 문구 · 기본 음성 교체 (5장)
    ⑦ 발로란트 리플레이비공식 API에 없으면 추가하지 않기OCR 안 함. R0에서 API 확인 뒤 결정 (8장)
    ⑧ 롤 리플레이비공식 API에 없으면 추가하지 않기앱이 game.cfg 를 고치지 않음. R0에서 API 확인 뒤 결정 (8장)
    +
    A배포 승인
    사이트 서버 배포(API 키 넣기)와 새 exe(v1.3.0) 릴리스를 진행해도 될지. → 승인하시면 배포하고, 새 exe로 실제 경기 3~5판을 분석해 같이 결과를 봅니다(C4).
    +
    BAPI 키 관리
    키가 디스코드 채팅에 그대로 올라왔습니다. → 그 메시지를 지워 주시고, 오래 쓰실 거면 Console에서 키를 새로 만들어 주세요. Console 월 지출 한도 $100도 걸어 두시면 사이트 서버 한도와 함께 두 번 막힙니다.
    +
    C리플레이 API 확인 (R0)
    새 exe에 “리플레이 API 확인” 기능을 같이 넣을지. → 넣으면 리플레이를 1판씩 틀고 버튼만 눌러 주시면 됩니다. 롤 Replay API를 이미 켜 둔 PC가 아니면, 롤은 클라이언트 API 결과로만 정합니다.
    -

    부록프롬프트 · 지식 묶음 · 출력 형식 원문 (초안)

    -

    2026-10-15 초안. 구현 · 시험 경기(6장)를 거치며 고칩니다. 지시문의 tone 자리는 말투 설정으로 바뀝니다. 자동 갱신 칸은 패치마다 다시 만듭니다.

    +

    부록프롬프트 · 지식 묶음 · 출력 형식 원문

    +

    사이트 서버가 실제로 쓰는 원문(site/server/prompt/, 지시문 v1.1). 실제 경기 분석(C4)과 시험 경기(6장)를 거치며 고칩니다. 지시문의 tone 자리는 말투 설정(중간맛)으로 바뀌고, 자동 갱신 칸은 사이트 서버가 하루에 한 번 공식 데이터로 다시 만듭니다.

    A. 지시문 prompt/system.md

    {_load('system.md')}

    B. 발로란트 지식 묶음 prompt/knowledge-valorant.md

    diff --git a/docs/report/culprit/cost_sim.py b/docs/report/culprit/cost_sim.py index 2b9660d..b7a3975 100644 --- a/docs/report/culprit/cost_sim.py +++ b/docs/report/culprit/cost_sim.py @@ -17,8 +17,9 @@ MODELS = { # ── 토큰 가정 ── # 지시문(prompt/system.md) + 게임별 지식 묶음(prompt/knowledge-*.md) + 출력 형식(prompt/output-schema.json). -# 2026-10-15 초안 글자 수로 잼: 한글 1글자=1토큰, 나머지 3글자=1토큰 (보수적) -FIXED_PROMPT = {'valorant': 3900, 'lol': 5000} +# 2026-10-15 v1.2: 토큰 세기 API(claude-opus-5-5)로 실측. 지시문 v1.1 + 지식 묶음(자동 갱신 칸 포함) + 구조화 출력 형식 +# (v1.1 초안은 글자 수로 3,900 / 5,000 으로 잡았다) +FIXED_PROMPT = {'valorant': 6649, 'lol': 8204} VOICE_LINE = 24 # "[R7 0:42] 민수: 레이즈 궁 빠졌어" 한 줄 (한글 1글자≈1토큰, 보수적) CHAT_LINE = 20 VISIBLE_OUT = 3200 # 10명 평가 + 팀별 범인 2명 근거 + 요약 (JSON) diff --git a/docs/report/culprit/img/real-list.png b/docs/report/culprit/img/real-list.png new file mode 100644 index 0000000..bdbf769 Binary files /dev/null and b/docs/report/culprit/img/real-list.png differ diff --git a/docs/report/culprit/img/real-mobile.png b/docs/report/culprit/img/real-mobile.png new file mode 100644 index 0000000..a1d4626 Binary files /dev/null and b/docs/report/culprit/img/real-mobile.png differ diff --git a/docs/report/culprit/img/real-result.png b/docs/report/culprit/img/real-result.png new file mode 100644 index 0000000..d28e714 Binary files /dev/null and b/docs/report/culprit/img/real-result.png differ diff --git a/docs/report/culprit/plan.html b/docs/report/culprit/plan.html index 13ac983..252e71f 100644 --- a/docs/report/culprit/plan.html +++ b/docs/report/culprit/plan.html @@ -1,4 +1,4 @@ -겜녹이 범인찾기 · 리플레이 동기화 계획서 v1.1 +겜녹이 범인찾기 · 리플레이 동기화 계획서 v1.2
    @@ -149,20 +150,21 @@ tr.hl td { background:#fff3f4 !important; font-weight:700; }
    AI가 경기 기록을 읽고 10명 평가 · 팀별 범인을 찾습니다.
    리플레이를 보면 그때 한 말을 시간에 맞춰 보여 줍니다.
    - + +
    프로젝트겜녹이 (Game Voice Recorder) · v1.2.2 다음 기능
    문서계획서 v1.1 · 코드 작성 전 검토용 (v1.0 + 리플레이 동기화 · 프롬프트 · 지식 묶음)
    문서계획서 v1.2 · 정해 주신 8가지 반영 (v1.1 + 결정 사항 · 실제 화면 · 토큰 실측)
    진행범인찾기 C1~C3(앱 · 사이트 서버 · 화면) 구현 완료, 배포 전 · 리플레이 동기화는 API 확인 뒤 결정
    작성일2026-10-15
    AIClaude API (Anthropic) · 기본 모델 Claude Opus 5.5
    예산API 크레딧 $100 (2026-11-15 만료)
    -
    -
    gvr.tkrmagid.kr · 화면은 시안이고 이름 · 기록은 예시입니다
    +
    +
    gvr.tkrmagid.kr · 표지 화면은 실제 구현 화면(시연 데이터 + 실제 Claude Opus 5.5 분석 결과)입니다

    1한눈에 보기

    -
    248경기
    $100로 분석할 수 있는 경기 수
    (Opus 5.5 · 가정한 조건에서
    10번 중 9번 242~253)
    -
    $0.38
    경기당 평균 비용
    (10판 중 8판은 $0.28~$0.50)
    +
    237경기
    $100로 분석할 수 있는 경기 수
    (Opus 5.5 · 가정한 조건에서
    10번 중 9번 232~242)
    +
    $0.40
    경기당 평균 비용
    (10판 중 8판은 $0.30~$0.52)
    1~2분
    버튼을 누르고 결과가 나올 때까지
    8판/일
    크레딧 만료(11/15)까지 다 쓰려면
    하루에 분석해야 하는 경기 수
    @@ -172,19 +174,22 @@ tr.hl td { background:#fff3f4 !important; font-weight:700; }
  • 팀별 범인 1명씩(우리 팀 · 상대 팀), 왜 범인인지 설명, 근거 3~4개
  • 근거마다 실제 순간(대화 · 킬 · 라운드)이 연결돼 누르면 타임라인에서 바로 듣고 볼 수 있음
  • 대상 경기: 끝났고 기록이 모두 남아 있는 경기만 고를 수 있습니다. 녹음이 중간에 시작됐거나, 경기 결과를 못 받았거나, 음성 변환이 덜 끝난 경기는 이유를 보여 주고 막습니다 (4장).
  • -
  • AI는 사이트 서버가 부릅니다. API 키는 봇 토큰처럼 서버에만 두고, exe에는 넣지 않습니다 (5장).
  • -
  • 비용: 경기 길이와 말하는 양을 무작위로 바꿔 가며 2만 경기를 계산했습니다. Opus 5.5로 $100이면 약 248경기입니다. 방이 조용하면 약 279경기, 말이 많으면 약 210경기입니다 (7장).
  • +
  • 범인: 팀마다 1명. 가장 못한 사람 + 가장 발목을 잡은 사람 + 결과(패배)의 원인을 모두 합쳐 종합으로 고릅니다 (3장).
  • +
  • AI는 사이트 서버가 부릅니다. Claude Opus 5.5 · 말투 중간맛. API 키는 받아서 서버 비밀 저장소에만 두었고, 배포 때 사이트 서버 환경 변수로만 넣습니다. exe에는 넣지 않습니다 (5장).
  • +
  • 분석 버튼은 등록된 앱 유저 이상만 누를 수 있습니다(다시 분석은 관리자). 결과는 로그인한 멤버 모두가 봅니다.
  • +
  • 비용: 경기 길이와 말하는 양을 무작위로 바꿔 가며 2만 경기를 계산했습니다. Opus 5.5로 $100이면 약 237경기입니다(지시문 · 지식 묶음 토큰을 실제로 재서 다시 계산, v1.1의 248경기에서 조정). 방이 조용하면 약 266경기, 말이 많으면 약 203경기입니다 (7장).
  • 예산 보호: 월 $100 상한, 하루 횟수 제한, 경기당 최대 약 $1 상한, 한 경기는 한 번만 분석(다시 분석은 관리자만)을 둡니다.
  • 프롬프트 · 지식 묶음은 미리 써 두었습니다: 지시문, 발로란트 · 롤 지식 묶음(규칙 · 경제 · 역할 기준 · 은어 · 음성 인식 오류 · 최신 요원 · 챔피언 목록), 출력 형식. 매 분석마다 같이 보내 AI가 “배운 상태”로 분석합니다 (6장 · 부록).
  • -
  • 리플레이 동기화: 게임 안 리플레이를 보면 exe가 알아채고, 그 경기 기록이 남아 있으면 “리플레이와 동기화하시겠습니까?”를 묻습니다. 확인하면 exe 창이 리플레이 시간에 맞춰 대화 · 이벤트를 보여 주고 음성을 들려 줍니다. 롤은 공식 리플레이 API로 시간을 읽고 옮기는 양쪽 동기화(어느 경기인지 찾는 방법은 기술 검증 필요), 발로란트는 API가 없어 화면 글자 인식(OCR)으로 한쪽 동기화이고 먼저 기술 검증이 필요합니다 (8장). AI를 쓰지 않아 비용이 없습니다.
  • +
  • 멤버 공지: 녹음 안내(TTS) 문구에 “녹음된 대화는 AI 경기 분석에 쓰일 수 있어요”를 넣었습니다. 기본 문구를 쓰던 PC는 새 문구로 자동으로 바뀝니다.
  • +
  • 리플레이 동기화: 게임 안 리플레이를 보면 exe가 알아채고 “리플레이와 동기화하시겠습니까?”를 묻는 기능입니다. 게임이 API(공식 · 비공식)로 리플레이 시간을 알려 줄 때만 넣습니다. 화면 글자 인식(OCR)이나 게임 설정 파일 고치기는 하지 않습니다. 그래서 먼저 Windows PC에서 롤 · 발로란트가 어떤 API를 주는지 확인(R0)하고, 되는 게임만 만듭니다 (8장). AI를 쓰지 않아 비용이 없습니다.
  • -
    정해 주실 것 (자세한 내용은 10장) -① "범인"의 뜻 ② 분석 버튼을 누를 수 있는 사람 ③ 모델(Opus 5.5 추천) ④ Claude API 키 발급 ⑤ 말투(순한맛/매운맛) ⑥ 멤버들에게 AI 분석을 알릴지 ⑦ 발로란트 리플레이를 OCR로 맞추는 방식 ⑧ 롤 리플레이 API를 앱이 켜 줄지
    +
    정한 것 (2026-10-15 답변 · 자세한 내용은 10장) +① 범인 = 가장 못함 + 가장 발목 + 패배 원인 종합 ② 분석 버튼 = 등록된 앱 유저 이상 ③ 모델 = Opus 5.5 ④ API 키 = 받음(서버에만) ⑤ 말투 = 중간맛 ⑥ 공지 = 녹음 안내(TTS) 문구에 추가 ⑦ 발로란트 리플레이 = API에 없으면 넣지 않음(OCR 안 함) ⑧ 롤 리플레이 = API에 없으면 넣지 않음(설정 파일 안 고침)

    목차

    1. 한눈에 보기
    2. 쓰는 흐름 · 화면 예시
    3. 범인을 고르는 기준
    4. 분석에 쓰는 기록 · 분석할 수 있는 경기
    5. -
    6. 구조 · 보안 · 개인정보
    7. 범인찾기 프롬프트 · 지식 묶음
    8. 비용 예상: $100로 몇 경기?
    9. 리플레이 동기화
    10. 만드는 순서 · 확인 방법
    11. 정해 주실 것
    12. 부록: 프롬프트 · 지식 묶음 · 출력 형식 원문
    +
  • 구조 · 보안 · 개인정보
  • 범인찾기 프롬프트 · 지식 묶음
  • 비용 예상: $100로 몇 경기?
  • 리플레이 동기화
  • 만드는 순서 · 확인 방법
  • 정한 것 · 남은 일
  • 부록: 프롬프트 · 지식 묶음 · 출력 형식 원문
  • @@ -196,13 +201,13 @@ tr.hl td { background:#fff3f4 !important; font-weight:700; }
    🧠
    AI 분석
    1~2분
    진행 단계 표시
    🚨
    결과
    팀별 범인 · 10명 평가
    모두가 같이 봄
    -
    화면 예시 1 · 범인찾기 탭 (경기 고르기) 왼쪽은 끝난 경기 목록입니다. 경기마다 분석 가능 · 분석 완료 · 준비 중 · 기록 부족을 표시하고, 기록이 부족하면 이유(“녹음이 12분 뒤에 시작됨” 등)를 보여 줍니다. 오른쪽은 고른 경기에서 분석에 쓰는 기록과 참가자 10명(음성이 있는 사람 표시), 예상 비용 · 남은 예산 · 오늘 남은 횟수입니다. 시안
    -
    화면 예시 2 · 분석 결과 (발로란트) 맨 위는 한 줄 요약, 가운데는 팀별 범인 카드(이유 + 근거), 아래는 10명 평가입니다. 근거의 대화는 ▶ 듣기로 그 문장 음성을 바로 재생하고(7일 보관 기간 안), 킬 · 라운드는 타임라인으로 이동합니다. 상대 팀처럼 음성이 없는 사람은 “게임 기록으로 판단”이라고 밝힙니다. 시안 · 이름과 기록은 예시
    +
    화면 1 · 범인찾기 탭 (경기 고르기) 왼쪽은 끝난 경기 목록입니다. 경기마다 분석 가능 · 분석 완료 · 준비 중 · 기록 부족을 표시하고, 기록이 부족하면 이유(“녹음이 12분 뒤에 시작됨” 등)를 보여 줍니다. 오른쪽은 고른 경기에서 분석에 쓰는 기록과 참가자 10명(음성이 있는 사람 표시), 예상 비용 · 남은 예산 · 오늘 남은 횟수입니다. 실제 화면 · 시연 데이터
    +
    화면 2 · 분석 결과 (발로란트) 맨 위는 한 줄 요약, 가운데는 팀별 범인 카드(이유 + 근거), 아래는 10명 평가입니다. 근거의 대화는 ▶ 듣기로 그 문장 음성을 바로 재생하고(7일 보관 기간 안), 킬 · 라운드는 타임라인으로 이동합니다. 상대 팀처럼 음성이 없는 사람은 “게임 기록으로 판단”이라고 밝힙니다. 결과 글은 실제 Claude Opus 5.5가 쓴 것입니다. 시연 데이터의 앞뒤가 안 맞는 곳을 AI가 스스로 찾아 확신도를 “낮음”으로 적었습니다. 실제 화면 · 시연 데이터
    -
    화면 예시 3 · 분석 결과 (롤, 휴대폰) 이긴 경기에서도 팀마다 범인을 뽑습니다. 휴대폰에서는 범인 카드를 먼저, 10명 평가를 아래로 이어 보여 줍니다. 시안
    +
    화면 3 · 분석 결과 (휴대폰) 이긴 경기에서도 팀마다 범인을 뽑습니다. 휴대폰에서는 요약, 범인 카드, 10명 평가를 차례로 보여 줍니다. 실제 화면 · 시연 데이터

    결과 화면에 들어가는 것

    @@ -224,8 +229,12 @@ tr.hl td { background:#fff3f4 !important; font-weight:700; }

    3범인을 고르는 기준

    -
    "범인"의 뜻 (제안 · 8장에서 확인) -팀마다 그 팀 결과에 가장 나쁜 영향을 준 1명입니다. 진 팀은 “패배 책임이 가장 큰 사람”, 이긴 팀은 “이기는 데 가장 발목을 잡은 사람”입니다. 그래서 이긴 경기에도 범인이 있습니다.
    +
    "범인"의 뜻 (정함 · ①) +팀마다 1명을 고르고, 아래 셋을 모두 합쳐 종합으로 판단합니다. 한 가지만 보지 않습니다. +
    • 가장 못한 사람: 자기 역할 · 포지션 기준으로 플레이가 가장 나빴다
    • +
    • 가장 발목을 잡은 사람: 팀의 계획 · 경제 · 콜을 가장 많이 망쳤다
    • +
    • 결과의 원인: 진 팀이면 패배에 가장 큰 책임, 이긴 팀이면 이기는 데 가장 방해가 된 사람
    +그래서 이긴 경기에도 범인이 있습니다. 범인은 그 팀에서 평점이 가장 낮아야 합니다(서버가 확인).
    @@ -245,10 +254,10 @@ tr.hl td { background:#fff3f4 !important; font-weight:700; }

    4분석에 쓰는 기록 · 분석할 수 있는 경기

    보는 것발로란트리그 오브 레전드
    플레이첫 킬 · 첫 데스, 전투 점수(ACS), 라운드당 피해량, 클러치, 스파이크 설치 · 해체, 연속 데스포지션별 기준: 라인 CS · 골드 차, 킬 관여율, 딜량 · 받은 피해, 데스 시점(오브젝트 직전 등)
    - + - - + +
    기록지금 저장하는 것범인찾기를 위해 더 저장할 것
    기록원래 저장하던 것범인찾기를 위해 더 저장 (구현 완료)
    음성 대화유저별 문장, 시각, 경기 · 라운드 연결 (텍스트는 계속 남음)없음. 음성 파일은 7일 뒤 지워져도 분석은 텍스트로 함
    발로란트 경기10명 KDA · 전투 점수 · 랭크, 라운드 결과, 라운드별 경제(쓴 돈 · 무기), 킬(무기 · 헤드샷 · 위치)라운드별 피해량, 스파이크 설치 · 해체한 사람, 스킬 사용 횟수 (Riot 경기 결과에 이미 있음, 지금은 버림)
    롤 경기10명 KDA · CS · 골드 · 아이템, 골드 차 그래프, 킬 · 오브젝트 이벤트포지션, 딜량 · 받은 피해, 시야 점수 · 와드, 분당 골드 · CS (LCU 경기 기록에 이미 있음, 지금은 버림)
    발로란트 경기10명 KDA · 전투 점수 · 랭크, 라운드 결과, 라운드별 경제(쓴 돈 · 무기), 킬(무기 · 헤드샷 · 위치)선수별 준 피해 · 헤드샷 비율 · 첫킬/첫데스 · 설치/해체 · 스킬 사용 · 요원 역할, 라운드별 공격/수비 · 장비 값 · 선수별 킬/피해
    롤 경기10명 KDA · CS · 골드 · 아이템, 골드 차 그래프, 킬 · 오브젝트 이벤트포지션(추정), 챔피언 피해 · 받은 피해, 시야 점수 · 와드 설치/제거/제어 와드, 오브젝트 · 포탑 피해, CC 시간, 10분 · 15분 CS · 골드
    채팅팀 · 전체 채팅 (API · OCR)없음
    디스코드 ↔ 게임 계정Riot ID로 누가 누구인지 연결연결 안 된 화자는 디스코드 이름으로 보내고 “게임 계정 모름”으로 표시
    @@ -281,29 +290,28 @@ tr.hl td { background:#fff3f4 !important; font-weight:700; }
    6게임 PC결과 저장 → 사이트 실시간 알림
      -
    • API 키는 사이트 서버에만 둡니다(환경 변수, root만 읽기). 봇 토큰과 같은 원칙으로, exe에도 브라우저에도 가지 않습니다. 게임 PC가 직접 부르게 하면 키가 PC에 남아 꺼낼 수 있어서 쓰지 않습니다.
    • +
    • API 키는 사이트 서버에만 둡니다(환경 변수 ANTHROPIC_API_KEY, root만 읽기). 봇 토큰과 같은 원칙으로, exe에도 브라우저에도 가지 않습니다. 게임 PC가 직접 부르게 하면 키가 PC에 남아 꺼낼 수 있어서 쓰지 않습니다.
    • 결과는 게임 PC 기록 DB에 저장합니다(새 표 culprit_analyses). 기록은 게임 PC에만 둔다는 지금 원칙을 지킵니다. 서버에는 비용 장부만 남깁니다(경기 번호 · 누른 사람 · 토큰 수 · 비용 · 시각, 대화 내용 없음).
    • 예산 장부: 서버가 매번 실제 사용량(응답의 토큰 수)으로 비용을 계산해 쌓습니다. 월 상한을 넘으면 버튼을 잠급니다. Claude Console에도 지출 한도를 걸어 두 번 막습니다.
    • -
    • AI 설정: 지시문 · 지식 묶음은 6장, Claude Opus 5.5, 생각 깊이 high, 출력은 JSON 형식 고정(구조화 출력), 출력 상한 32k 토큰. AI가 응답을 거절하면 다른 모델로 한 번 자동 재시도합니다. 실패하면 비용이 든 만큼만 기록하고, 다시 누를 수 있게 잠금을 풉니다.
    • +
    • AI 설정: 지시문 · 지식 묶음은 6장, Claude Opus 5.5, 생각 깊이 high, 말투 중간맛, 출력은 JSON 형식 고정(구조화 출력), 출력 상한 32k 토큰. AI가 응답을 거절하면 Anthropic 서버가 권장 모델로 한 번 자동 재시도합니다. 실패하면 비용이 든 만큼만 기록하고, 다시 누를 수 있게 잠금을 풉니다.

    AI에 보내는 자료 모양 (예시)

    -
    # 경기 발로란트 경쟁전 · 어센트 · 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)가 아니라 이런 줄글로 보내 토큰을 아낍니다.

    개인정보

    • 분석하면 그 경기의 대화 텍스트와 게임 기록이 Anthropic(Claude API)으로 갑니다. 음성 파일은 보내지 않습니다.
    • Claude API로 보낸 내용은 기본적으로 AI 학습에 쓰이지 않고, Anthropic 정책에 정해진 기간만 보관됩니다.
    • 녹음 제외(/녹음제외)한 사람의 대화는 원래 없으므로 보내지 않습니다. 서버 로그에는 대화 내용을 남기지 않습니다.
    • -
    • 멤버들에게 “녹음된 대화가 AI 분석에 쓰일 수 있다”고 알리기를 권합니다(10장 ⑥). 녹음 시작 안내(TTS) 문구에 한 줄 더하는 방법도 있습니다.
    • +
    • 멤버 공지(⑥): 녹음 시작 안내(TTS) 문구를 “겜녹이가 이 음성채널을 녹음합니다. 녹음된 대화는 AI 경기 분석에 쓰일 수 있어요. 녹음을 원하지 않으시면 녹음제외 명령을 입력해 주세요.”로 바꾸고 기본 음성을 다시 합성했습니다. 관리자가 문구를 직접 고친 PC는 그 문구를 그대로 둡니다.
    @@ -313,13 +321,13 @@ P9 Kiwi 상대 스카이 9/18/7 132 88 1/4 음성X
    "미리 학습"은 이렇게 합니다 Claude API는 우리가 모델을 따로 학습(파인튜닝)시킬 수 없습니다. 대신 분석할 때마다 지시문과 지식 묶음을 경기 자료 앞에 같이 보냅니다. 그래서 AI는 매번 게임 규칙 · 역할 기준 · 은어 · 음성 인식 오류를 “배운 상태”로 분석합니다. 이 부분은 경기마다 똑같아 프롬프트 캐시를 쓰면 1시간 안의 다음 분석부터 이 부분 값이 약 5%로 줄어듭니다(비용 계산에는 캐시 없이 넣었습니다).
    - - - - - + + + + +
    파일 (미리 써 둠)내용토큰(추정)
    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).

    지식 묶음 = 손으로 쓴 부분 + 패치마다 자동 갱신하는 부분

    @@ -333,7 +341,7 @@ Claude API는 우리가 모델을 따로 학습(파인튜닝)시킬 수 없습

    자동 갱신 부분 (패치마다 새로 만듦)

    • 발로란트: 요원 이름과 역할(타격대 · 척후대 · 전략가 · 감시자), 맵, 무기 가격 ← valorant-api.com 한국어
    • 롤: 챔피언 이름과 분류 ← Riot Data Dragon 한국어 (지금 16.20.1)
    • -
    • 앱 단어사전을 만드는 것과 같은 소스(tools/gen-dictionary.mjs)라 같이 갱신
    • +
    • 사이트 서버가 공식 데이터에서 하루에 한 번 새로 만들고, 못 받으면 파일의 스냅샷을 씀
    • AI가 원래 모를 수 있는 최신 요원 · 무기(믹스 · 비토 · 웨이레이 · 테호 · 워든 등)를 채워 줌
    @@ -376,46 +384,46 @@ Claude API는 우리가 모델을 따로 학습(파인튜닝)시킬 수 없습 발로란트 길이경기마다 두 팀 실력 차를 뽑고 라운드를 하나씩 진행. 13승제, 12:12면 2점 차가 날 때까지 연장. 라운드 = 구매 30초 + 교전 15~145초 + 끝 7초17~26라운드, 29~44분 (중간 36분) 롤 길이12%는 15~22분 조기 항복, 나머지는 평균 31분 ±7분 (18~60분)19~40분 (중간 30분) 말하는 양음성채널 전체가 1분에 하는 문장 수. 경기마다 무작위(중간 18문장, 조용한 방 9 · 말 많은 방 32)경기당 328~999문장 -AI 생각 길이자료가 길수록 길게, 경기마다 무작위출력 9.7k~19.2k 토큰 -게임 비율발로란트 · 롤 반반입력 17.2k~36.0k 토큰 +AI 생각 길이자료가 길수록 길게, 경기마다 무작위출력 9.9k~19.6k 토큰 +게임 비율발로란트 · 롤 반반입력 20.3k~38.9k 토큰

    이 값으로 2만 경기의 비용을 계산하고, $100을 다 쓸 때까지 분석하는 시행을 1,500번 돌렸습니다. 실패 · 다시 분석 여유로 5%를 더 잡았습니다. 계산 코드: docs/report/culprit/cost_sim.py

    -
    경기당 비용 분포 (Opus 5.5, 2만 경기)
    길고 말 많은 경기일수록 오른쪽. $0.66를 넘는 경기는 100판 중 1판입니다.
    0%5%10%$0.2$0.3$0.4$0.5$0.6$0.7$0.8평균 $0.3810판 중 9판은 $0.50 이하경기당 비용 (Claude Opus 5.5, 실패·재분석 여유 빼고)
    +
    경기당 비용 분포 (Opus 5.5, 2만 경기)
    길고 말 많은 경기일수록 오른쪽. $0.68를 넘는 경기는 100판 중 1판입니다.
    0%5%10%$0.2$0.3$0.4$0.5$0.6$0.7$0.8평균 $0.4010판 중 9판은 $0.52 이하경기당 비용 (Claude Opus 5.5, 실패·재분석 여유 빼고)

    경기 하나에 드는 토큰 (Opus 5.5, 평균)

    - - + + - - + +
    부분토큰비용설명
    지시문 · 지식 묶음 · 출력 형식약 4,450$0.0186장 파일 실측. 발로 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.066JSON
    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% 포함. 빨간 막대가 추천 설정입니다.
    Opus 5.5 · 말 많은 방
    210경기
    Opus 5.5 · 보통 (기준)
    248경기
    Opus 5.5 · 조용한 방
    279경기
    Opus 5.5 · 생각 medium
    318경기
    Sonnet 5.5 · 보통
    496경기
    Haiku 4.5 · 보통
    992경기
    +
    $100로 분석할 수 있는 경기 수
    발로 · 롤 반반, 실패 · 다시 분석 여유 5% 포함. 빨간 막대가 추천 설정입니다.
    Opus 5.5 · 말 많은 방
    203경기
    Opus 5.5 · 보통 (기준)
    237경기
    Opus 5.5 · 조용한 방
    266경기
    Opus 5.5 · 생각 medium
    301경기
    Sonnet 5.5 · 보통
    475경기
    Haiku 4.5 · 보통
    950경기
    - - - - + + + +
    설정경기당 평균$100당 경기 수 (5~95%)배치(반값)라면
    Opus 5.5 · 생각 high (추천)$0.38248 (242~253)약 496
    Opus 5.5 · 생각 medium$0.30318 (312~324)약 636
    Sonnet 5.5$0.19496약 992
    Haiku 4.5$0.10992약 1,984
    Opus 5.5 · 생각 high (추천)$0.40237 (232~242)약 474
    Opus 5.5 · 생각 medium$0.32301 (295~307)약 602
    Sonnet 5.5$0.20475약 950
    Haiku 4.5$0.10950약 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경기
    결론 -Opus 5.5로 $100이면 약 248경기(방 분위기에 따라 약 210~279경기)입니다. 경기 길이가 무작위여도 판 수가 많아 평균에 가까워지므로, 가정한 조건 안에서는 1,500번 시행 중 10번에 9번꼴로 242~253경기(5~95% 범위)가 나왔습니다. 이 범위는 계산에 넣은 가정 안의 결과이고, 실제 비용을 보장하는 범위는 아닙니다. 더 크게 흔들리는 것은 방에서 말하는 양과 AI가 생각하는 길이입니다.
    -크레딧은 11월 15일에 만료됩니다. 248경기를 다 쓰려면 하루 8판씩 분석해야 하므로, 크레딧을 아끼려고 더 싼 모델을 쓸 이유는 적습니다. 그래서 Opus 5.5를 추천합니다.
    -

    이 숫자는 아직 실제 경기 녹음이 없어 가정값으로 계산한 것입니다. 만들고 나서 실제 경기 3~5개로 토큰을 재고(토큰 세기 API는 무료) 이 표를 고칩니다.

    +Opus 5.5로 $100이면 약 237경기(방 분위기에 따라 약 203~266경기)입니다. 경기 길이가 무작위여도 판 수가 많아 평균에 가까워지므로, 가정한 조건 안에서는 1,500번 시행 중 10번에 9번꼴로 232~242경기(5~95% 범위)가 나왔습니다. 이 범위는 계산에 넣은 가정 안의 결과이고, 실제 비용을 보장하는 범위는 아닙니다. 더 크게 흔들리는 것은 방에서 말하는 양과 AI가 생각하는 길이입니다.
    +크레딧은 11월 15일에 만료됩니다. 237경기를 다 쓰려면 하루 8판씩 분석해야 하므로, 크레딧을 아끼려고 더 싼 모델을 쓸 이유는 적습니다. 그래서 Opus 5.5를 추천합니다. +

    고정 프롬프트는 실측값이고, 경기 기록 · 대화 양 · AI 생각 길이는 아직 가정값입니다. 실제 경기 3~5판을 분석하면 사이트 서버 비용 장부에 실제 토큰 · 비용이 남으므로, 그 값으로 이 표를 다시 고칩니다.

    @@ -439,28 +447,28 @@ Opus 5.5로 $100이면 약 248경기(방 분위기에 따라 약 210~279
    🔗
    동기화
    리플레이 시간 따라
    대화 · 이벤트 · 음성
    ⏩
    계속 따라감
    멈춤 · 배속 · 되감기
    모두 따라감
    -
    화면 예시 4 · 동기화 묻기 (exe 팝업) 리플레이를 틀면 exe가 그 경기의 기록을 찾아 오른쪽 위에 묻습니다. 남은 기록(대화 텍스트 · 음성 파일 · 이벤트 · 범인 분석)을 보여 주고, 음성 파일이 7일이 지나 지워졌으면 “글자만 동기화”로 바뀝니다. 뒤 배경은 자리 표시용입니다. 시안
    -
    화면 예시 5 · 동기화 창 (exe) 리플레이 시간(오른쪽 위)에 맞춰 지금 말하는 문장을 단어 단위로 짚고 음성을 들려 줍니다. 지나간 줄은 흐리게, 다음 줄은 미리 보입니다. 아래 막대는 경기 전체의 대화 · 킬 · 오브젝트 · 범인 근거 위치입니다. 롤은 줄을 누르면 리플레이가 그 시간으로 옮겨 갑니다. 시안 · 이름과 기록은 예시
    +
    정한 원칙 (⑦ · ⑧): API로 될 때만 넣습니다 +게임이 공식 · 비공식 API로 리플레이 재생 시간을 알려 줄 때만 그 게임의 동기화를 만듭니다. 화면 글자 인식(OCR)으로 시간을 읽거나, 앱이 게임 설정 파일(game.cfg)을 고치는 방법은 쓰지 않습니다. 그래서 먼저 Windows PC에서 어떤 API가 리플레이 중에 무엇을 알려 주는지 확인(R0)하고, 되는 게임만 R1~R3을 진행합니다. 둘 다 안 되면 리플레이 동기화는 넣지 않습니다.
    +
    화면 예시 4 · 동기화 묻기 (exe 팝업) 리플레이를 틀면 exe가 그 경기의 기록을 찾아 오른쪽 위에 묻습니다. 남은 기록(대화 텍스트 · 음성 파일 · 이벤트 · 범인 분석)을 보여 주고, 음성 파일이 7일이 지나 지워졌으면 “글자만 동기화”로 바뀝니다. 뒤 배경은 자리 표시용입니다. 시안 · API 확인 뒤 만듦
    +
    화면 예시 5 · 동기화 창 (exe) 리플레이 시간(오른쪽 위)에 맞춰 지금 말하는 문장을 단어 단위로 짚고 음성을 들려 줍니다. 지나간 줄은 흐리게, 다음 줄은 미리 보입니다. 아래 막대는 경기 전체의 대화 · 킬 · 오브젝트 · 범인 근거 위치입니다. 리플레이를 옮기는 API까지 있으면 줄을 눌러 리플레이를 그 시간으로 옮깁니다. 시안 · 이름과 기록은 예시
    -

    게임별로 되는 것

    +

    R0에서 확인할 것 (Windows PC, 리플레이 1판씩)

    - - - - - - - + + + + +
    리그 오브 레전드발로란트
    리플레이클라이언트 “경기 기록”에서 내려받아 재생 (.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들이 리플레이 중에 무엇을 주는지 기록 파일로 남깁니다. 그 기록으로 게임별로 만들지 정합니다.

    시간을 맞추는 원리

    @@ -471,42 +479,45 @@ Opus 5.5로 $100이면 약 248경기(방 분위기에 따라 약 210~279
  • 동기화 창: exe의 새 창입니다. 두 번째 모니터에 두거나, 📌 항상 위 · 작게 보기로 게임 옆에 띄웁니다.
  • 음성: 리플레이를 멈추면 같이 멈추고, 되감으면 그 지점부터 다시 들려 줍니다. 2배속까지는 같이 빨라지고, 더 빠르면 글자만 보여 줍니다. 여러 명이 동시에 말한 구간은 겹쳐서 재생합니다. 음성 파일이 지워진 경기는 글자만 보여 줍니다.
  • 범인 분석과 연결: 분석 결과가 있으면 범인 근거 순간에 🔍 표시를 붙입니다.
  • -
  • 보안 · 비용: 모두 이 PC 안(127.0.0.1)에서만 일어나고 사이트 서버 · 인터넷 · AI를 쓰지 않습니다. 비용 0. 게임 메모리를 읽거나 게임 파일을 고치지 않습니다(롤 설정 한 줄은 공식 방법). Riot 로컬 API의 자체 서명 인증서는 지금처럼 이 PC 안 주소에만 예외를 둡니다.
  • +
  • 보안 · 비용: 모두 이 PC 안(127.0.0.1)에서만 일어나고 사이트 서버 · 인터넷 · AI를 쓰지 않습니다. 비용 0. 게임 메모리를 읽거나 게임 파일 · 설정 파일을 고치지 않고, 화면을 읽지도 않습니다. Riot 로컬 API의 자체 서명 인증서는 지금처럼 이 PC 안 주소에만 예외를 둡니다.
  • -

    9만드는 순서 · 확인 방법

    +

    9만드는 순서 · 진행 상황

    - - - - - - - - - - + + + + + + + +
    단계할 일확인 방법
    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.

    -

    10정해 주실 것

    -
    ①"범인"의 뜻
    제안: 팀마다 1명, 진 팀은 패배 책임 1위 · 이긴 팀은 가장 발목 잡은 사람. → 다르게 원하시면(예: 진 팀만 범인 1명) 알려 주세요.
    -
    ②분석 버튼을 누를 수 있는 사람
    (가) 등록된 앱 유저 이상 (나) 관리자 이상 (다) 사이트에 로그인한 서버 멤버 전원. 결과 보기는 모두 가능. → 추천: (가). 하루 20회 제한과 같이.
    -
    ③모델
    Opus 5.5(약 248경기) · Sonnet 5.5(약 496경기). → 추천: Opus 5.5. 크레딧 만료 전에 다 쓰기 어려운 양이라 품질을 우선합니다. 크레딧이 끝난 뒤 유료로 계속 쓰신다면 그때 Sonnet 5.5와 비교하겠습니다.
    -
    ④Claude API 키
    Claude Console(크레딧이 들어온 조직)에서 API 키를 만들어 주세요. 사이트 서버에만 넣습니다. Console에서 월 지출 한도 $100도 걸어 주시면 좋습니다. → 코드 작업(C1~C3)은 키 없이 시작할 수 있고, 키는 C2 실제 호출 전에만 있으면 됩니다.
    -
    ⑤말투
    (가) 순한맛: 담백한 평가 (나) 중간맛: 가볍게 놀림, 욕설 · 인신공격 없음 (다) 매운맛: 세게 놀림, 그래도 욕설 · 인신공격 없음. → 추천: (나). 시안 문구가 (나) 수준입니다.
    -
    ⑥멤버 공지
    대화 텍스트가 Claude API로 가서 분석된다는 것을 알릴지. → 추천: 디스코드 공지 한 번 + 녹음 안내(TTS) 문구에 “AI 분석에 쓰일 수 있어요” 추가.
    -
    ⑦발로란트 리플레이 동기화 방식
    발로란트는 재생 시간을 알려 주는 API가 없어 화면 OCR로 맞춥니다. 오차 ±1초 목표, exe에서 리플레이 시간을 옮길 수는 없습니다(한쪽). → 이 방식으로 R0 검증부터 해도 될지. 검증에서 안 되면 “라운드를 고르고 같이 시작” 수동 방식으로 대신합니다. 내전 리플레이는 방장이 경기마다 시작 전에 녹화 옵션을 켜야 남습니다.
    -
    ⑧롤 Replay API 켜기
    롤 설정 파일(game.cfg)에 EnableReplayApi=1 한 줄이 있어야 리플레이 시간을 읽습니다. → 추천: 앱이 처음 한 번 동의를 받고 자동으로 넣기. 직접 넣으시려면 안내만 띄웁니다.
    +

    10정한 것 · 남은 일

    + + + + + + + + + + +
    질문답 (2026-10-15)반영
    ① "범인"의 뜻가장 못했다 + 가장 발목을 잡았다 + 패배의 원인 등 모두 종합지시문 v1.1에 세 기준을 종합하도록 넣음. 팀마다 1명, 팀 최저점(서버 확인)
    ② 분석 버튼(가) 등록된 앱 유저 이상서버가 앱 유저 명단으로 확인. 다시 분석은 관리자 이상, 결과 보기는 모두
    ③ 모델Opus 5.5Claude Opus 5.5 · 생각 깊이 high
    ④ API 키받음동작 확인. 서버 비밀 저장소에만 보관, 배포 때 사이트 서버 환경 변수로만 넣음
    ⑤ 말투(나) 중간맛기본 말투 medium
    ⑥ 멤버 공지TTS 문구에 추가녹음 안내 문구 · 기본 음성 교체 (5장)
    ⑦ 발로란트 리플레이비공식 API에 없으면 추가하지 않기OCR 안 함. R0에서 API 확인 뒤 결정 (8장)
    ⑧ 롤 리플레이비공식 API에 없으면 추가하지 않기앱이 game.cfg 를 고치지 않음. R0에서 API 확인 뒤 결정 (8장)
    +
    A배포 승인
    사이트 서버 배포(API 키 넣기)와 새 exe(v1.3.0) 릴리스를 진행해도 될지. → 승인하시면 배포하고, 새 exe로 실제 경기 3~5판을 분석해 같이 결과를 봅니다(C4).
    +
    BAPI 키 관리
    키가 디스코드 채팅에 그대로 올라왔습니다. → 그 메시지를 지워 주시고, 오래 쓰실 거면 Console에서 키를 새로 만들어 주세요. Console 월 지출 한도 $100도 걸어 두시면 사이트 서버 한도와 함께 두 번 막힙니다.
    +
    C리플레이 API 확인 (R0)
    새 exe에 “리플레이 API 확인” 기능을 같이 넣을지. → 넣으면 리플레이를 1판씩 틀고 버튼만 눌러 주시면 됩니다. 롤 Replay API를 이미 켜 둔 PC가 아니면, 롤은 클라이언트 API 결과로만 정합니다.
    -

    부록프롬프트 · 지식 묶음 · 출력 형식 원문 (초안)

    -

    2026-10-15 초안. 구현 · 시험 경기(6장)를 거치며 고칩니다. 지시문의 tone 자리는 말투 설정으로 바뀝니다. 자동 갱신 칸은 패치마다 다시 만듭니다.

    +

    부록프롬프트 · 지식 묶음 · 출력 형식 원문

    +

    사이트 서버가 실제로 쓰는 원문(site/server/prompt/, 지시문 v1.1). 실제 경기 분석(C4)과 시험 경기(6장)를 거치며 고칩니다. 지시문의 tone 자리는 말투 설정(중간맛)으로 바뀌고, 자동 갱신 칸은 사이트 서버가 하루에 한 번 공식 데이터로 다시 만듭니다.

    A. 지시문 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
      }
     }