diff --git a/README.md b/README.md index 63bcbd7..2feccea 100644 --- a/README.md +++ b/README.md @@ -6,6 +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) +- 범인찾기 탭 계획서 (코드 작성 전 검토용): [`docs/culprit-finder-plan.pdf`](docs/culprit-finder-plan.pdf) · 원본·비용 계산: `docs/report/culprit/` - **제작 완료 보고서 (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/docs/culprit-finder-plan.pdf b/docs/culprit-finder-plan.pdf new file mode 100644 index 0000000..0f9663d Binary files /dev/null and b/docs/culprit-finder-plan.pdf differ diff --git a/docs/report/culprit/build.py b/docs/report/culprit/build.py new file mode 100644 index 0000000..e782023 --- /dev/null +++ b/docs/report/culprit/build.py @@ -0,0 +1,325 @@ +"""계획서 HTML 만들기: python3 build.py (sim.json 숫자를 그대로 넣는다) → plan.html""" +import json, html +d = json.load(open('sim.json')) +src = open('../report.html').read() +STYLE = src[src.index('')] +B = d['base']; PM = d['per_model']; SC = d['scenarios']; MED = d['opus_medium'] + +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}" + +# ── 그래프 1: 경기당 비용 히스토그램 (SVG) ── +def hist_svg(): + bins = [(float(b), c) for b, c in d['hist']] + W, H, L, Bm, T = 640, 190, 44, 30, 14 + lo, hi = 0.15, 0.90 + mx = max(c for _, c in bins) + pw = W - L - 10; ph = H - Bm - T + x = lambda v: L + (v - lo) / (hi - lo) * pw + y = lambda c: T + ph - c / mx * ph + bw = 0.025 / (hi - lo) * pw + out = [f''] + for gy in range(0, int(mx) + 1, 1000): + out.append(f'') + out.append(f'{gy/d["hist_n"]*100:.0f}%') + for b, c in bins: + if b < lo or b >= hi: continue + x0 = x(b) + 1; w = bw - 2; y0 = y(c); h = T + ph - y0 + r = min(4, h / 2, w / 2) + out.append(f'') + out.append(f'') + for v in [0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8]: + out.append(f'${v:.1f}') + for v, lab in [(B['cost']['mean'], f"평균 {usd(B['cost']['mean'])}"), (B['cost']['p90'], f"10판 중 9판은 {usd(B['cost']['p90'])} 이하")]: + out.append(f'') + out.append(f'{lab}') + out.append(f'경기당 비용 (Claude Opus 5.5, 실패·재분석 여유 빼고)') + out.append('') + return ''.join(out) + +# ── 그래프 2: $100 로 분석할 수 있는 경기 수 (가로 막대) ── +def bars_html(): + rows = [ + ('Opus 5.5 · 말 많은 방', SC['loud/mix']['per100'], False), + ('Opus 5.5 · 보통 (기준)', PM['opus-5.5']['p50'], True), + ('Opus 5.5 · 조용한 방', SC['quiet/mix']['per100'], False), + ('Opus 5.5 · 생각 medium', MED['p50'], False), + ('Sonnet 5.5 · 보통', PM['sonnet-5.5']['p50'], False), + ('Haiku 4.5 · 보통', PM['haiku-4.5']['p50'], False), + ] + mx = 1050 + h = [] + for lab, v, hl in rows: + col = '#ff4655' if hl else '#2a78d6' + h.append(f'
{lab}
{v:,}경기
') + return ''.join(h) + +opus = PM['opus-5.5'] +days = 31 +per_day = opus['p50'] / days + +HTML = f'''겜녹이 범인찾기 탭 계획서 v1.0 + + +
+
+

범인찾기 탭 계획서

+
끝난 경기의 대화와 게임 기록을 AI가 읽고, 10명을 평가해 팀별 범인을 찾아 줍니다
+ + + + + + +
프로젝트겜녹이 (Game Voice Recorder) · v1.2.2 다음 기능
문서계획서 v1.0 · 코드 작성 전 검토용
작성일2026-10-15
AIClaude API (Anthropic) · 기본 모델 Claude Opus 5.5
예산API 크레딧 $100 (2026-11-15 만료)
+
+
gvr.tkrmagid.kr · 화면은 시안이고 이름 · 기록은 예시입니다
+
+ +
+

1한눈에 보기

+
+
{opus['p50']}경기
$100로 분석할 수 있는 경기 수
(Opus 5.5, 95% 범위 {opus['p5']}~{opus['p95']})
+
{usd(B['cost']['mean'])}
경기당 평균 비용
(10판 중 8판은 {usd(B['cost']['p10'])}~{usd(B['cost']['p90'])})
+
1~2분
버튼을 누르고 결과가 나올 때까지
+
{per_day:.0f}판/일
크레딧 만료(11/15)까지 다 쓰려면
하루에 분석해야 하는 경기 수
+
+ +
정해 주실 것 (자세한 내용은 8장) +① "범인"의 뜻 ② 분석 버튼을 누를 수 있는 사람 ③ 모델(Opus 5.5 추천) ④ Claude API 키 발급 ⑤ 말투(순한맛/매운맛) ⑥ 멤버들에게 AI 분석을 알릴지
+ +

목차

+
    +
  1. 한눈에 보기
  2. 쓰는 흐름 · 화면 예시
  3. 범인을 고르는 기준
  4. 분석에 쓰는 기록 · 분석할 수 있는 경기
  5. +
  6. 구조 · 보안 · 개인정보
  7. 비용 예상: $100로 몇 경기?
  8. 만드는 순서 · 확인 방법
  9. 정해 주실 것
+
+ +
+

2쓰는 흐름 · 화면 예시

+
+
🎮
경기 끝
결과 · 10명 스탯 받음
음성 변환 끝
+
🔍
범인찾기 탭
분석 가능한 경기만
고를 수 있음
+
💰
범인 분석
예상 비용 · 남은 예산
확인 후 시작
+
🧠
AI 분석
1~2분
진행 단계 표시
+
🚨
결과
팀별 범인 · 10명 평가
모두가 같이 봄
+
+
화면 예시 1 · 범인찾기 탭 (경기 고르기) 왼쪽은 끝난 경기 목록입니다. 경기마다 분석 가능 · 분석 완료 · 준비 중 · 기록 부족을 표시하고, 기록이 부족하면 이유(“녹음이 12분 뒤에 시작됨” 등)를 보여 줍니다. 오른쪽은 고른 경기에서 분석에 쓰는 기록과 참가자 10명(음성이 있는 사람 표시), 예상 비용 · 남은 예산 · 오늘 남은 횟수입니다. 시안
+
화면 예시 2 · 분석 결과 (발로란트) 맨 위는 한 줄 요약, 가운데는 팀별 범인 카드(이유 + 근거), 아래는 10명 평가입니다. 근거의 대화는 ▶ 듣기로 그 문장 음성을 바로 재생하고(7일 보관 기간 안), 킬 · 라운드는 타임라인으로 이동합니다. 상대 팀처럼 음성이 없는 사람은 “게임 기록으로 판단”이라고 밝힙니다. 시안 · 이름과 기록은 예시
+
+ +
+
+
화면 예시 3 · 분석 결과 (롤, 휴대폰) 이긴 경기에서도 팀마다 범인을 뽑습니다. 휴대폰에서는 범인 카드를 먼저, 10명 평가를 아래로 이어 보여 줍니다. 시안
+
+

결과 화면에 들어가는 것

+ + + + + + + +
칸내용
한 줄 요약경기가 어떻게 흘러갔는지 1~2문장
팀별 범인팀마다 1명. 평점, 이유 2~3문장, 근거 3~4개(대화 · 킬 · 경제 · 스탯)
10명 평가평점(10점 만점, 0.5 단위), 태그, 한 줄 평. 음성 유무 표시
분석 정보분석 시각, 모델, 쓴 문장 · 이벤트 수, 실제 비용
주의 문구“재미로 보는 AI 분석입니다. 음성 인식 오류나 기록에 없는 상황 때문에 틀릴 수 있어요.”
+

분석하는 동안

+

버튼을 누르면 결과 자리에 진행 단계가 나옵니다: 기록 모으기 → AI가 읽는 중 → 근거 확인 → 완료. 창을 닫아도 분석은 계속되고, 끝나면 사이트 실시간 알림으로 결과가 뜹니다. 같은 경기를 다른 사람이 동시에 눌러도 한 번만 돕니다.

+

결과를 보는 사람 · 다시 분석

+
    +
  • 결과는 사이트에 로그인한 서버 멤버 모두가 봅니다 (기존 기록과 같은 권한).
  • +
  • 한 경기는 한 번만 분석합니다. 다시 분석은 관리자만 할 수 있고, 이전 결과는 기록으로 남깁니다.
  • +
  • 사이트 경기 화면에도 “🔍 범인 보기” 버튼을 달아 바로 옮겨 갑니다.
  • +
+
+ +

3범인을 고르는 기준

+
"범인"의 뜻 (제안 · 8장에서 확인) +팀마다 그 팀 결과에 가장 나쁜 영향을 준 1명입니다. 진 팀은 “패배 책임이 가장 큰 사람”, 이긴 팀은 “이기는 데 가장 발목을 잡은 사람”입니다. 그래서 이긴 경기에도 범인이 있습니다.
+ + + + + +
보는 것발로란트리그 오브 레전드
플레이첫 킬 · 첫 데스, 전투 점수(ACS), 라운드당 피해량, 클러치, 스파이크 설치 · 해체, 연속 데스포지션별 기준: 라인 CS · 골드 차, 킬 관여율, 딜량 · 받은 피해, 데스 시점(오브젝트 직전 등)
팀 운영경제(혼자 장비 안 사기 · 세이브 무시), 요원 역할 수행(연막 · 정찰 · 부활)드래곤 · 바론 · 전령 · 포탑 관여, 시야 점수, 한타 합류
소통 (음성 · 채팅)정확한 콜, 콜 무시(“기다려” 뒤 혼자 진입 등), 남 탓 · 짜증, 포기 발언(“ff”), 팀 분위기를 살린 말
+

공정하게 보는 규칙 (AI 지시문에 넣음)

+ +
+ +
+

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

+ + + + + + + +
기록지금 저장하는 것범인찾기를 위해 더 저장할 것
음성 대화유저별 문장, 시각, 경기 · 라운드 연결 (텍스트는 계속 남음)없음. 음성 파일은 7일 뒤 지워져도 분석은 텍스트로 함
발로란트 경기10명 KDA · 전투 점수 · 랭크, 라운드 결과, 라운드별 경제(쓴 돈 · 무기), 킬(무기 · 헤드샷 · 위치)라운드별 피해량, 스파이크 설치 · 해체한 사람, 스킬 사용 횟수 (Riot 경기 결과에 이미 있음, 지금은 버림)
롤 경기10명 KDA · CS · 골드 · 아이템, 골드 차 그래프, 킬 · 오브젝트 이벤트포지션, 딜량 · 받은 피해, 시야 점수 · 와드, 분당 골드 · CS (LCU 경기 기록에 이미 있음, 지금은 버림)
채팅팀 · 전체 채팅 (API · OCR)없음
디스코드 ↔ 게임 계정Riot ID로 누가 누구인지 연결연결 안 된 화자는 디스코드 이름으로 보내고 “게임 계정 모름”으로 표시
+

이미 저장된 예전 경기는 지금 있는 기록만으로 분석합니다(피해량 · 시야 같은 지표 없이). 결과에 “기본 기록으로 분석”이라고 표시합니다.

+ +

"기록이 전부 남아 있는" 경기 = 아래를 모두 만족

+
+
경기가 끝났나?
아니면: 목록에 안 보임
→
+
경기 결과 상세(10명)를 받았나?
“결과 못 받음”
→
+
녹음이 경기 처음~끝을 덮나? (1분 넘게 빈 곳 없음)
“녹음이 12분 뒤에 시작됨”
→
+
그 시간 문장이 모두 텍스트로 바뀌었나?
“음성 변환 중” (잠시 뒤 가능)
→
+
분석 가능
이미 했으면 “분석 완료”
+
+
한계 +
+
+ +
+

5구조 · 보안 · 개인정보

+
+
1브라우저범인 분석 누름 → 사이트 서버
+
2사이트 서버로그인 · 권한 · 예산 · 하루 횟수 확인, 이 경기 잠금
+
3게임 PC (기존 중계)분석 가능 확인 후 분석 자료(압축 텍스트) 만들어 보냄
+
4Claude API서버가 호출 (스트리밍) · 정해진 JSON 형식으로 받음
+
5사이트 서버10명 · 근거 번호 확인, 실제 비용 기록
+
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)가 아니라 이런 줄글로 보내 토큰을 아낍니다.

+

개인정보

+ +
+ +
+

6비용 예상: $100로 몇 경기?

+

가격 (Anthropic API, 100만 토큰당)

+ + + + + +
모델입력출력(생각 포함)특징
Claude Opus 5.5 (추천)$4$20가장 꼼꼼함. 대화 · 기록을 엮어 판단하는 데 유리
Claude Sonnet 5.5$2$10절반 가격. 품질은 실측으로 비교 필요
Claude Haiku 4.5$1$5가장 쌈. 긴 대화에서 근거를 놓칠 수 있음
+

한국어는 영어보다 토큰을 많이 씁니다. 계산에서는 한글 1글자 ≈ 1토큰으로 넉넉하게 잡았습니다. 배치(최대 24시간 안에 결과)로 보내면 모든 토큰이 반값이지만, 버튼을 누르고 기다리는 기능이라 기본은 즉시 분석입니다.

+ +

경기 길이는 무작위: 이렇게 계산했습니다

+ + + + + + + +
바뀌는 값계산 방법결과 (10판 중 8판 범위)
발로란트 길이경기마다 두 팀 실력 차를 뽑고 라운드를 하나씩 진행. 13승제, 12:12면 2점 차가 날 때까지 연장. 라운드 = 구매 30초 + 교전 15~145초 + 끝 7초{B['rounds_val']['p10']}~{B['rounds_val']['p90']}라운드, {B['minutes_val']['p10']:.0f}~{B['minutes_val']['p90']:.0f}분 (중간 {B['minutes_val']['p50']:.0f}분)
롤 길이12%는 15~22분 조기 항복, 나머지는 평균 31분 ±7분 (18~60분){B['minutes_lol']['p10']:.0f}~{B['minutes_lol']['p90']:.0f}분 (중간 {B['minutes_lol']['p50']:.0f}분)
말하는 양음성채널 전체가 1분에 하는 문장 수. 경기마다 무작위(중간 18문장, 조용한 방 9 · 말 많은 방 32)경기당 {B['lines']['p10']:.0f}~{B['lines']['p90']:.0f}문장
AI 생각 길이자료가 길수록 길게, 경기마다 무작위출력 {k(B['out']['p10'])}~{k(B['out']['p90'])} 토큰
게임 비율발로란트 · 롤 반반입력 {k(B['in']['p10'])}~{k(B['in']['p90'])} 토큰
+

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

+ +
경기당 비용 분포 (Opus 5.5, 2만 경기)
길고 말 많은 경기일수록 오른쪽. {usd(B['cost']['p99'])}를 넘는 경기는 100판 중 1판입니다.
{hist_svg()}
+
+ +
+

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

+ + + + + + + + + +
부분토큰비용설명
지시문 · 평가 기준 · 용어집3,500$0.014모든 경기 같음
경기 기록 (10명 · 라운드 · 이벤트)약 6,100$0.025발로 약 8,100 · 롤 약 4,200
음성 대화약 15,200$0.061평균 {B['lines']['mean']:.0f}문장 × 24토큰. 가장 크게 흔들리는 값
채팅약 250$0.001
AI 답 (10명 평가 · 범인 · 근거)약 3,300$0.066JSON
AI 생각약 10,600$0.212출력 값으로 계산. 비용의 절반 이상
합계입력 {B['in']['mean']:,.0f} · 출력 {B['out']['mean']:,.0f}{usd(B['cost']['mean'],3)}발로 {usd(B['cost_val']['mean'])} · 롤 {usd(B['cost_lol']['mean'])}
+ +
$100로 분석할 수 있는 경기 수
발로 · 롤 반반, 실패 · 다시 분석 여유 5% 포함. 빨간 막대가 추천 설정입니다.
{bars_html()}
+ + + + + + + +
설정경기당 평균$100당 경기 수배치(반값)라면
Opus 5.5 · 생각 high (추천){usd(B['cost']['mean'])}{opus['p50']} ({opus['p5']}~{opus['p95']})약 {opus['batch_p50']}
Opus 5.5 · 생각 medium{usd(100/MED['mean']/1.05)}{MED['p50']} ({MED['p5']}~{MED['p95']})약 {MED['p50']*2:,}
Sonnet 5.5{usd(B['cost']['mean']/2)}{PM['sonnet-5.5']['p50']:,}약 {PM['sonnet-5.5']['batch_p50']:,}
Haiku 4.5{usd(B['cost']['mean']/4)}{PM['haiku-4.5']['p50']:,}약 {PM['haiku-4.5']['batch_p50']:,}
+ + + + + +
Opus 5.5 · 방 분위기별발로란트만롤만반반
조용한 방 (1분 9문장){SC['quiet/valorant']['per100']}경기{SC['quiet/lol']['per100']}경기{SC['quiet/mix']['per100']}경기
보통 (1분 18문장){SC['normal/valorant']['per100']}경기{SC['normal/lol']['per100']}경기{SC['normal/mix']['per100']}경기
말 많은 방 (1분 32문장){SC['loud/valorant']['per100']}경기{SC['loud/lol']['per100']}경기{SC['loud/mix']['per100']}경기
+
결론 +Opus 5.5로 $100이면 약 {opus['p50']}경기(방 분위기에 따라 약 {SC['loud/mix']['per100']}~{SC['quiet/mix']['per100']}경기)입니다. 경기 길이가 무작위여도 판 수가 많아 평균에 가까워지므로, 같은 조건이면 {opus['p5']}~{opus['p95']}경기 안에 거의 확실히 들어옵니다. 더 크게 흔들리는 것은 방에서 말하는 양과 AI가 생각하는 길이입니다.
+크레딧은 11월 15일에 만료됩니다. {opus['p50']}경기를 다 쓰려면 하루 {per_day:.0f}판씩 분석해야 하므로, 크레딧을 아끼려고 더 싼 모델을 쓸 이유는 적습니다. 그래서 Opus 5.5를 추천합니다.
+

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

+
+ +
+

예산이 새지 않게 막는 장치

+ + + + + + + +
장치내용
월 상한$100 (설정 가능). 넘으면 버튼 잠금, 남은 예산을 화면에 표시
경기당 상한출력 32k 토큰 상한 + 입력이 너무 길면(대화 2,500문장 넘음) 잡담 구간을 줄여서 보냄 → 경기 하나가 약 $1을 넘지 않음
하루 횟수사이트 전체 하루 20회 (설정 가능)
중복 방지한 경기 한 번. 동시에 눌러도 한 번만 실행. 다시 분석은 관리자만
두 번째 방어선Claude Console 조직 지출 한도를 $100로 설정
+ +

7만드는 순서 · 확인 방법

+ + + + + + + +
단계할 일확인 방법
C1 기록 보강경기 상세를 받을 때 피해량 · 시야 · 포지션 등 추가 지표 저장. “분석 가능” 판정. 분석 자료(압축 텍스트) 만드는 앱 API저장된 22라운드 · 롤 경기 테스트 자료로 판정 · 자료 모양 테스트. 녹음 공백 · 변환 대기 경기가 막히는지
C2 서버 분석Claude 호출, JSON 형식 고정, 근거 번호 확인, 예산 장부 · 하루 횟수 · 중복 방지, 결과를 게임 PC에 저장가짜 AI 응답으로 테스트(없는 근거 번호 · 9명만 온 응답 · 예산 초과 · 동시 클릭). 실제 Claude 1회 호출로 비용 기록 확인
C3 화면범인찾기 탭, 진행 단계, 결과 화면(PC · 휴대폰), 근거 → 타임라인 · 듣기, 경기 화면 버튼사이트 화면 캡처로 확인, 보안 정책(CSP) 켠 상태에서 동작
C4 실측 · 조정실제 경기 3~5개 분석, 결과 품질과 실제 비용 확인, 지시문 · 생각 깊이 조정, 6장 표 갱신사용자와 같이 결과 검토 (범인 판정이 납득되는지)
C5 배포사이트 서버 배포(API 키 넣기), 앱 새 버전 exe 빌드배포 전 백업, 배포 뒤 상태 확인 · 실제 분석 1회
+

앱(게임 PC)도 바뀌므로(추가 지표 저장, 분석 자료 API, 결과 저장) 새 exe가 필요합니다. 예전 exe로도 사이트는 열리지만 범인찾기는 “앱을 업데이트해 주세요”로 막습니다.

+ +

8정해 주실 것

+
①"범인"의 뜻
제안: 팀마다 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 분석에 쓰일 수 있어요” 추가.
+
+''' +open('plan.html', 'w').write(HTML) +print('ok', len(HTML)) diff --git a/docs/report/culprit/cost_sim.py b/docs/report/culprit/cost_sim.py new file mode 100644 index 0000000..542d213 --- /dev/null +++ b/docs/report/culprit/cost_sim.py @@ -0,0 +1,138 @@ +"""범인찾기 분석 비용 몬테카를로 추정 (계획서용). + +경기 길이·말하는 양·모델 생각 길이를 무작위로 뽑아 경기당 토큰과 비용을 만들고, +$100 을 다 쓸 때까지 경기를 분석하는 시행을 여러 번 돌려 분석 가능 경기 수 분포를 낸다. +결과는 JSON 으로 stdout 에 쓴다. python3 cost_sim.py > sim.json +""" +import json, math, random, statistics as st + +R = random.Random(20261015) + +# ── 가격 ($ / 1M tokens, Anthropic 1st-party, 2026-09-25 기준) ── +MODELS = { + 'opus-5.5': {'in': 4.0, 'out': 20.0, 'label': 'Claude Opus 5.5'}, + 'sonnet-5.5': {'in': 2.0, 'out': 10.0, 'label': 'Claude Sonnet 5.5'}, + 'haiku-4.5': {'in': 1.0, 'out': 5.0, 'label': 'Claude Haiku 4.5'}, +} + +# ── 토큰 가정 ── +FIXED_PROMPT = 3500 # 지시문 + 평가 기준 + 출력 형식 + 게임 용어집 +VOICE_LINE = 24 # "[R7 0:42] 민수: 레이즈 궁 빠졌어" 한 줄 (한글 1글자≈1토큰, 보수적) +CHAT_LINE = 20 +VISIBLE_OUT = 3200 # 10명 평가 + 팀별 범인 2명 근거 + 요약 (JSON) +TALK = { # 음성채널 전체 분당 문장 수 (5명 기준) 중앙값 + 'quiet': 9, 'normal': 18, 'loud': 32, +} + +def lognorm(median, sigma): + return median * math.exp(R.gauss(0, sigma)) + +def clamp(x, a, b): + return max(a, min(b, x)) + +def valorant_match(): + """13승제 경쟁전. 경기마다 팀 실력 차를 뽑고 라운드를 하나씩 진행, 12:12 이후 2점 차 연장.""" + p = R.uniform(0.35, 0.65) + a = b = 0 + rounds = 0 + secs = 60 # 시작 전 · 끝 화면 + while True: + rounds += 1 + secs += 30 + clamp(R.gauss(62, 22), 15, 145) + 7 # 구매 + 교전 + 종료 + if R.random() < p: a += 1 + else: b += 1 + if a >= 12 and b >= 12: + if abs(a - b) >= 2: break + elif a == 13 or b == 13: + break + minutes = secs / 60 + data = 800 + rounds * 340 # 10명 표 + 라운드당 킬·경제·피해량·결과 + chat = int(minutes * 0.3) + return 'valorant', minutes, rounds, data, chat + +def lol_match(): + """솔로/자유 랭크 + 내전. 12% 는 15~22분 조기 항복, 나머지는 평균 31분.""" + if R.random() < 0.12: + minutes = R.uniform(15, 22) + else: + minutes = clamp(R.gauss(31, 7), 18, 60) + data = 900 + minutes * 110 # 10명 표(아이템·피해량·시야) + 분당 킬·오브젝트·2분 단위 골드/CS + chat = int(minutes * 0.5) + return 'lol', minutes, None, data, chat + +def one_match(game_mix=0.5, talk='normal', effort='high'): + g = valorant_match() if R.random() < game_mix else lol_match() + game, minutes, rounds, data, chat = g + per_min = clamp(lognorm(TALK[talk], 0.35), 2, 70) + lines = int(per_min * minutes) + tin = FIXED_PROMPT + data + lines * VOICE_LINE + chat * CHAT_LINE + think_med = {'medium': 4000, 'high': 8000}[effort] + think = clamp(lognorm(think_med + 0.08 * tin, 0.35), 1500, 30000) + tout = VISIBLE_OUT * R.uniform(0.85, 1.2) + think + return {'game': game, 'minutes': minutes, 'rounds': rounds, 'lines': lines, 'in': tin, 'out': tout} + +def cost(m, model, batch=False): + c = (m['in'] * MODELS[model]['in'] + m['out'] * MODELS[model]['out']) / 1e6 + return c * (0.5 if batch else 1.0) + +RETRY = 1.05 # 실패·재분석 여유 5% + +def matches_per_budget(model, budget=100.0, trials=4000, **kw): + counts = [] + for _ in range(trials): + spent, n = 0.0, 0 + while True: + c = cost(one_match(**kw), model) * RETRY + if spent + c > budget: break + spent += c; n += 1 + counts.append(n) + counts.sort() + q = lambda f: counts[int(f * (len(counts) - 1))] + return {'p5': q(0.05), 'p50': q(0.5), 'p95': q(0.95), 'mean': st.mean(counts)} + +def pct(xs, f): + xs = sorted(xs); return xs[int(f * (len(xs) - 1))] + +out = {} +# 1) 기준 시나리오 표본 (Opus 5.5, 발로·롤 반반, 보통 수다, effort high) +sample = [one_match() for _ in range(20000)] +for m in sample: m['cost'] = cost(m, 'opus-5.5') +def summ(xs): + return {k: round(pct(xs, f), 4) for k, f in (('p10', .1), ('p50', .5), ('p90', .9), ('p99', .99))} | {'mean': round(st.mean(xs), 4)} +out['base'] = { + 'minutes_val': summ([m['minutes'] for m in sample if m['game'] == 'valorant']), + 'rounds_val': summ([m['rounds'] for m in sample if m['game'] == 'valorant']), + 'minutes_lol': summ([m['minutes'] for m in sample if m['game'] == 'lol']), + 'lines': summ([m['lines'] for m in sample]), + 'in': summ([m['in'] for m in sample]), + 'out': summ([m['out'] for m in sample]), + 'cost': summ([m['cost'] for m in sample]), + 'cost_val': summ([m['cost'] for m in sample if m['game'] == 'valorant']), + 'cost_lol': summ([m['cost'] for m in sample if m['game'] == 'lol']), +} +# 히스토그램 (경기당 비용, $0.025 간격) +bins = {} +for m in sample: + b = round(math.floor(m['cost'] / 0.025) * 0.025, 3); bins[b] = bins.get(b, 0) + 1 +out['hist'] = sorted(bins.items()) +out['hist_n'] = len(sample) + +# 2) 모델별 $100 경기 수 (보통, 반반) +out['per_model'] = {} +for mk in MODELS: + r = matches_per_budget(mk, trials=1500) + r['batch_p50'] = round(r['p50'] * 2) # 배치는 모든 토큰 50% → 경기 수 2배 + out['per_model'][mk] = r +# 3) 수다 정도 × 게임 (Opus 5.5) +out['scenarios'] = {} +for talk in ('quiet', 'normal', 'loud'): + for mix, name in ((1.0, 'valorant'), (0.0, 'lol'), (0.5, 'mix')): + xs = [] + for _ in range(6000): + m = one_match(game_mix=mix, talk=talk); xs.append(cost(m, 'opus-5.5')) + mean = st.mean(xs) + out['scenarios'][f'{talk}/{name}'] = {'mean': round(mean, 4), 'p90': round(pct(xs, .9), 4), + 'per100': int(100 / (mean * RETRY))} +# 4) effort medium (Opus 5.5) +out['opus_medium'] = matches_per_budget('opus-5.5', trials=1500, effort='medium') +print(json.dumps(out, ensure_ascii=False, indent=1)) diff --git a/docs/report/culprit/img/culprit-list.png b/docs/report/culprit/img/culprit-list.png new file mode 100644 index 0000000..6433457 Binary files /dev/null and b/docs/report/culprit/img/culprit-list.png differ diff --git a/docs/report/culprit/img/culprit-mobile-lol.png b/docs/report/culprit/img/culprit-mobile-lol.png new file mode 100644 index 0000000..ce0dfb9 Binary files /dev/null and b/docs/report/culprit/img/culprit-mobile-lol.png differ diff --git a/docs/report/culprit/img/culprit-result.png b/docs/report/culprit/img/culprit-result.png new file mode 100644 index 0000000..5ed3ca8 Binary files /dev/null and b/docs/report/culprit/img/culprit-result.png differ diff --git a/docs/report/culprit/mock/common.css b/docs/report/culprit/mock/common.css new file mode 100644 index 0000000..dbc25de --- /dev/null +++ b/docs/report/culprit/mock/common.css @@ -0,0 +1,18 @@ +@import url("../../mock/base.css"); +body{width:1440px;height:900px;overflow:hidden;display:flex;flex-direction:column} +header{height:62px;flex:none;display:flex;align-items:center;gap:14px;padding:0 22px;border-bottom:2px solid;border-image:linear-gradient(90deg,var(--accent),var(--lol) 60%,transparent) 1;background:linear-gradient(90deg,#0f1b26,#0b141c)} +.search{width:250px;background:var(--panel);border:1px solid var(--line);border-radius:8px;padding:8px 12px;color:var(--muted);margin-left:18px} +.conn{margin-left:auto;display:flex;align-items:center;gap:6px;font-size:12px;color:#7fe0b8;background:#0f2a22;border:1px solid #1d5141;border-radius:999px;padding:5px 10px} +.me{display:flex;align-items:center;gap:6px;font-size:13px;color:#c9d1dc} +.chip.new{position:relative} +.chip.new:after{content:"NEW";position:absolute;top:-7px;right:-8px;font-size:9px;font-weight:800;background:var(--gold);color:#1b1f27;border-radius:5px;padding:0 4px} +.panel{background:var(--panel);border:1px solid var(--line);border-radius:14px;padding:16px} +.panel h4{font-size:13px;color:var(--muted);letter-spacing:.5px;margin-bottom:12px;display:flex;justify-content:space-between;align-items:center;font-weight:500} +.ag{width:30px;height:30px;border-radius:6px;background:#26384a;vertical-align:middle;flex:none} +.tag{display:inline-block;font-size:11.5px;font-weight:700;padding:2px 8px;border-radius:6px} +.tag.ok{background:#0f2a22;color:#7fe0b8;border:1px solid #1d5141} +.tag.done{background:#2a2410;color:var(--gold);border:1px solid #5a4a1d} +.tag.no{background:#2a1418;color:#ff8a94;border:1px solid #5a2029} +.tag.wait{background:#182634;color:#9fb0c0;border:1px solid var(--line)} +.tag.val{background:#3a141a;color:#ff8a94} +.tag.lol{background:#2a2414;color:var(--lol)} diff --git a/docs/report/culprit/mock/culprit-list.html b/docs/report/culprit/mock/culprit-list.html new file mode 100644 index 0000000..3b8dfe9 --- /dev/null +++ b/docs/report/culprit/mock/culprit-list.html @@ -0,0 +1,84 @@ + + +
+
겜녹이
GAME VOICE RECORDER
+ 타임라인경기유저단어사전🔍 범인찾기 + +
● 게임 PC 연결됨
승승한
+
+
+
+

끝난 경기 · 범인 분석할 경기를 고르세요최근 7일

+
전체발로란트롤분석 가능만
+
VAL
어센트
경쟁전 · 오늘 22:41 · 44분 · 24라운드
11 : 13분석 가능
+
LoL
소환사의 협곡
내전 · 오늘 21:55 · 38분
승분석 완료
+
VAL
바인드
경쟁전 · 오늘 21:02 · 33분 · 19라운드
13 : 6분석 가능
+
LoL
소환사의 협곡
솔로 랭크 · 오늘 20:11 · 19분 (항복)
패분석 가능
+
VAL
로터스
경쟁전 · 어제 23:30 · 녹음이 12분 뒤에 시작됨
13 : 10기록 부족
+
LoL
소환사의 협곡
솔로 랭크 · 어제 22:48 · 결과 못 받음
패기록 부족
+
VAL
헤이븐
스파이크 러시 · 어제 22:10 · 음성 변환 중
2 : 4준비 중
+
+
+
+ +
VALORANT · 경쟁전
+
어센트 11 : 13 패배
+
오늘 22:41 시작 · 44분 12초 · 24라운드
음성채널 #발로 음성방 · 4명 녹음
+
+
+
+

분석에 쓰는 기록모두 있음

+
✓경기 결과 · 10명 스탯 · 라운드별 경제24라운드
+
✓킬 · 스파이크 · 라운드 결과 이벤트211개
+
✓음성 대화 (텍스트 변환 완료)742문장
+
✓인게임 채팅 (팀 · 전체)18개
+
✓녹음이 경기 시작부터 끝까지 이어짐100%
+
음성 파일은 7일 뒤 지워져도 괜찮습니다. 분석은 텍스트로 합니다.
+
+
+

참가자 10명음성 = 대화 기록 있음

+
승한 음성우리 팀 · 제트
+
민수 음성우리 팀 · 소바
+
지우 음성우리 팀 · 세이지
+
현우 음성우리 팀 · 오멘
+
Duck#KR3우리 팀 · 피닉스
+
상대 팀 5명: Lumi · Nox · Mint · Kiwi · Haru 게임 기록 · 채팅만
+
+
+
+ 🔍 범인 분석 +
예상 비용 약 $0.45 · 1~2분 걸림
이번 달 남은 분석 예산 $81.30 / $100 · 오늘 남은 횟수 17회
+
한 경기는 한 번만 분석하고
결과는 모두가 같이 봅니다
+
+
+

최근 범인 판정전체 보기 →

+
LoL내전 · 오늘 21:55 · 승우리 팀 민수 (리 신) · 상대 팀 Mint (가렌)
+
VAL스플릿 · 어제 21:40 · 13:8 승우리 팀 지우 (세이지) · 상대 팀 Haru (레이나)
+
LoL솔로 랭크 · 어제 20:05 · 패우리 팀 현우 (아리) · 상대 팀 Nox (쓰레쉬)
+
+
+
diff --git a/docs/report/culprit/mock/culprit-mobile-lol.html b/docs/report/culprit/mock/culprit-mobile-lol.html new file mode 100644 index 0000000..ca32ec9 --- /dev/null +++ b/docs/report/culprit/mock/culprit-mobile-lol.html @@ -0,0 +1,59 @@ + + +
겜녹이
🔍 범인찾기승
+
+
+
범인 분석 · LEAGUE OF LEGENDS
+
소환사의 협곡 승리
+
내전 · 38분 · 킬 31 : 24 · 대화 655문장
+
초반 드래곤 세 개를 내줘 끌려갔지만, 32분 바론 앞 한타를 아리가 뒤집어 승리.
+
+
+
우리 팀 범인
+
민수리 신 · 정글 · 3/7/9
평점 4.0 / 10
+
드래곤 네 번 중 세 번을 시야 없이 싸우다 내줬다. 8분에 "용 가자"는 콜을 듣고도 혼자 탑 갱을 갔다.
+
8:12지우 민수야 용 같이 하자 바텀 밀었어
+
8:20민수 아니 탑 갱 각이야 잠깐만
+
9:02상대 팀 바다 드래곤 처치 · 시야 점수 팀 최저 (19)
+
+
+
상대 팀 범인
+
Mint#7777가렌 · 탑 · 1/8/3
평점 3.0 / 10 · 게임 기록으로 판단
+
라인전에서 다섯 번 죽어 탑 1차·2차 포탑을 15분 안에 내줬다. 바론 한타에 텔레포트 없이 늦게 합류.
+
+
우리 팀
+
승한아리캐리9.0 · 11/2/8
바론 한타 매혹 세 명. 콜도 정확했다.
+
지우쓰레쉬숨은 MVP7.5 · 1/5/19
시야 점수 1위. 용 콜을 가장 먼저 했다.
+
현우이즈리얼무난7.0 · 8/4/9
안정적. 딜량 팀 2위.
+
준호다리우스무난6.5 · 8/5/4
라인전 압승, 한타 진입은 한 박자 빨랐다.
+
민수리 신범인4.0 · 3/7/9
드래곤 세 개 헌납. 콜 무시 2회.
+
상대 팀 · 음성 없음
+
Lumi르블랑캐리8.0 · 9/4/5
+
… Kiwi 6.5 · Haru 6.0 · Nox 5.5 · Mint 3.0 범인
+
diff --git a/docs/report/culprit/mock/culprit-result.html b/docs/report/culprit/mock/culprit-result.html new file mode 100644 index 0000000..2cf9dd5 --- /dev/null +++ b/docs/report/culprit/mock/culprit-result.html @@ -0,0 +1,93 @@ + + +
+
겜녹이
GAME VOICE RECORDER
+ 타임라인경기유저단어사전🔍 범인찾기 + +
● 게임 PC 연결됨
승승한
+
+
+
+ +
범인 분석 · VALORANT
+
어센트 11 : 13 패배
+
한 줄 요약
11:9 까지 앞섰지만 마지막 네 라운드를 내리 내줘 역전패. 그중 세 라운드가 B 메인 단독 진입으로 시작됐다. 상대는 레이즈 진입과 레이나 클러치로 버텼다.
+
분석 오늘 23:31 · 742문장 · 이벤트 211개
Claude Opus 5.5 · 비용 $0.41
↻ 다시 분석 (관리자)
+
+
+
+
우리 팀 범인
+
현우오멘 · 14 / 19 / 6 · ACS 171
평점 3.5 / 10
범인
+
마지막 네 라운드 중 세 번(R21·R23·R24)을 혼자 B 메인으로 먼저 들어가 첫 데스. 팀이 "기다려"라고 두 번 말했는데 그대로 진입했고, 첫 데스 7회로 팀에서 가장 많다. 스모크도 R22 리테이크에서 늦게 깔려 수적 우위를 잃었다.
+
R21 0:22대화승한 현우야 같이 가 기다려 둘 있어▶ 듣기
+
R21 0:25대화현우 아 그냥 간다 내가 뚫을게▶ 듣기
+
R21 0:29킬Nox (사이퍼) ▶ 현우 · 첫 데스, 덫에 걸림타임라인 →
+
경기 전체스탯첫 데스 7회 (팀 1위) · 첫 킬 2회스코어보드 →
+
+
+
상대 팀 범인
+
Kiwi#KR9스카이 · 9 / 18 / 7 · ACS 132
평점 3.0 / 10 · 음성 없음, 게임 기록으로 판단
범인
+
10명 중 ACS 가장 낮고, 상대가 이긴 13라운드 중 Kiwi 가 기여(킬·어시스트·생존)한 라운드는 5번뿐. R15 에 혼자 장비를 안 사서 4:5 로 싸웠고, 같은 라운드에 전체 채팅으로 "ff" 를 쳤다. 팀이 이긴 건 Lumi 와 Haru 덕분.
+
R15 0:00경제Kiwi 혼자 900 크레딧 사용 (팀 평균 4,200)라운드 →
+
R15 1:12채팅전체 Kiwi ff 그냥타임라인 →
+
R17 0:41킬승한 (제트) ▶ Kiwi · 혼자 A 메인 정찰하다 잡힘타임라인 →
+
경기 전체스탯ACS 132 (10명 중 10위) · 피해량 라운드당 88스코어보드 →
+
+
+
+
+

우리 팀 5명 평가평점 · 한 줄 평

+
승한제트 · 음성 O
24/15/5
ACS 272
8.5캐리
오퍼레이터 첫 킬 8회. 콜도 가장 많고 정확했다. 후반에 혼자 남아도 끝까지 침착.
+
지우세이지 · 음성 O
12/16/13
ACS 168
7.5숨은 MVP
부활 5번 중 3번이 라운드 승리로 이어짐. 킬은 적어도 벽 타이밍이 좋았다.
+
민수소바 · 음성 O
16/17/9
ACS 204
7.0무난
정찰 화살 정보 콜이 꾸준했다. R14 리테이크는 민수 드론 정보로 이김.
+
Duck#KR3피닉스 · 음성 X
15/17/4
ACS 196
5.5무난
음성채널에 없어 기록으로만 봄. 스탯은 평균, 세이브 라운드에 무기를 사서 경제가 두 번 꼬임.
+
현우오멘 · 음성 O
14/19/6
ACS 171
3.5범인
막판 단독 진입 3번. 콜을 듣지 않은 게 결정적.
+
+
+

상대 팀 5명 평가음성 없음 · 게임 기록 + 채팅

+
Lumi#KR1레이즈
22/16/5
ACS 261
8.5캐리
진입 첫 킬 7회. 마지막 네 라운드 모두 첫 교전에서 이김.
+
Haru#KR2레이나
19/15/3
ACS 238
8.0클러치
1대2 클러치 2번 (R19·R24). 마지막 라운드를 끝낸 사람.
+
Nox#0420사이퍼
15/16/8
ACS 197
7.0무난
B 메인 덫으로 현우 첫 데스를 세 번 만들어 냄.
+
Mint#7777브리치
13/17/12
ACS 174
6.0무난
어시스트 12로 팀 1위. 스킬로 진입을 도왔지만 킬 마무리가 약함.
+
Kiwi#KR9스카이
9/18/7
ACS 132
3.0범인
ACS 꼴찌, 혼자 장비 안 사기, 전체 채팅 "ff". 팀이 업고 이김.
+
+
+
⚠ 재미로 보는 AI 분석입니다. 음성 인식 오류나 기록에 없는 상황 때문에 틀릴 수 있어요.근거를 누르면 그 순간의 대화·킬을 타임라인에서 바로 듣고 볼 수 있습니다
+
diff --git a/docs/report/culprit/mock/header.inc b/docs/report/culprit/mock/header.inc new file mode 100644 index 0000000..56a6bf4 --- /dev/null +++ b/docs/report/culprit/mock/header.inc @@ -0,0 +1,6 @@ +
+
겜녹이
GAME VOICE RECORDER
+ 타임라인경기유저단어사전🔍 범인찾기 + +
● 게임 PC 연결됨
승승한
+
diff --git a/docs/report/culprit/plan.html b/docs/report/culprit/plan.html new file mode 100644 index 0000000..8798632 --- /dev/null +++ b/docs/report/culprit/plan.html @@ -0,0 +1,395 @@ +겜녹이 범인찾기 탭 계획서 v1.0 + + +
+
+

범인찾기 탭 계획서

+
끝난 경기의 대화와 게임 기록을 AI가 읽고, 10명을 평가해 팀별 범인을 찾아 줍니다
+ + + + + + +
프로젝트겜녹이 (Game Voice Recorder) · v1.2.2 다음 기능
문서계획서 v1.0 · 코드 작성 전 검토용
작성일2026-10-15
AIClaude API (Anthropic) · 기본 모델 Claude Opus 5.5
예산API 크레딧 $100 (2026-11-15 만료)
+
+
gvr.tkrmagid.kr · 화면은 시안이고 이름 · 기록은 예시입니다
+
+ +
+

1한눈에 보기

+
+
251경기
$100로 분석할 수 있는 경기 수
(Opus 5.5, 95% 범위 245~257)
+
$0.38
경기당 평균 비용
(10판 중 8판은 $0.28~$0.50)
+
1~2분
버튼을 누르고 결과가 나올 때까지
+
8판/일
크레딧 만료(11/15)까지 다 쓰려면
하루에 분석해야 하는 경기 수
+
+ +
정해 주실 것 (자세한 내용은 8장) +① "범인"의 뜻 ② 분석 버튼을 누를 수 있는 사람 ③ 모델(Opus 5.5 추천) ④ Claude API 키 발급 ⑤ 말투(순한맛/매운맛) ⑥ 멤버들에게 AI 분석을 알릴지
+ +

목차

+
    +
  1. 한눈에 보기
  2. 쓰는 흐름 · 화면 예시
  3. 범인을 고르는 기준
  4. 분석에 쓰는 기록 · 분석할 수 있는 경기
  5. +
  6. 구조 · 보안 · 개인정보
  7. 비용 예상: $100로 몇 경기?
  8. 만드는 순서 · 확인 방법
  9. 정해 주실 것
+
+ +
+

2쓰는 흐름 · 화면 예시

+
+
🎮
경기 끝
결과 · 10명 스탯 받음
음성 변환 끝
+
🔍
범인찾기 탭
분석 가능한 경기만
고를 수 있음
+
💰
범인 분석
예상 비용 · 남은 예산
확인 후 시작
+
🧠
AI 분석
1~2분
진행 단계 표시
+
🚨
결과
팀별 범인 · 10명 평가
모두가 같이 봄
+
+
화면 예시 1 · 범인찾기 탭 (경기 고르기) 왼쪽은 끝난 경기 목록입니다. 경기마다 분석 가능 · 분석 완료 · 준비 중 · 기록 부족을 표시하고, 기록이 부족하면 이유(“녹음이 12분 뒤에 시작됨” 등)를 보여 줍니다. 오른쪽은 고른 경기에서 분석에 쓰는 기록과 참가자 10명(음성이 있는 사람 표시), 예상 비용 · 남은 예산 · 오늘 남은 횟수입니다. 시안
+
화면 예시 2 · 분석 결과 (발로란트) 맨 위는 한 줄 요약, 가운데는 팀별 범인 카드(이유 + 근거), 아래는 10명 평가입니다. 근거의 대화는 ▶ 듣기로 그 문장 음성을 바로 재생하고(7일 보관 기간 안), 킬 · 라운드는 타임라인으로 이동합니다. 상대 팀처럼 음성이 없는 사람은 “게임 기록으로 판단”이라고 밝힙니다. 시안 · 이름과 기록은 예시
+
+ +
+
+
화면 예시 3 · 분석 결과 (롤, 휴대폰) 이긴 경기에서도 팀마다 범인을 뽑습니다. 휴대폰에서는 범인 카드를 먼저, 10명 평가를 아래로 이어 보여 줍니다. 시안
+
+

결과 화면에 들어가는 것

+ + + + + + + +
칸내용
한 줄 요약경기가 어떻게 흘러갔는지 1~2문장
팀별 범인팀마다 1명. 평점, 이유 2~3문장, 근거 3~4개(대화 · 킬 · 경제 · 스탯)
10명 평가평점(10점 만점, 0.5 단위), 태그, 한 줄 평. 음성 유무 표시
분석 정보분석 시각, 모델, 쓴 문장 · 이벤트 수, 실제 비용
주의 문구“재미로 보는 AI 분석입니다. 음성 인식 오류나 기록에 없는 상황 때문에 틀릴 수 있어요.”
+

분석하는 동안

+

버튼을 누르면 결과 자리에 진행 단계가 나옵니다: 기록 모으기 → AI가 읽는 중 → 근거 확인 → 완료. 창을 닫아도 분석은 계속되고, 끝나면 사이트 실시간 알림으로 결과가 뜹니다. 같은 경기를 다른 사람이 동시에 눌러도 한 번만 돕니다.

+

결과를 보는 사람 · 다시 분석

+
    +
  • 결과는 사이트에 로그인한 서버 멤버 모두가 봅니다 (기존 기록과 같은 권한).
  • +
  • 한 경기는 한 번만 분석합니다. 다시 분석은 관리자만 할 수 있고, 이전 결과는 기록으로 남깁니다.
  • +
  • 사이트 경기 화면에도 “🔍 범인 보기” 버튼을 달아 바로 옮겨 갑니다.
  • +
+
+ +

3범인을 고르는 기준

+
"범인"의 뜻 (제안 · 8장에서 확인) +팀마다 그 팀 결과에 가장 나쁜 영향을 준 1명입니다. 진 팀은 “패배 책임이 가장 큰 사람”, 이긴 팀은 “이기는 데 가장 발목을 잡은 사람”입니다. 그래서 이긴 경기에도 범인이 있습니다.
+ + + + + +
보는 것발로란트리그 오브 레전드
플레이첫 킬 · 첫 데스, 전투 점수(ACS), 라운드당 피해량, 클러치, 스파이크 설치 · 해체, 연속 데스포지션별 기준: 라인 CS · 골드 차, 킬 관여율, 딜량 · 받은 피해, 데스 시점(오브젝트 직전 등)
팀 운영경제(혼자 장비 안 사기 · 세이브 무시), 요원 역할 수행(연막 · 정찰 · 부활)드래곤 · 바론 · 전령 · 포탑 관여, 시야 점수, 한타 합류
소통 (음성 · 채팅)정확한 콜, 콜 무시(“기다려” 뒤 혼자 진입 등), 남 탓 · 짜증, 포기 발언(“ff”), 팀 분위기를 살린 말
+

공정하게 보는 규칙 (AI 지시문에 넣음)

+ +
+ +
+

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

+ + + + + + + +
기록지금 저장하는 것범인찾기를 위해 더 저장할 것
음성 대화유저별 문장, 시각, 경기 · 라운드 연결 (텍스트는 계속 남음)없음. 음성 파일은 7일 뒤 지워져도 분석은 텍스트로 함
발로란트 경기10명 KDA · 전투 점수 · 랭크, 라운드 결과, 라운드별 경제(쓴 돈 · 무기), 킬(무기 · 헤드샷 · 위치)라운드별 피해량, 스파이크 설치 · 해체한 사람, 스킬 사용 횟수 (Riot 경기 결과에 이미 있음, 지금은 버림)
롤 경기10명 KDA · CS · 골드 · 아이템, 골드 차 그래프, 킬 · 오브젝트 이벤트포지션, 딜량 · 받은 피해, 시야 점수 · 와드, 분당 골드 · CS (LCU 경기 기록에 이미 있음, 지금은 버림)
채팅팀 · 전체 채팅 (API · OCR)없음
디스코드 ↔ 게임 계정Riot ID로 누가 누구인지 연결연결 안 된 화자는 디스코드 이름으로 보내고 “게임 계정 모름”으로 표시
+

이미 저장된 예전 경기는 지금 있는 기록만으로 분석합니다(피해량 · 시야 같은 지표 없이). 결과에 “기본 기록으로 분석”이라고 표시합니다.

+ +

"기록이 전부 남아 있는" 경기 = 아래를 모두 만족

+
+
경기가 끝났나?
아니면: 목록에 안 보임
→
+
경기 결과 상세(10명)를 받았나?
“결과 못 받음”
→
+
녹음이 경기 처음~끝을 덮나? (1분 넘게 빈 곳 없음)
“녹음이 12분 뒤에 시작됨”
→
+
그 시간 문장이 모두 텍스트로 바뀌었나?
“음성 변환 중” (잠시 뒤 가능)
→
+
분석 가능
이미 했으면 “분석 완료”
+
+
한계 +
+
+ +
+

5구조 · 보안 · 개인정보

+
+
1브라우저범인 분석 누름 → 사이트 서버
+
2사이트 서버로그인 · 권한 · 예산 · 하루 횟수 확인, 이 경기 잠금
+
3게임 PC (기존 중계)분석 가능 확인 후 분석 자료(압축 텍스트) 만들어 보냄
+
4Claude API서버가 호출 (스트리밍) · 정해진 JSON 형식으로 받음
+
5사이트 서버10명 · 근거 번호 확인, 실제 비용 기록
+
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)가 아니라 이런 줄글로 보내 토큰을 아낍니다.

+

개인정보

+ +
+ +
+

6비용 예상: $100로 몇 경기?

+

가격 (Anthropic API, 100만 토큰당)

+ + + + + +
모델입력출력(생각 포함)특징
Claude Opus 5.5 (추천)$4$20가장 꼼꼼함. 대화 · 기록을 엮어 판단하는 데 유리
Claude Sonnet 5.5$2$10절반 가격. 품질은 실측으로 비교 필요
Claude Haiku 4.5$1$5가장 쌈. 긴 대화에서 근거를 놓칠 수 있음
+

한국어는 영어보다 토큰을 많이 씁니다. 계산에서는 한글 1글자 ≈ 1토큰으로 넉넉하게 잡았습니다. 배치(최대 24시간 안에 결과)로 보내면 모든 토큰이 반값이지만, 버튼을 누르고 기다리는 기능이라 기본은 즉시 분석입니다.

+ +

경기 길이는 무작위: 이렇게 계산했습니다

+ + + + + + + +
바뀌는 값계산 방법결과 (10판 중 8판 범위)
발로란트 길이경기마다 두 팀 실력 차를 뽑고 라운드를 하나씩 진행. 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.1k 토큰
게임 비율발로란트 · 롤 반반입력 15.8k~35.3k 토큰
+

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

+ +
경기당 비용 분포 (Opus 5.5, 2만 경기)
길고 말 많은 경기일수록 오른쪽. $0.65를 넘는 경기는 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, 평균)

+ + + + + + + + + +
부분토큰비용설명
지시문 · 평가 기준 · 용어집3,500$0.014모든 경기 같음
경기 기록 (10명 · 라운드 · 이벤트)약 6,100$0.025발로 약 8,100 · 롤 약 4,200
음성 대화약 15,200$0.061평균 635문장 × 24토큰. 가장 크게 흔들리는 값
채팅약 250$0.001
AI 답 (10명 평가 · 범인 · 근거)약 3,300$0.066JSON
AI 생각약 10,600$0.212출력 값으로 계산. 비용의 절반 이상
합계입력 25,129 · 출력 13,916$0.379발로 $0.40 · 롤 $0.36
+ +
$100로 분석할 수 있는 경기 수
발로 · 롤 반반, 실패 · 다시 분석 여유 5% 포함. 빨간 막대가 추천 설정입니다.
Opus 5.5 · 말 많은 방
214경기
Opus 5.5 · 보통 (기준)
251경기
Opus 5.5 · 조용한 방
282경기
Opus 5.5 · 생각 medium
324경기
Sonnet 5.5 · 보통
503경기
Haiku 4.5 · 보통
1,006경기
+ + + + + + + +
설정경기당 평균$100당 경기 수배치(반값)라면
Opus 5.5 · 생각 high (추천)$0.38251 (245~257)약 502
Opus 5.5 · 생각 medium$0.29324 (317~330)약 648
Sonnet 5.5$0.19503약 1,006
Haiku 4.5$0.091,006약 2,012
+ + + + + +
Opus 5.5 · 방 분위기별발로란트만롤만반반
조용한 방 (1분 9문장)270경기298경기282경기
보통 (1분 18문장)239경기266경기251경기
말 많은 방 (1분 32문장)201경기229경기214경기
+
결론 +Opus 5.5로 $100이면 약 251경기(방 분위기에 따라 약 214~282경기)입니다. 경기 길이가 무작위여도 판 수가 많아 평균에 가까워지므로, 같은 조건이면 245~257경기 안에 거의 확실히 들어옵니다. 더 크게 흔들리는 것은 방에서 말하는 양과 AI가 생각하는 길이입니다.
+크레딧은 11월 15일에 만료됩니다. 251경기를 다 쓰려면 하루 8판씩 분석해야 하므로, 크레딧을 아끼려고 더 싼 모델을 쓸 이유는 적습니다. 그래서 Opus 5.5를 추천합니다.
+

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

+
+ +
+

예산이 새지 않게 막는 장치

+ + + + + + + +
장치내용
월 상한$100 (설정 가능). 넘으면 버튼 잠금, 남은 예산을 화면에 표시
경기당 상한출력 32k 토큰 상한 + 입력이 너무 길면(대화 2,500문장 넘음) 잡담 구간을 줄여서 보냄 → 경기 하나가 약 $1을 넘지 않음
하루 횟수사이트 전체 하루 20회 (설정 가능)
중복 방지한 경기 한 번. 동시에 눌러도 한 번만 실행. 다시 분석은 관리자만
두 번째 방어선Claude Console 조직 지출 한도를 $100로 설정
+ +

7만드는 순서 · 확인 방법

+ + + + + + + +
단계할 일확인 방법
C1 기록 보강경기 상세를 받을 때 피해량 · 시야 · 포지션 등 추가 지표 저장. “분석 가능” 판정. 분석 자료(압축 텍스트) 만드는 앱 API저장된 22라운드 · 롤 경기 테스트 자료로 판정 · 자료 모양 테스트. 녹음 공백 · 변환 대기 경기가 막히는지
C2 서버 분석Claude 호출, JSON 형식 고정, 근거 번호 확인, 예산 장부 · 하루 횟수 · 중복 방지, 결과를 게임 PC에 저장가짜 AI 응답으로 테스트(없는 근거 번호 · 9명만 온 응답 · 예산 초과 · 동시 클릭). 실제 Claude 1회 호출로 비용 기록 확인
C3 화면범인찾기 탭, 진행 단계, 결과 화면(PC · 휴대폰), 근거 → 타임라인 · 듣기, 경기 화면 버튼사이트 화면 캡처로 확인, 보안 정책(CSP) 켠 상태에서 동작
C4 실측 · 조정실제 경기 3~5개 분석, 결과 품질과 실제 비용 확인, 지시문 · 생각 깊이 조정, 6장 표 갱신사용자와 같이 결과 검토 (범인 판정이 납득되는지)
C5 배포사이트 서버 배포(API 키 넣기), 앱 새 버전 exe 빌드배포 전 백업, 배포 뒤 상태 확인 · 실제 분석 1회
+

앱(게임 PC)도 바뀌므로(추가 지표 저장, 분석 자료 API, 결과 저장) 새 exe가 필요합니다. 예전 exe로도 사이트는 열리지만 범인찾기는 “앱을 업데이트해 주세요”로 막습니다.

+ +

8정해 주실 것

+
①"범인"의 뜻
제안: 팀마다 1명, 진 팀은 패배 책임 1위 · 이긴 팀은 가장 발목 잡은 사람. → 다르게 원하시면(예: 진 팀만 범인 1명) 알려 주세요.
+
②분석 버튼을 누를 수 있는 사람
(가) 등록된 앱 유저 이상 (나) 관리자 이상 (다) 사이트에 로그인한 서버 멤버 전원. 결과 보기는 모두 가능. → 추천: (가). 하루 20회 제한과 같이.
+
③모델
Opus 5.5(약 251경기) · Sonnet 5.5(약 503경기). → 추천: Opus 5.5. 크레딧 만료 전에 다 쓰기 어려운 양이라 품질을 우선합니다. 크레딧이 끝난 뒤 유료로 계속 쓰신다면 그때 Sonnet 5.5와 비교하겠습니다.
+
④Claude API 키
Claude Console(크레딧이 들어온 조직)에서 API 키를 만들어 주세요. 사이트 서버에만 넣습니다. Console에서 월 지출 한도 $100도 걸어 주시면 좋습니다. → 코드 작업(C1~C3)은 키 없이 시작할 수 있고, 키는 C2 실제 호출 전에만 있으면 됩니다.
+
⑤말투
(가) 순한맛: 담백한 평가 (나) 중간맛: 가볍게 놀림, 욕설 · 인신공격 없음 (다) 매운맛: 세게 놀림, 그래도 욕설 · 인신공격 없음. → 추천: (나). 시안 문구가 (나) 수준입니다.
+
⑥멤버 공지
대화 텍스트가 Claude API로 가서 분석된다는 것을 알릴지. → 추천: 디스코드 공지 한 번 + 녹음 안내(TTS) 문구에 “AI 분석에 쓰일 수 있어요” 추가.
+
+ \ No newline at end of file diff --git a/docs/report/culprit/shot.sh b/docs/report/culprit/shot.sh new file mode 100755 index 0000000..f6946ec --- /dev/null +++ b/docs/report/culprit/shot.sh @@ -0,0 +1,6 @@ +#!/bin/bash +# usage: shot.sh name width height -> img/name.png (2x) +cd "$(dirname "$0")" +timeout 60 google-chrome --headless=new --no-sandbox --disable-gpu --hide-scrollbars --force-device-scale-factor=2 \ + --allow-file-access-from-files --window-size=$2,$3 --virtual-time-budget=2000 --screenshot="img/$1.png" "file://$PWD/mock/$1.html" >/dev/null 2>&1 +echo "img/$1.png $(python3 -c "import struct;f=open('img/$1.png','rb').read(24);print(struct.unpack('>II',f[16:24]))")" diff --git a/docs/report/culprit/sim.json b/docs/report/culprit/sim.json new file mode 100644 index 0000000..e11b092 --- /dev/null +++ b/docs/report/culprit/sim.json @@ -0,0 +1,266 @@ +{ + "base": { + "minutes_val": { + "p10": 29.3394, + "p50": 36.2882, + "p90": 43.739, + "p99": 54.1754, + "mean": 36.5895 + }, + "rounds_val": { + "p10": 17, + "p50": 21, + "p90": 26, + "p99": 32, + "mean": 21.528 + }, + "minutes_lol": { + "p10": 18.7417, + "p50": 29.9091, + "p90": 39.6212, + "p99": 47.1489, + "mean": 29.6607 + }, + "lines": { + "p10": 328, + "p50": 588, + "p90": 999, + "p99": 1523, + "mean": 634.7355 + }, + "in": { + "p10": 15800.3972, + "p50": 24217.1618, + "p90": 35324, + "p99": 48322.1539, + "mean": 25128.5557 + }, + "out": { + "p10": 9650.849, + "p50": 13288.3905, + "p90": 19078.5312, + "p99": 26282.002, + "mean": 13916.0662 + }, + "cost": { + "p10": 0.2791, + "p50": 0.366, + "p90": 0.4955, + "p99": 0.6537, + "mean": 0.3788 + }, + "cost_val": { + "p10": 0.298, + "p50": 0.386, + "p90": 0.5167, + "p99": 0.6725, + "mean": 0.399 + }, + "cost_lol": { + "p10": 0.2646, + "p50": 0.346, + "p90": 0.4671, + "p99": 0.6248, + "mean": 0.3586 + } + }, + "hist": [ + [ + 0.15, + 1 + ], + [ + 0.175, + 21 + ], + [ + 0.2, + 155 + ], + [ + 0.225, + 521 + ], + [ + 0.25, + 1064 + ], + [ + 0.275, + 1806 + ], + [ + 0.3, + 2293 + ], + [ + 0.325, + 2505 + ], + [ + 0.35, + 2497 + ], + [ + 0.375, + 2188 + ], + [ + 0.4, + 1831 + ], + [ + 0.425, + 1441 + ], + [ + 0.45, + 1044 + ], + [ + 0.475, + 741 + ], + [ + 0.5, + 585 + ], + [ + 0.525, + 403 + ], + [ + 0.55, + 280 + ], + [ + 0.575, + 212 + ], + [ + 0.6, + 128 + ], + [ + 0.625, + 72 + ], + [ + 0.65, + 68 + ], + [ + 0.675, + 48 + ], + [ + 0.7, + 30 + ], + [ + 0.725, + 25 + ], + [ + 0.75, + 20 + ], + [ + 0.775, + 13 + ], + [ + 0.8, + 4 + ], + [ + 0.825, + 2 + ], + [ + 0.85, + 1 + ], + [ + 0.875, + 1 + ] + ], + "hist_n": 20000, + "per_model": { + "opus-5.5": { + "p5": 245, + "p50": 251, + "p95": 257, + "mean": 251.102, + "batch_p50": 502 + }, + "sonnet-5.5": { + "p5": 495, + "p50": 503, + "p95": 511, + "mean": 503.106, + "batch_p50": 1006 + }, + "haiku-4.5": { + "p5": 995, + "p50": 1006, + "p95": 1019, + "mean": 1006.3846666666667, + "batch_p50": 2012 + } + }, + "scenarios": { + "quiet/valorant": { + "mean": 0.3527, + "p90": 0.4537, + "per100": 270 + }, + "quiet/lol": { + "mean": 0.3185, + "p90": 0.4155, + "per100": 298 + }, + "quiet/mix": { + "mean": 0.3369, + "p90": 0.4391, + "per100": 282 + }, + "normal/valorant": { + "mean": 0.3973, + "p90": 0.5136, + "per100": 239 + }, + "normal/lol": { + "mean": 0.3579, + "p90": 0.4694, + "per100": 266 + }, + "normal/mix": { + "mean": 0.3794, + "p90": 0.4957, + "per100": 251 + }, + "loud/valorant": { + "mean": 0.4724, + "p90": 0.6183, + "per100": 201 + }, + "loud/lol": { + "mean": 0.4158, + "p90": 0.5539, + "per100": 229 + }, + "loud/mix": { + "mean": 0.445, + "p90": 0.5884, + "per100": 214 + } + }, + "opus_medium": { + "p5": 317, + "p50": 324, + "p95": 330, + "mean": 324.1053333333333 + } +} diff --git a/docs/report/mock/assets/SOURCES.md b/docs/report/mock/assets/SOURCES.md index cf7c768..67cd18d 100644 --- a/docs/report/mock/assets/SOURCES.md +++ b/docs/report/mock/assets/SOURCES.md @@ -15,3 +15,7 @@ All images are Riot Games property, used under Riot's "Legal Jibber Jabber" fan- - game→map: map spans x -120..14870, y -120..14980 (y axis flipped on the image) - c-*.png: Data Dragon /cdn/16.20.1/img/champion/.png - o-*.png: Community Dragon https://raw.communitydragon.org/latest/game/assets/ux/minimap/icons/ + +## 2026-10-15 추가 (범인찾기 계획서 시안) +- val/a-phoenix.png · a-breach.png · a-cypher.png · a-skye.png · a-viper.png: valorant-api.com /v1/agents displayIcon +- lol/c-Jinx.png · c-Lux.png · c-Darius.png: Data Dragon /cdn/16.20.1/img/champion/.png diff --git a/docs/report/mock/assets/lol/c-Darius.png b/docs/report/mock/assets/lol/c-Darius.png new file mode 100644 index 0000000..f6aec06 Binary files /dev/null and b/docs/report/mock/assets/lol/c-Darius.png differ diff --git a/docs/report/mock/assets/lol/c-Jinx.png b/docs/report/mock/assets/lol/c-Jinx.png new file mode 100644 index 0000000..b69c142 Binary files /dev/null and b/docs/report/mock/assets/lol/c-Jinx.png differ diff --git a/docs/report/mock/assets/lol/c-Lux.png b/docs/report/mock/assets/lol/c-Lux.png new file mode 100644 index 0000000..87737e6 Binary files /dev/null and b/docs/report/mock/assets/lol/c-Lux.png differ diff --git a/docs/report/mock/assets/val/a-breach.png b/docs/report/mock/assets/val/a-breach.png new file mode 100644 index 0000000..de6c44a Binary files /dev/null and b/docs/report/mock/assets/val/a-breach.png differ diff --git a/docs/report/mock/assets/val/a-cypher.png b/docs/report/mock/assets/val/a-cypher.png new file mode 100644 index 0000000..3aa5c7f Binary files /dev/null and b/docs/report/mock/assets/val/a-cypher.png differ diff --git a/docs/report/mock/assets/val/a-phoenix.png b/docs/report/mock/assets/val/a-phoenix.png new file mode 100644 index 0000000..69fd87d Binary files /dev/null and b/docs/report/mock/assets/val/a-phoenix.png differ diff --git a/docs/report/mock/assets/val/a-skye.png b/docs/report/mock/assets/val/a-skye.png new file mode 100644 index 0000000..eaa12b7 Binary files /dev/null and b/docs/report/mock/assets/val/a-skye.png differ diff --git a/docs/report/mock/assets/val/a-viper.png b/docs/report/mock/assets/val/a-viper.png new file mode 100644 index 0000000..e4dd1bb Binary files /dev/null and b/docs/report/mock/assets/val/a-viper.png differ