Compare commits
20 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
be893173a1 | ||
|
|
dc546951b5 | ||
|
|
f8916829e1 | ||
|
|
685e6a7ebe | ||
|
|
1cf7d7ebce | ||
|
|
dc67f2105b | ||
|
|
de64f9818d | ||
|
|
b22e55cc64 | ||
|
|
639cb73a3c | ||
|
|
2bb7d9909b | ||
|
|
1429f74074 | ||
|
|
6721db23ac | ||
|
|
b90a895501 | ||
|
|
68e0b43b77 | ||
|
|
6a03c67b54 | ||
|
|
a2487e6241 | ||
|
|
c2a5547a68 | ||
|
|
4d31cfc16a | ||
|
|
165fc3a710 | ||
|
|
35d2cab792 |
43
README.md
@@ -6,9 +6,52 @@
|
||||
- 게임 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.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`)
|
||||
|
||||
## 로그인 · 관리자 (v1.2.0~)
|
||||
|
||||
- exe 는 **등록된 디스코드 계정으로 로그인**해야 열린다. 로그인 버튼 → 브라우저에서 디스코드 로그인 → 사이트 서버(gvr.tkrmagid.kr)가 등록 명단을 확인한다. 등록되지 않은 아이디면 "등록되지 않은 아이디입니다"와 디스코드 아이디를 보여 주고 앱을 열지 않는다.
|
||||
- 역할: **최고 관리자**(`293719842274541579`, `1352267557213573160`, 서버에 고정) · **관리자** · **유저**. 유저 등록 · 역할 변경 · 등록 해제는 최고 관리자만, 등록 명단 보기와 관리자 전용 설정은 관리자도 할 수 있다.
|
||||
- 설정 창 **🛡️ 관리자** 탭(관리자에게만 보임): 유저 등록(디스코드 아이디 + 역할), 등록 계정 목록(역할 · 마지막 접속 · 앱 버전 · 등록한 사람), 관리자 전용 기능 목록.
|
||||
- 관리자 전용 (일반 유저 화면에서는 🔒 잠김, 메인 프로세스에서도 막음): 다른 봇으로 바꾸기 · 봇 토큰, 녹음 안내(TTS) 끄기 · 문구, 음성 보관 기간, 사이트 서버 주소 · PC 이름 · 등록/해제, 학습 데이터 삭제, 파인튜닝.
|
||||
- 앱은 시작할 때와 10분마다 등록 여부를 다시 확인한다. 등록이 해제되면 바로 잠그고 봇 · 녹음 · 사이트 연결을 멈춘다. 사이트 서버에 못 붙으면 마지막 확인 뒤 3일까지는 그대로 쓴다.
|
||||
- 서버 쪽: `site/server/src/app-auth.ts` (`/auth/app/*`, `/app/me`, `/app/admin/users`), 앱 쪽: `app/src/core/auth.ts`, 권한 목록: `app/src/core/roles.ts`. 로그인 E2E: `app/scripts/login-e2e.mts`.
|
||||
|
||||
## 디스코드 봇
|
||||
|
||||
- 기본은 **겜녹이 봇으로 진행**: 토큰을 넣지 않아도 로그인만 하면 바로 연결된다. 봇은 사이트 서버가 디스코드에 연결하고, 앱은 로그인 토큰으로 서버 중계(`/app/bot/ws`)를 받는다.
|
||||
- **다른 봇으로 진행하기**(관리자만)를 고르면 직접 만든 봇 토큰을 넣는다 (암호화 저장). v1.0.0 에서 토큰을 넣어 쓰던 설치는 다른 봇 모드로 그대로 이어진다.
|
||||
- v1.2.1 부터 **겜녹이 봇 토큰은 사이트 서버 밖으로 나가지 않는다** (v1.1.0 은 exe 에 감춰 넣었고, v1.2.0 은 로그인한 유저에게 내려줬다). 등록된 유저의 PC 에도 토큰이 없어서 PC 를 뒤지거나 통신을 가로채도 꺼낼 수 없다.
|
||||
음성채널에 들어갈 때 서버가 디스코드에서 받은 일회용 음성 접속 정보만 그 PC 에 넘기고, 음성은 PC ↔ 디스코드로 바로 간다. 사이트 서버가 꺼져 있으면 겜녹이 봇은 쓸 수 없다 (다른 봇 모드는 상관없음). 구조: [`docs/dev/ARCHITECTURE.md` 8장](docs/dev/ARCHITECTURE.md)
|
||||
- 빌드에 비밀값이 필요 없어 공개 릴리스에 올려도 된다. 등록되지 않은 사람은 exe 를 받아도 겜녹이 봇을 쓸 수 없다.
|
||||
|
||||
## 통신 · 데이터 보안 (v1.2.2~)
|
||||
|
||||
- 앱 ↔ 사이트 서버(로그인 토큰 · 기기 키 · 기록 중계 · 봇 중계)는 **https/wss 만** 쓴다. 사이트 서버 주소를 http 로 바꾸면 거절하고 아무것도 보내지 않는다 (이 PC 안 127.0.0.1 · localhost 만 예외, 개발용). `app/src/core/util/secure-url.ts`
|
||||
- 사이트 서버 인증서는 앱에 들어 있는 Mozilla 루트 인증서로만 검증하고 검증을 끌 수 없다. `NODE_TLS_REJECT_UNAUTHORIZED=0`, Windows 인증서 저장소에 깐 가짜 루트 인증서(감시 · 프록시 프로그램)로는 통신을 엿볼 수 없다. 검증 끄기 변수는 시작할 때 지워서 사이트 밖 통신도 검증한다. `app/src/core/util/secure-http.ts`
|
||||
- 겜녹이 봇 중계 권한: 앱 유저가 가입한 디스코드 서버, 그 유저가 볼 수 있는 채널만 보이고, 그 유저가 들어갈 수 있는 음성채널에만 봇을 부를 수 있다.
|
||||
- 게임 연동(Riot 로컬 API)의 자체 서명 인증서 예외는 이 PC 안 주소에만 쓴다. Riot 원격 API 등 바깥 주소는 항상 인증서를 검증한다.
|
||||
- exe(Electron) 잠금: `NODE_OPTIONS` · `NODE_EXTRA_CA_CERTS`(가짜 인증서를 끼워 통신을 엿보는 데 쓰임) · `ELECTRON_RUN_AS_NODE` · `--inspect` 를 무시하고 `app.asar` 만 읽는다 (Electron fuses). 설정 창은 앱 화면만 띄우고 바깥 주소는 브라우저로 연다. 권한 요청(마이크 · 카메라 등)은 거절한다.
|
||||
- 사이트 서버: 보안 정책(CSP)으로 이 사이트 스크립트와 이 사이트로의 접속만 허용, 실시간 WebSocket 은 이 사이트에서 온 연결만, 로그인 세션 · 앱 토큰 · 기기 키는 해시로만 저장, 로그에서 로그인 code · state · 검색어를 지운다. 등록 코드 대입 · 로그인 요청 폭주는 IP 별로 막는다. HSTS · http→https 이동 · TLS 1.2 미만 차단은 앞단 프록시(NPMplus)가 한다.
|
||||
- 디스코드 음성은 디스코드 자체 암호화(DAVE 종단간 암호화)로 간다.
|
||||
|
||||
## 🔍 범인찾기 (v1.3.0~)
|
||||
|
||||
끝난 경기를 고르고 "범인 분석"을 누르면 AI(Claude)가 그 경기의 음성 대화 · 킬 · 라운드/오브젝트 · 경제 · 채팅 · 10명 스탯을 읽고 10명 평점 · 태그 · 한 줄 평과 팀별 범인 1명(이유 + 근거)을 만든다. 근거를 누르면 그 순간의 음성 · 타임라인으로 간다. 계획서: [`docs/culprit-finder-plan.pdf`](docs/culprit-finder-plan.pdf)
|
||||
|
||||
- 정한 것 (2026-10-15): 범인 = 가장 못함 + 가장 발목 + 결과의 원인을 종합해 팀마다 1명 · 분석 버튼은 등록된 앱 유저 이상(다시 분석은 관리자) · Claude Opus 5.5(생각 high) · 말투 중간맛 · 녹음 안내(TTS)에 "녹음된 대화는 AI 경기 분석에 쓰일 수 있어요" 추가
|
||||
- **전적 사이트 점수 참고**: 평점과 범인은 전적 사이트 점수에서 출발해 승부처 · 역할 · 경제 · 음성 소통으로 더하고 뺀다 (지시문 v1.2)
|
||||
- **기록 점수** (0~10, 모든 경기): OP.GG OP스코어를 우리 기록으로 다시 계산한 점수 + 경기/팀 순위 + MVP · ACE + 점수를 올리고 깎은 지표. 발로란트는 OP.GG 가 밝힌 입력(라운드 승률 · KAST · ACS · 피해 격차), 롤은 킬 관여 · 데스 · 딜/받은 피해/골드 비중 · CS · 레벨 · CC · 와드. 계수는 OP.GG 공식 MCP 로 받은 실제 경기의 OP스코어에 맞췄다 (교차 검증: 발로란트 상관 0.97 · 평균 오차 0.49점, 롤 상관 0.94 · 0.60점 · 팀 최하위 일치 85%). `packages/shared/src/rating.ts`, 맞추는 도구 `tools/opscore-fit/`
|
||||
- **OP.GG 실제 OP스코어**: 분석할 때 OP.GG 공식 MCP(`mcp-api.op.gg`)에서 그 경기를 찾으면 그 사이트의 실제 점수를 같이 준다 (롤: 시작 시각 · 길이로 찾고 10명, 발로란트: 경기 번호로 선수마다). 내전(사용자 설정 게임)은 OP.GG 에 없어 기록 점수만 쓴다. `site/server/src/opgg.ts`, 끄기 `CULPRIT_OPGG=0`
|
||||
- **LOL.PS 라인전**: 롤 15분에 맞라인 상대와 CS · 골드 · 경험치 차
|
||||
- 실제 E2E (2026-10-15, `app/scripts/culprit-real-e2e.mts`): 실제 Claude Opus 5.5(생각 high) + 실제 OP.GG. 발로란트 시연 경기 42초 · $0.15, 롤 실제 랭크 경기(OP.GG 점수 10명 찾음) 36초 · $0.11. 기록 · [`docs/dev/test-results.md`](docs/dev/test-results.md)
|
||||
- 리플레이 동기화: 공식 · 비공식 API 로 리플레이 시간을 읽을 수 있을 때만 넣는다 (화면 글자 인식(OCR) · 게임 설정 파일 고치기는 하지 않음). Windows 실기 확인 전이라 v1.3.0 에는 없다
|
||||
- 앱: 경기 상세에서 추가 지표 저장(발로란트 피해량 · 받은 피해 · KAST · 첫킬 · 설치/해체 · 라운드별 장비, 롤 포지션 · 딜량 · 시야 · 10/15분 CS), "분석할 수 있는 경기" 판정(경기 결과 · 녹음 공백 1분 · 음성 변환), 근거 번호가 달린 AI 자료 만들기, 결과 저장(`culprit_analyses`). `app/src/core/culprit.ts`
|
||||
- 사이트 서버: Claude API 키는 서버 환경 변수 `ANTHROPIC_API_KEY` 에만 (`deploy/site/set-anthropic-key.sh`). 권한 · 월 $100 · 하루 20회 · 중복 잠금, 구조화 출력, 근거 번호 확인, 비용 장부(토큰 · 비용만, 대화 내용 없음). `site/server/src/culprit.ts`, 지시문 · 지식 묶음 `site/server/prompt/` (지식 묶음의 요원 · 챔피언 목록은 공식 데이터로 하루 한 번 갱신)
|
||||
- 화면: 사이트 🔍 범인찾기 탭 (`site/web/src/pages/CulpritPage.tsx`), 경기 화면의 "🔍 범인 보기". 화면 확인: `node --import tsx app/scripts/culprit-shots.mts`
|
||||
|
||||
## 진행 현황
|
||||
|
||||
| 단계 | 내용 | 상태 |
|
||||
|
||||
@@ -10,6 +10,7 @@ fs.writeFileSync(
|
||||
'// 자동 생성: schema.sql 사본 (npm run build 가 다시 만든다)\nexport const SCHEMA_SQL = ' + JSON.stringify(fs.readFileSync(path.join(root, 'src/core/db/schema.sql'), 'utf8')) + ';\n',
|
||||
);
|
||||
fs.rmSync(path.join(root, 'dist'), { recursive: true, force: true });
|
||||
// 겜녹이 기본 봇 토큰은 exe 에 넣지 않는다. 로그인한 등록 유저에게 사이트 서버가 내려준다 (src/core/auth.ts)
|
||||
const common = { bundle: true, platform: 'node', target: 'node22', format: 'cjs', sourcemap: true, alias: { '@gvr/shared': shared }, logLevel: 'info' };
|
||||
await build({ ...common, entryPoints: ['src/main/main.ts'], outfile: 'dist/main.cjs', packages: 'external', external: ['electron'] });
|
||||
await build({ ...common, entryPoints: ['src/main/preload.ts'], outfile: 'dist/preload.cjs', external: ['electron'] });
|
||||
|
||||
4
app/package-lock.json
generated
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "gvr-app",
|
||||
"version": "1.0.0",
|
||||
"version": "1.3.0",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "gvr-app",
|
||||
"version": "1.0.0",
|
||||
"version": "1.3.0",
|
||||
"license": "UNLICENSED",
|
||||
"dependencies": {
|
||||
"@discordjs/voice": "^0.19.2",
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "gvr-app",
|
||||
"productName": "겜녹이",
|
||||
"version": "1.0.0",
|
||||
"version": "1.3.0",
|
||||
"description": "겜녹이 (Game Voice Recorder) - 게임 연동 디스코드 음성 기록",
|
||||
"private": true,
|
||||
"main": "dist/main.cjs",
|
||||
@@ -54,6 +54,13 @@
|
||||
"package.json"
|
||||
],
|
||||
"asar": true,
|
||||
"electronFuses": {
|
||||
"runAsNode": false,
|
||||
"enableNodeOptionsEnvironmentVariable": false,
|
||||
"enableNodeCliInspectArguments": false,
|
||||
"onlyLoadAppFromAsar": true,
|
||||
"enableCookieEncryption": true
|
||||
},
|
||||
"asarUnpack": [
|
||||
"node_modules/better-sqlite3/**",
|
||||
"node_modules/@snazzah/**",
|
||||
|
||||
215
app/scripts/culprit-real-e2e.mts
Normal file
@@ -0,0 +1,215 @@
|
||||
// 범인찾기 실제 E2E: 실제 앱 코어 + 실제 사이트 서버 + 실제 Claude API(Opus 5.5, 생각 high) + 실제 OP.GG MCP + 헤드리스 브라우저.
|
||||
// 1) 발로란트 시연 경기 (22라운드 · 대화) → OP.GG 에 없는 경기 → 기록 점수만으로 분석
|
||||
// 2) 롤: OP.GG 에서 받은 실제 랭크 경기(10명 실제 스탯)에 우리 팀 2명의 대화를 붙인 경기 → OP.GG 실제 OP스코어를 찾아 같이 분석
|
||||
// 비용이 든다 (경기당 약 $0.4). API 키는 secrets.json 에서 읽어 이 프로세스 안에서만 쓴다.
|
||||
// node --import tsx scripts/culprit-real-e2e.mts [결과 폴더]
|
||||
import fs from 'node:fs';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import type { CulpritInput, CulpritMatchInfo, MatchPlayer } from '@gvr/shared';
|
||||
import { culpritApi, MIN, seedValorant, setup } from '../test/fixtures/culprit-seed.ts';
|
||||
|
||||
const outDir = process.argv[2] || path.join(os.homedir(), '.tmp', 'culprit-real');
|
||||
fs.mkdirSync(outDir, { recursive: true });
|
||||
const root = path.resolve(import.meta.dirname, '..', '..');
|
||||
const apiKey = JSON.parse(fs.readFileSync(path.join(os.homedir(), '.config/ejclaw/secrets.json'), 'utf8')).credentials['anthropic.api/game-voice-recorder'].token as string;
|
||||
const { opggCaller } = await import('../../site/server/src/opgg.ts');
|
||||
const opgg = opggCaller();
|
||||
|
||||
const core = setup();
|
||||
await core.assets.refresh(true).catch(() => undefined);
|
||||
const { id: valId } = seedValorant(core);
|
||||
|
||||
// ---------------------------------------------------------------- 롤: OP.GG 의 실제 랭크 경기
|
||||
const POS: Record<string, string> = { TOP: '탑', JUNGLE: '정글', MID: '미드', ADC: '원딜', SUPPORT: '서폿' };
|
||||
const listOf = async (name: string, tag: string) =>
|
||||
((await opgg('lol_list_summoner_matches', { game_name: name, tag_line: tag, region: 'KR', limit: 10, desired_output_fields: ['data.game_history[].{created_at,game_length_second,game_type,id}'] })) as any).data.game_history as any[];
|
||||
const detailOf = async (g: any) =>
|
||||
((await opgg('lol_get_summoner_game_detail', {
|
||||
region: 'KR',
|
||||
game_id: g.id,
|
||||
created_at: g.created_at,
|
||||
desired_output_fields: [
|
||||
'data.game_detail.teams[].participants[].stats.{assist,champion_level,death,gold_earned,kill,minion_kill,neutral_minion_kill,op_score,time_ccing_others,total_damage_dealt_to_champions,total_damage_taken,vision_wards_bought_in_game,ward_place}',
|
||||
'data.game_detail.teams[].participants[].{position,team_key,champion_id,champion_name}',
|
||||
'data.game_detail.teams[].participants[].summoner.{puuid,game_name,tagline,player}',
|
||||
'data.game_detail.teams[].game_stat.{champion_kill,is_win}',
|
||||
],
|
||||
})) as any).data.game_detail;
|
||||
// 프로 선수가 아닌 사람의 최근 솔로 랭크 (15분 이상)
|
||||
const seedGame = (await listOf('Hide on bush', 'KR1')).find((g) => g.game_type === 'SOLORANKED')!;
|
||||
const seedDet = await detailOf(seedGame);
|
||||
const pick = seedDet.teams.flatMap((t: any) => t.participants).find((p: any) => !p.summoner.player && p.summoner.game_name !== 'Hide on bush');
|
||||
const g = (await listOf(pick.summoner.game_name, pick.summoner.tagline)).find((x) => x.game_type === 'SOLORANKED' && x.game_length_second > 1200)!;
|
||||
const det = await detailOf(g);
|
||||
const all = det.teams.flatMap((t: any) => t.participants.map((p: any) => ({ ...p, win: t.game_stat.is_win, teamKills: t.game_stat.champion_kill })));
|
||||
const selfP = all.find((p: any) => p.summoner.puuid === pick.summoner.puuid) ?? all[0];
|
||||
const opggTruth = new Map<string, number>(all.map((p: any) => [p.summoner.puuid, p.stats.op_score]));
|
||||
const players: MatchPlayer[] = all.map((p: any) => ({
|
||||
puuid: p.summoner.puuid,
|
||||
name: p.summoner.game_name,
|
||||
tag: p.summoner.tagline,
|
||||
team: p.team_key,
|
||||
ally: p.team_key === selfP.team_key,
|
||||
character: { id: String(p.champion_id), name: p.champion_name, icon: null },
|
||||
kills: p.stats.kill,
|
||||
deaths: p.stats.death,
|
||||
assists: p.stats.assist,
|
||||
cs: (p.stats.minion_kill ?? 0) + (p.stats.neutral_minion_kill ?? 0),
|
||||
gold: p.stats.gold_earned,
|
||||
level: p.stats.champion_level,
|
||||
stats: {
|
||||
role: POS[p.position],
|
||||
damage: p.stats.total_damage_dealt_to_champions,
|
||||
damageTaken: p.stats.total_damage_taken,
|
||||
ccSeconds: p.stats.time_ccing_others ?? 0,
|
||||
wardsPlaced: p.stats.ward_place ?? 0,
|
||||
controlWards: p.stats.vision_wards_bought_in_game ?? 0,
|
||||
},
|
||||
}));
|
||||
const LS = Date.parse(g.created_at) + 60000;
|
||||
const LEN = g.game_length_second * 1000;
|
||||
const allyWin = !!selfP.win;
|
||||
const allyKills = all.filter((p: any) => p.team_key === selfP.team_key)[0].teamKills;
|
||||
const enemyKills = all.filter((p: any) => p.team_key !== selfP.team_key)[0].teamKills;
|
||||
const lolId = `lol-${g.id.replace(/[^\w]/g, '').slice(0, 20)}`;
|
||||
core.store.upsertMatch({
|
||||
id: lolId,
|
||||
game: 'lol',
|
||||
started_at: LS,
|
||||
ended_at: LS + LEN,
|
||||
status: 'complete',
|
||||
map: 'Map11',
|
||||
mode: 'CLASSIC',
|
||||
queue: '420',
|
||||
result: JSON.stringify({ win: allyWin, score: { ally: allyKills, enemy: enemyKills } }),
|
||||
detail: JSON.stringify({ live: false, players, goldDiff: [], self: selfP.summoner.puuid }),
|
||||
});
|
||||
// 우리 팀 두 명이 음성채널에 있었다고 하고 대화를 붙인다 (실제 경기 기록 + 시험용 대화)
|
||||
const mates = players.filter((p) => p.ally);
|
||||
const [a, b] = [mates.find((p) => p.puuid === selfP.summoner.puuid)!, mates.find((p) => p.puuid !== selfP.summoner.puuid)!];
|
||||
core.store.upsertUser({ id: 'ua', name: '승한', avatar: null });
|
||||
core.store.upsertUser({ id: 'ub', name: '민수', avatar: null });
|
||||
core.store.setAccounts('ua', [{ puuid: a.puuid, riotId: `${a.name}#${a.tag}` }]);
|
||||
core.store.setAccounts('ub', [{ puuid: b.puuid, riotId: `${b.name}#${b.tag}` }]);
|
||||
core.store.startSession('s-lol', 'g', 'c', '음성', LS - MIN);
|
||||
const talk: [string, number, string][] = [
|
||||
['ua', 2.5, '정글 위쪽에서 시작했어 바텀 조심해'],
|
||||
['ub', 6.2, '용 앞에 와드 박아 줘 시야 없어'],
|
||||
['ua', 6.5, '알았어 지금 갈게'],
|
||||
['ub', 11.0, '미드 미아 미드 미아 내려간다'],
|
||||
['ua', 14.8, '용 한타 열지 마 아직 우리 텔 없어'],
|
||||
['ub', 15.1, '아 들어갔다 아 죽었다 미안'],
|
||||
['ua', 19.5, '바론 시야 먼저 잡고 하자 혼자 가지 마'],
|
||||
['ub', 24.0, allyWin ? '좋아 한타 이겼다 미드 밀자' : '아 또 잡혔네 이거 그냥 서렌 치자'],
|
||||
['ua', 24.3, allyWin ? '억제기 깨고 바로 빠지자' : '아직 안 끝났어 수비하자'],
|
||||
];
|
||||
for (const [uid, min, text] of talk) {
|
||||
if (min * MIN > LEN) continue;
|
||||
const ts = LS + min * MIN;
|
||||
const id = `lol-${uid}-${min}`;
|
||||
core.store.insertUtterance({ id, session_id: 's-lol', user_id: uid, started_at: ts, ended_at: ts + 1800, audio_path: null, match_id: lolId });
|
||||
core.store.updateUtteranceResult(id, { text, raw_text: text, words: [], noise: false, noise_reason: null, confidence: 0.9, lufs: -20, gain_db: 0, model: 'large-v3', status: 'precise' });
|
||||
}
|
||||
core.store.endSession('s-lol', LS + LEN + MIN);
|
||||
|
||||
// ---------------------------------------------------------------- 사이트 서버 (실제 Claude · 실제 OP.GG)
|
||||
const local = await culpritApi(core);
|
||||
const { buildServer } = await import('../../site/server/src/app.ts');
|
||||
const port = 18961;
|
||||
const site = await buildServer({
|
||||
port, host: '127.0.0.1', publicUrl: `http://127.0.0.1:${port}`, clientId: 'x', clientSecret: 'x', botToken: 'x', allowedGuilds: [], owners: ['u1'], superAdmins: ['u1'],
|
||||
sessionSecret: 'real-e2e-secret-'.repeat(3), dataDir: fs.mkdtempSync(path.join(os.tmpdir(), 'gvr-real-')), webDir: path.join(root, 'site', 'web', 'dist'), version: 't', discordApi: 'http://127.0.0.1:1',
|
||||
assetUpstream: { valmedia: 'https://media.valorant-api.com/', ddragon: 'https://ddragon.leagueoflegends.com/', cdragon: 'https://raw.communitydragon.org/' },
|
||||
culprit: { apiKey, model: 'claude-opus-5-5', effort: 'high', monthLimitUsd: 100, dailyLimit: 20, tone: 'medium', opgg: true },
|
||||
});
|
||||
site.app.log.level = 'info';
|
||||
await site.app.listen({ host: '127.0.0.1', port });
|
||||
const base = `http://127.0.0.1:${port}`;
|
||||
const code = site.store.createCode('real');
|
||||
const reg = site.store.redeem(code.code, 'GAME-PC')!;
|
||||
const { RelayClient } = await import('../src/core/relay/client.ts');
|
||||
const rc = new RelayClient(local as any, core.bus, () => ({ serverUrl: base, deviceId: reg.deviceId, deviceKey: reg.deviceKey, name: 'GAME-PC', version: 't', guildId: 'g' }));
|
||||
rc.start();
|
||||
while (!site.hub.status().online) await new Promise((r) => setTimeout(r, 100));
|
||||
const sess = site.store.createSession({ id: 'u1', name: '승한', avatar: null });
|
||||
const cookieHeader = `gvr_sid=${encodeURIComponent(site.app.signCookie(sess.token))}`;
|
||||
|
||||
const stages: Record<string, string[]> = {};
|
||||
// 진행 단계 기록 (실시간 알림을 가로챈다)
|
||||
const pub = site.hub.publish.bind(site.hub);
|
||||
site.hub.publish = (e: any) => {
|
||||
if (e.type === 'culprit.progress') (stages[e.data.matchId] ||= []).push(`${e.data.stage}${e.data.message ? `(${e.data.message})` : ''}`);
|
||||
pub(e);
|
||||
};
|
||||
|
||||
async function analyze(matchId: string) {
|
||||
const input = (await local.inject({ url: `/api/culprit/internal/${matchId}/input`, headers: { 'x-gvr-internal': '1' } })).json().input as CulpritInput;
|
||||
fs.writeFileSync(path.join(outDir, `${matchId}.input.txt`), input.text);
|
||||
const t0 = Date.now();
|
||||
const r = await fetch(`${base}/api/culprit/matches/${matchId}/analyze`, { method: 'POST', headers: { cookie: cookieHeader, 'content-type': 'application/json' }, body: '{}' });
|
||||
if (r.status !== 202) throw new Error(`analyze ${r.status} ${await r.text()}`);
|
||||
for (;;) {
|
||||
await new Promise((res) => setTimeout(res, 3000));
|
||||
const info = (await (await fetch(`${base}/api/culprit/matches/${matchId}`, { headers: { cookie: cookieHeader } })).json()) as CulpritMatchInfo;
|
||||
if (info.analysis) return { info, ms: Date.now() - t0 };
|
||||
if (Date.now() - t0 > 10 * MIN) throw new Error('10분 안에 끝나지 않음');
|
||||
const b = await (await fetch(`${base}/api/culprit/budget`, { headers: { cookie: cookieHeader } })).json();
|
||||
if (!b.running.includes(matchId)) {
|
||||
// 실패
|
||||
throw new Error(`분석 실패: ${JSON.stringify(stages[matchId] ?? [])}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
const report: any = {};
|
||||
for (const id of [valId, lolId]) {
|
||||
console.log(`\n=== ${id} 분석 시작`);
|
||||
const { info, ms } = await analyze(id);
|
||||
const a = info.analysis!;
|
||||
fs.writeFileSync(path.join(outDir, `${id}.result.json`), JSON.stringify(a, null, 1));
|
||||
const ref = (pid: string) => a.players.find((p) => p.id === pid)!;
|
||||
const rows = a.result.players.map((p) => {
|
||||
const pl = ref(p.id);
|
||||
return { id: p.id, team: pl.team, ai: p.score, rating: pl.rating?.score ?? null, opgg: pl.opgg?.score ?? null, truth: opggTruth.get(pl.puuid) ?? null, tag: p.tag, comment: p.comment };
|
||||
});
|
||||
const teamLowest = (team: string, key: 'rating' | 'opgg') => {
|
||||
const ps = rows.filter((r) => r.team === team && r[key] !== null);
|
||||
return ps.length ? ps.reduce((x, y) => ((x[key] as number) <= (y[key] as number) ? x : y)).id : null;
|
||||
};
|
||||
report[id] = {
|
||||
seconds: Math.round(ms / 1000),
|
||||
model: a.model,
|
||||
costUsd: a.meta.costUsd,
|
||||
usage: a.meta.usage,
|
||||
opgg: a.meta.opgg,
|
||||
stages: stages[id],
|
||||
summary: a.result.summary,
|
||||
confidence: a.result.confidence,
|
||||
culprits: a.result.teams.map((t) => ({ team: t.team, culprit: t.culprit, reason: t.reason, evidence: t.evidence.map((e) => e.ref), lowestRating: teamLowest(t.team, 'rating'), lowestOpgg: teamLowest(t.team, 'opgg') })),
|
||||
players: rows,
|
||||
};
|
||||
console.log(JSON.stringify(report[id], null, 1));
|
||||
}
|
||||
fs.writeFileSync(path.join(outDir, 'report.json'), JSON.stringify(report, null, 1));
|
||||
|
||||
// ---------------------------------------------------------------- 화면
|
||||
const puppeteer = (await import(path.join(os.homedir(), '.tmp/gvr-shot/node_modules/puppeteer-core/lib/esm/puppeteer/puppeteer-core.js'))).default;
|
||||
const browser = await puppeteer.launch({ executablePath: '/usr/bin/google-chrome', headless: true, args: ['--no-sandbox', '--lang=ko-KR'] });
|
||||
const page = await browser.newPage();
|
||||
await page.setCookie({ name: 'gvr_sid', value: site.app.signCookie(sess.token), url: base });
|
||||
const errs: string[] = [];
|
||||
page.on('pageerror', (e: any) => errs.push(e.message));
|
||||
for (const [id, name] of [[valId, 'real-val.png'], [lolId, 'real-lol.png']] as const) {
|
||||
await page.setViewport({ width: 1440, height: 2000 });
|
||||
await page.goto(`${base}/culprit/${id}`, { waitUntil: 'networkidle2' });
|
||||
await page.waitForSelector('.cu-card', { timeout: 20000 });
|
||||
await new Promise((r) => setTimeout(r, 1500));
|
||||
await page.screenshot({ path: path.join(outDir, name), fullPage: true });
|
||||
}
|
||||
console.log('\n화면 오류:', errs);
|
||||
await browser.close();
|
||||
rc.stop();
|
||||
await site.app.close();
|
||||
await local.close();
|
||||
console.log('결과:', outDir);
|
||||
141
app/scripts/culprit-shots.mts
Normal file
@@ -0,0 +1,141 @@
|
||||
// 범인찾기 화면 확인: 실제 앱 코어(범인찾기 · 기록 DB) + 실제 사이트 서버 + 헤드리스 브라우저.
|
||||
// AI 는 부르지 않는다: CULPRIT_ANSWER(JSON 파일)를 AI 답으로 돌려준다 (없으면 기본 답 생성).
|
||||
// [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';
|
||||
import type { CulpritInput } from '@gvr/shared';
|
||||
import { makeDemoLol } from '../test/fixtures/demo-matches.ts';
|
||||
import { culpritApi, MIN, seedValorant, setup } from '../test/fixtures/culprit-seed.ts';
|
||||
|
||||
const answerFile = process.argv[2];
|
||||
const shotDir = process.argv[3] || path.join(os.homedir(), '.tmp', 'culprit-shots');
|
||||
const root = path.resolve(import.meta.dirname, '..', '..');
|
||||
const core = setup();
|
||||
await core.assets.refresh(true);
|
||||
const { id: valId } = seedValorant(core);
|
||||
// 롤 경기 (음성 2명)
|
||||
const LS = Date.now() - 80 * MIN;
|
||||
const lol = makeDemoLol();
|
||||
core.store.setMeta('riot_self_puuid', 'l-sh');
|
||||
core.store.setAccounts('u1', [{ puuid: 'p-sh', riotId: '승한#V' }, { puuid: 'l-sh', riotId: '승한#L' }]);
|
||||
core.store.setAccounts('u2', [{ puuid: 'p-ms', riotId: '민수#V' }, { puuid: 'l-ms', riotId: '민수#L' }]);
|
||||
core.store.startSession('s2', 'g', 'c', '음성', LS - MIN);
|
||||
core.games.matchStarted({ id: 'lol-demo', game: 'lol', startedAt: LS, map: 'Map11', mode: 'CLASSIC', queue: '420', detail: { live: true } });
|
||||
core.games.matchEnded('lol-demo', LS + lol.durationMs);
|
||||
(core.games.adapters[1] as any).applyHistory('lol-demo', lol.game, lol.timeline, LS);
|
||||
for (const [uid, min, text] of [['u2', 8.1, '용 같이 하자 바텀 밀었어'], ['u1', 8.3, '아니 탑 갱 각이야 잠깐만']] as const) {
|
||||
const ts = LS + min * MIN;
|
||||
const id = `lol-${uid}-${min}`;
|
||||
core.store.insertUtterance({ id, session_id: 's2', user_id: uid, started_at: ts, ended_at: ts + 1500, audio_path: null, match_id: 'lol-demo' });
|
||||
core.store.updateUtteranceResult(id, { text, raw_text: text, words: [], noise: false, noise_reason: null, confidence: 0.9, lufs: -20, gain_db: 0, model: 'small', status: 'precise' });
|
||||
}
|
||||
core.store.endSession('s2', LS + lol.durationMs + MIN);
|
||||
// 녹음이 늦게 시작한 경기 (기록 부족 표시용)
|
||||
core.store.upsertMatch({ id: 'val-late', game: 'valorant', started_at: Date.now() - 30 * 3600_000, ended_at: Date.now() - 29.3 * 3600_000, status: 'complete', map: '/Game/Maps/Bonsai/Bonsai', queue: 'competitive', mode: 'competitive', result: JSON.stringify({ win: true, score: { ally: 13, enemy: 10 } }), detail: JSON.stringify({ players: [{}, {}], roundsDetail: [{}] }) });
|
||||
core.store.startSession('s3', 'g', 'c', null, Date.now() - 30 * 3600_000 + 12 * MIN);
|
||||
core.store.endSession('s3', Date.now() - 29 * 3600_000);
|
||||
|
||||
const local = await culpritApi(core);
|
||||
const saved = answerFile && fs.existsSync(answerFile) ? JSON.parse(fs.readFileSync(answerFile, 'utf8')) : null;
|
||||
const fakeAnswer = (input: CulpritInput) => ({
|
||||
summary: '초반 드래곤 세 개를 내줘 끌려갔지만 바론 앞 한타를 뒤집어 이겼다.',
|
||||
confidence: 'medium',
|
||||
confidence_note: '시연 데이터라 기록이 단순하다.',
|
||||
teams: [
|
||||
{ team: 'ally', culprit: 'P2', reason: '드래곤 앞 교전에서 시야 없이 싸우다 내줬고, 용 콜이 있었는데 탑 갱을 고집했다.', evidence: Object.keys(input.refs).filter((k) => k.startsWith('u') || k === 'e3').slice(0, 3).map((ref) => ({ ref, note: '근거' })).concat([{ ref: 's:P2', note: '킬 관여 낮음' }]) },
|
||||
{ team: 'enemy', culprit: 'P10', reason: '레오나로 이니시를 열지 못하고 한타 직전에 먼저 잡혔다.', evidence: [{ ref: 's:P10', note: '데스 많음' }] },
|
||||
],
|
||||
players: input.players.map((p, i) => ({ id: p.id, score: p.id === 'P2' ? 4 : p.id === 'P10' ? 3 : 6 + (i % 4), tag: p.id === 'P2' || p.id === 'P10' ? '범인' : i === 0 ? '캐리' : '무난', comment: '한 줄 평 예시.', evidence: [] })),
|
||||
});
|
||||
const { buildServer } = await import('../../site/server/src/app.ts');
|
||||
const { KnowledgeAuto } = await import('../../site/server/src/culprit-prompt.ts');
|
||||
const port = 18960;
|
||||
const site = await buildServer(
|
||||
{
|
||||
port, host: '127.0.0.1', publicUrl: `http://127.0.0.1:${port}`, clientId: 'x', clientSecret: 'x', botToken: 'x', allowedGuilds: [], owners: ['u1'], superAdmins: ['u1'],
|
||||
sessionSecret: 'demo-secret-'.repeat(3), dataDir: fs.mkdtempSync(path.join(os.tmpdir(), 'gvr-cs-')), webDir: path.join(root, 'site', 'web', 'dist'), version: 't', discordApi: 'http://127.0.0.1:1',
|
||||
assetUpstream: { valmedia: 'https://media.valorant-api.com/', ddragon: 'https://ddragon.leagueoflegends.com/', cdragon: 'https://raw.communitydragon.org/' },
|
||||
culprit: { apiKey: 'x', model: 'claude-opus-5-5', effort: 'high', monthLimitUsd: 100, dailyLimit: 20, tone: 'medium' },
|
||||
},
|
||||
{
|
||||
culpritKnowledge: new KnowledgeAuto(async () => { throw new Error('offline'); }),
|
||||
// OP.GG: 발로란트 시연 경기는 "찾음"(가짜 점수), 롤 시연 경기는 "없음"
|
||||
culpritOpgg: async (name: string, args: any) => {
|
||||
if (name !== 'valorant_list_player_matches') return {};
|
||||
const input = (await local.inject({ url: `/api/culprit/internal/${valId}/input`, headers: { 'x-gvr-internal': '1' } })).json().input as CulpritInput;
|
||||
const p = input.players.find((x) => x.name === args.game_name)!;
|
||||
return [{ matchId: 'demo', puuid: p.puuid, opScore: Math.round((p.rating?.score ?? 5) * 100 + 30) }];
|
||||
},
|
||||
culpritCall: async (req) => {
|
||||
await new Promise((r) => setTimeout(r, 2500));
|
||||
const isVal = req.user.includes('# 경기 발로란트');
|
||||
const input = (await local.inject({ url: `/api/culprit/internal/${isVal ? valId : 'lol-demo'}/input`, headers: { 'x-gvr-internal': '1' } })).json().input;
|
||||
return { text: JSON.stringify(isVal && saved ? saved : fakeAnswer(input)), stopReason: 'end_turn', usages: [{ model: 'claude-opus-5-5', input: 26077, output: 13997, cacheRead: 0, cacheWrite: 0 }], fallback: false };
|
||||
},
|
||||
},
|
||||
);
|
||||
site.app.log.level = 'warn';
|
||||
await site.app.listen({ host: '127.0.0.1', port });
|
||||
const base = `http://127.0.0.1:${port}`;
|
||||
const code = site.store.createCode('demo');
|
||||
const reg = site.store.redeem(code.code, 'GAME-PC')!;
|
||||
const { RelayClient } = await import('../src/core/relay/client.ts');
|
||||
const rc = new RelayClient(local as any, core.bus, () => ({ serverUrl: base, deviceId: reg.deviceId, deviceKey: reg.deviceKey, name: 'GAME-PC', version: 't', guildId: 'g' }));
|
||||
rc.start();
|
||||
// 사이트 화면은 /api/overview · /api/users 도 부른다
|
||||
while (!site.hub.status().online) await new Promise((r) => setTimeout(r, 100));
|
||||
const sess = site.store.createSession({ id: 'u1', name: '승한', avatar: null });
|
||||
const cookie = { name: 'gvr_sid', value: site.app.signCookie(sess.token), url: base };
|
||||
|
||||
const puppeteer = (await import(path.join(os.homedir(), '.tmp/gvr-shot/node_modules/puppeteer-core/lib/esm/puppeteer/puppeteer-core.js'))).default;
|
||||
const browser = await puppeteer.launch({ executablePath: '/usr/bin/google-chrome', headless: true, args: ['--no-sandbox', '--lang=ko-KR'] });
|
||||
const page = await browser.newPage();
|
||||
await page.setCookie(cookie);
|
||||
const errs: string[] = [];
|
||||
page.on('pageerror', (e: any) => errs.push(e.message));
|
||||
page.on('console', (m: any) => m.type() === 'error' && errs.push(m.text()));
|
||||
const csp: string[] = [];
|
||||
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, deviceScaleFactor: SCALE });
|
||||
await sleep(600);
|
||||
await page.screenshot({ path: path.join(shotDir, name), fullPage: full });
|
||||
console.log('screenshot', name);
|
||||
};
|
||||
await page.setViewport({ width: 1440, height: 900 });
|
||||
await page.goto(`${base}/culprit/${valId}`, { waitUntil: 'networkidle2' });
|
||||
await sleep(1500);
|
||||
await shot('1-list.png', 1440, 1100);
|
||||
await page.click('.cu-btn');
|
||||
await sleep(1200);
|
||||
await shot('2-progress.png');
|
||||
await page.waitForSelector('.cu-card', { timeout: 20000 });
|
||||
await sleep(1200);
|
||||
await shot('3-result-val.png', 1440, 1900);
|
||||
await shot('4-result-mobile.png', 390, 3200);
|
||||
await page.setViewport({ width: 1440, height: 900 });
|
||||
await page.goto(`${base}/culprit/lol-demo`, { waitUntil: 'networkidle2' });
|
||||
await sleep(1200);
|
||||
await page.click('.cu-btn');
|
||||
await page.waitForSelector('.cu-card', { timeout: 20000 });
|
||||
await sleep(1200);
|
||||
await shot('5-result-lol.png', 1440, 1900);
|
||||
await page.goto(`${base}/culprit/val-late`, { waitUntil: 'networkidle2' });
|
||||
await sleep(1200);
|
||||
await shot('6-blocked.png');
|
||||
await page.goto(`${base}/matches/${valId}`, { waitUntil: 'networkidle2' });
|
||||
await sleep(800);
|
||||
const hasBtn = await page.evaluate(() => [...document.querySelectorAll('.crumbs a')].some((a) => a.textContent?.includes('범인 보기')));
|
||||
console.log('경기 화면 범인 보기 버튼', hasBtn);
|
||||
console.log('브라우저 오류:', errs.filter((e) => !/favicon/.test(e)));
|
||||
console.log('CSP 위반:', csp.length ? csp : '없음');
|
||||
await browser.close();
|
||||
rc.stop();
|
||||
await site.app.close();
|
||||
await local.close();
|
||||
process.exit(0);
|
||||
@@ -173,10 +173,12 @@ console.log(`완전 일치 ${exact}/${total}`);
|
||||
|
||||
// ---- 로컬 사이트 서버 + 중계
|
||||
const { buildServer } = await import('../../site/server/src/app.ts');
|
||||
// 주소를 먼저 정한다 (사이트 서버가 실시간 WebSocket 의 출처를 publicUrl 과 비교한다)
|
||||
const port = Number(process.env.DEMO_PORT || 18950);
|
||||
const site = await buildServer({
|
||||
port: 0,
|
||||
port,
|
||||
host: '127.0.0.1',
|
||||
publicUrl: 'http://127.0.0.1',
|
||||
publicUrl: `http://127.0.0.1:${port}`,
|
||||
clientId: 'x',
|
||||
clientSecret: 'x',
|
||||
botToken: 'x',
|
||||
@@ -190,7 +192,7 @@ const site = await buildServer({
|
||||
assetUpstream: { valmedia: 'https://media.valorant-api.com/', ddragon: 'https://ddragon.leagueoflegends.com/', cdragon: 'https://raw.communitydragon.org/' },
|
||||
});
|
||||
site.app.log.level = 'warn';
|
||||
await site.app.listen({ host: '127.0.0.1', port: Number(process.env.DEMO_PORT || 0) });
|
||||
await site.app.listen({ host: '127.0.0.1', port });
|
||||
const base = `http://127.0.0.1:${(site.app.server.address() as any).port}`;
|
||||
const { registerDevice } = await import('../src/core/relay/client.ts');
|
||||
const code = site.store.createCode('demo');
|
||||
@@ -199,7 +201,7 @@ core.settings.update({ site: { serverUrl: base, deviceId: reg.deviceId, deviceNa
|
||||
core.settings.setSecret('deviceKey', reg.deviceKey);
|
||||
core.relay.restart();
|
||||
const sess = site.store.createSession({ id: USERS[0].id, name: '승한', avatar: null });
|
||||
const cookie = { name: 'gvr_sid', value: site.app.signCookie(sess.id), url: base };
|
||||
const cookie = { name: 'gvr_sid', value: site.app.signCookie(sess.token), url: base };
|
||||
while (core.relay.status.state !== 'online') await new Promise((r) => setTimeout(r, 100));
|
||||
console.log(`사이트: ${base} (쿠키 gvr_sid=${cookie.value})`);
|
||||
|
||||
@@ -211,6 +213,10 @@ await page.setCookie(cookie);
|
||||
const errs: string[] = [];
|
||||
page.on('pageerror', (e: any) => errs.push(e.message));
|
||||
page.on('console', (m: any) => m.type() === 'error' && errs.push(m.text()));
|
||||
// 보안 정책(CSP)에 막힌 것이 있으면 화면 일부가 깨진다 → 모두 모은다
|
||||
const cspViolations: string[] = [];
|
||||
await page.exposeFunction('__csp', (v: string) => cspViolations.push(v));
|
||||
await page.evaluateOnNewDocument(() => document.addEventListener('securitypolicyviolation', (e) => (window as any).__csp(`${e.violatedDirective} ${e.blockedURI}`)));
|
||||
fs.mkdirSync(shotDir, { recursive: true });
|
||||
const shot = async (url: string, name: string, w = 1440, h = 900, after?: () => Promise<void>) => {
|
||||
await page.setViewport({ width: w, height: h });
|
||||
@@ -251,10 +257,11 @@ await new Promise((r) => setTimeout(r, 4000));
|
||||
const unlocked = await page.evaluate(() => !document.querySelector('.lock'));
|
||||
console.log(`잠금 표시 ${lockedVisible}, 재연결 후 해제 ${unlocked}`);
|
||||
console.log('브라우저 오류:', errs.filter((e) => !/favicon|401/.test(e)));
|
||||
console.log('CSP 위반:', cspViolations.length ? cspViolations : '없음');
|
||||
await browser.close();
|
||||
if (!serve) {
|
||||
await core.stop();
|
||||
await site.app.close();
|
||||
process.exit(lockedVisible && unlocked ? 0 : 1);
|
||||
process.exit(lockedVisible && unlocked && !cspViolations.length ? 0 : 1);
|
||||
}
|
||||
console.log('--serve: Ctrl+C 로 종료');
|
||||
|
||||
225
app/scripts/login-e2e.mts
Normal file
@@ -0,0 +1,225 @@
|
||||
// 로그인 E2E (리눅스 · Xvfb): 실제 Electron 앱 + 이 저장소의 사이트 서버 코드 + 가짜 디스코드 OAuth.
|
||||
// 겜녹이 봇 토큰은 서버에만 있다. 서버가 디스코드에 붙고, 로그인한 앱이 서버 중계(/app/bot/ws)로 봇을 쓰는지까지 본다.
|
||||
// GVR_E2E_BOT_TOKEN=<겜녹이 봇 토큰> node --import tsx scripts/login-e2e.mts [스크린샷 폴더]
|
||||
// (먼저 npm run build)
|
||||
import { spawn } from 'node:child_process';
|
||||
import fs from 'node:fs';
|
||||
import http from 'node:http';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import WebSocket from 'ws';
|
||||
import { buildServer } from '../../site/server/src/app.ts';
|
||||
import { DiscordSource } from '../../site/server/src/discord-source.ts';
|
||||
import { AppAuth } from '../src/core/auth.ts';
|
||||
import { SettingsStore } from '../src/core/settings.ts';
|
||||
|
||||
const BOT = process.env.GVR_E2E_BOT_TOKEN;
|
||||
if (!BOT) throw new Error('GVR_E2E_BOT_TOKEN 이 필요합니다');
|
||||
const shots = process.argv[2];
|
||||
const SUPER = '293719842274541579';
|
||||
// 친구 = 테스트봇 계정 (F&L 서버 멤버). 봇 중계는 앱 유저가 가입한 서버만 보여 주므로 실제 멤버여야 한다
|
||||
const FRIEND = '1538122882528321536';
|
||||
const PORT = 18931;
|
||||
const base = `http://127.0.0.1:${PORT}`;
|
||||
const work = fs.mkdtempSync(path.join(process.env.TMPDIR || os.tmpdir(), 'gvr-login-e2e-'));
|
||||
const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
|
||||
const results: [string, boolean, string][] = [];
|
||||
const check = (name: string, ok: boolean, detail = '') => {
|
||||
results.push([name, ok, detail]);
|
||||
console.log(`${ok ? '✔' : '✘'} ${name}${detail ? ` · ${detail}` : ''}`);
|
||||
};
|
||||
|
||||
// ---- 가짜 디스코드: OAuth code = 로그인할 아이디, 봇 토큰으로 /users/:id 조회
|
||||
const names: Record<string, string> = { [SUPER]: '사금향', [FRIEND]: '테스트친구' };
|
||||
const dc = http.createServer((req, res) => {
|
||||
const u = new URL(req.url!, 'http://x');
|
||||
res.setHeader('content-type', 'application/json');
|
||||
if (u.pathname === '/oauth2/token') {
|
||||
let b = '';
|
||||
req.on('data', (c) => (b += c));
|
||||
req.on('end', () => res.end(JSON.stringify({ access_token: new URLSearchParams(b).get('code') })));
|
||||
return;
|
||||
}
|
||||
if (u.pathname === '/users/@me') {
|
||||
const id = String(req.headers.authorization).replace('Bearer ', '');
|
||||
return res.end(JSON.stringify({ id, username: names[id] ?? 'x', global_name: names[id] ?? null, avatar: null }));
|
||||
}
|
||||
const m = /^\/users\/(\d+)$/.exec(u.pathname);
|
||||
if (m && names[m[1]!]) return res.end(JSON.stringify({ id: m[1], username: names[m[1]!], global_name: names[m[1]!], avatar: null }));
|
||||
res.statusCode = 404;
|
||||
res.end('{}');
|
||||
});
|
||||
await new Promise<void>((r) => dc.listen(0, '127.0.0.1', () => r()));
|
||||
const dcUrl = `http://127.0.0.1:${(dc.address() as any).port}`;
|
||||
|
||||
const source = new DiscordSource({ info: () => undefined, error: (o, m) => console.error(m, o) });
|
||||
const { app: site } = await buildServer(
|
||||
{
|
||||
port: PORT, host: '127.0.0.1', publicUrl: base, clientId: 'cid', clientSecret: 's', botToken: BOT,
|
||||
allowedGuilds: [], owners: [SUPER], superAdmins: [SUPER], sessionSecret: 'x'.repeat(32), dataDir: path.join(work, 'site'),
|
||||
webDir: '/nonexistent', version: 'e2e', discordApi: dcUrl, assetUpstream: {},
|
||||
},
|
||||
{ botSource: source },
|
||||
);
|
||||
site.log.level = 'warn';
|
||||
await site.listen({ host: '127.0.0.1', port: PORT });
|
||||
await source.login(BOT);
|
||||
|
||||
// 브라우저 흉내: PATH 맨 앞에 가짜 xdg-open 을 둔다 (Electron shell.openExternal 이 부른다. 실제 브라우저는 열지 않는다)
|
||||
// 로그인 주소 → 가짜 디스코드 → 콜백. 로그인할 아이디는 파일에서
|
||||
const loginAs = path.join(work, 'login-as');
|
||||
const binDir = path.join(work, 'bin');
|
||||
fs.mkdirSync(binDir);
|
||||
const browserSh = path.join(binDir, 'xdg-open');
|
||||
fs.writeFileSync(
|
||||
browserSh,
|
||||
`#!/bin/sh\nJAR=$(mktemp)\nLOC=$(curl -s -c "$JAR" -o /dev/null -w '%{redirect_url}' "$1")\nSTATE=$(printf '%s' "$LOC" | sed -n 's/.*[?&]state=\\([^&]*\\).*/\\1/p')\ncurl -s -b "$JAR" -o /dev/null "${base}/auth/discord/callback?code=$(cat ${loginAs})&state=$STATE"\nrm -f "$JAR"\n`,
|
||||
{ mode: 0o755 },
|
||||
);
|
||||
const browse = (who: string) => async (url: string) => {
|
||||
const start = await fetch(url, { redirect: 'manual' });
|
||||
const state = new URL(start.headers.get('location')!).searchParams.get('state')!;
|
||||
await fetch(`${base}/auth/discord/callback?code=${who}&state=${encodeURIComponent(state)}`, { headers: { cookie: start.headers.getSetCookie()[0]!.split(';')[0]! }, redirect: 'manual' });
|
||||
};
|
||||
|
||||
// 최고 관리자 (관리자 화면 API 를 대신 부른다)
|
||||
const adminSt = new SettingsStore(path.join(work, 'admin'));
|
||||
adminSt.update({ site: { serverUrl: base } });
|
||||
const admin = new AppAuth(adminSt, { version: 'e2e', openUrl: browse(SUPER), pollMs: 100 });
|
||||
check('최고 관리자 로그인', (await admin.login()).role === 'superadmin');
|
||||
await admin.adminAddUser(FRIEND, 'user');
|
||||
check('최고 관리자가 친구를 유저로 등록', (await admin.adminUsers()).users.some((u) => u.id === FRIEND && u.role === 'user'));
|
||||
|
||||
// ---- Electron 앱
|
||||
const data = path.join(work, 'app');
|
||||
fs.mkdirSync(data);
|
||||
fs.writeFileSync(path.join(data, 'settings.json'), JSON.stringify({ firstRunDone: true, site: { serverUrl: base }, games: { valorant: false, lol: false } }));
|
||||
fs.writeFileSync(loginAs, FRIEND);
|
||||
const electron = path.join(import.meta.dirname, '..', 'node_modules', '.bin', 'electron');
|
||||
const proc = spawn('xvfb-run', ['-a', electron, '.', `--data-dir=${data}`, '--remote-debugging-port=9333', '--no-sandbox'], {
|
||||
cwd: path.join(import.meta.dirname, '..'),
|
||||
env: { ...process.env, PATH: `${binDir}:${process.env.PATH}`, WAYLAND_DISPLAY: '', XDG_SESSION_TYPE: 'x11', GVR_BOT_TOKEN: '', ELECTRON_ENABLE_LOGGING: '1' },
|
||||
stdio: ['ignore', 'pipe', 'pipe'],
|
||||
detached: true, // 끝날 때 xvfb-run · Electron 을 프로세스 그룹째 끈다
|
||||
});
|
||||
const logs: string[] = [];
|
||||
proc.stdout.on('data', (b) => logs.push(...String(b).split('\n')));
|
||||
proc.stderr.on('data', (b) => logs.push(...String(b).split('\n')));
|
||||
|
||||
// CDP: 설정 창에서 window.gvr 호출
|
||||
let ws: WebSocket | null = null;
|
||||
for (let i = 0; i < 60 && !ws; i++) {
|
||||
await sleep(1000);
|
||||
try {
|
||||
const t = ((await (await fetch('http://127.0.0.1:9333/json')).json()) as any[]).find((x) => x.type === 'page');
|
||||
if (t) {
|
||||
ws = new WebSocket(t.webSocketDebuggerUrl);
|
||||
await new Promise((r) => ws!.once('open', r));
|
||||
}
|
||||
} catch {
|
||||
/* 아직 */
|
||||
}
|
||||
}
|
||||
if (!ws) throw new Error('Electron 창에 붙지 못했습니다\n' + logs.join('\n'));
|
||||
let seq = 0;
|
||||
const cdp = (method: string, params: any = {}) =>
|
||||
new Promise<any>((res) => {
|
||||
const id = ++seq;
|
||||
const on = (m: WebSocket.RawData) => {
|
||||
const j = JSON.parse(String(m));
|
||||
if (j.id === id) {
|
||||
ws!.off('message', on);
|
||||
res(j.result);
|
||||
}
|
||||
};
|
||||
ws!.on('message', on);
|
||||
ws!.send(JSON.stringify({ id, method, params }));
|
||||
});
|
||||
const gvr = async (expr: string): Promise<{ ok: boolean; v?: any; err?: string }> => {
|
||||
const r = await cdp('Runtime.evaluate', { expression: `(async () => JSON.stringify(await (${expr})))()`, awaitPromise: true });
|
||||
if (r.exceptionDetails) return { ok: false, err: r.exceptionDetails.exception?.description ?? r.exceptionDetails.text };
|
||||
return { ok: true, v: r.result.value === undefined ? undefined : JSON.parse(r.result.value) };
|
||||
};
|
||||
const shot = async (name: string) => {
|
||||
if (!shots) return;
|
||||
await sleep(700);
|
||||
const r = await cdp('Page.captureScreenshot', { format: 'png' });
|
||||
fs.mkdirSync(shots, { recursive: true });
|
||||
fs.writeFileSync(path.join(shots, `${name}.png`), Buffer.from(r.data, 'base64'));
|
||||
};
|
||||
|
||||
try {
|
||||
await sleep(1500);
|
||||
let a = (await gvr('window.gvr.authState()')).v;
|
||||
check('새 설치: 로그인 화면', a.status === 'signed_out' && !a.appReady, a.status);
|
||||
check('로그인 전: 코어 요청 막힘', /로그인이 필요합니다/.test((await gvr('window.gvr.getState()')).err ?? ''));
|
||||
await shot('electron-login');
|
||||
|
||||
// 로그인 (브라우저 → 가짜 디스코드 → 콜백 → 앱이 결과를 받아 감)
|
||||
void gvr('window.gvr.authLogin()');
|
||||
for (let i = 0; i < 60 && !(a?.status === 'ok' && a.appReady); i++) {
|
||||
await sleep(500);
|
||||
a = (await gvr('window.gvr.authState()')).v;
|
||||
}
|
||||
check('등록된 친구 로그인 → 앱 열림', a.status === 'ok' && a.appReady && a.role === 'user', `${a.status} ${a.role}`);
|
||||
let st: any = null;
|
||||
for (let i = 0; i < 90; i++) {
|
||||
st = (await gvr('window.gvr.getState()')).v;
|
||||
if (st?.bot.status === 'ready' || st?.bot.status === 'error') break;
|
||||
await sleep(500);
|
||||
}
|
||||
check('겜녹이 봇이 사이트 서버 중계로 연결', st?.bot.status === 'ready' && st.builtinBot && /사이트 서버 중계/.test(logs.join('\n')), `${st?.bot.status} ${st?.bot.user?.name ?? ''} 서버 ${st?.bot.guilds.length ?? 0}곳 ${st?.bot.error ?? ''}`);
|
||||
const t = (await gvr('window.gvr.testBotToken()')).v;
|
||||
check('겜녹이 봇 연결 확인 버튼 (토큰 없이 서버 중계)', t?.ok && t.guilds.length > 0, JSON.stringify(t).slice(0, 120));
|
||||
const mem = (await gvr('window.gvr.guildMembers()')).v;
|
||||
check('따라갈 사람 목록 (서버 중계)', Array.isArray(mem) && mem.length > 0, `${mem?.length}명`);
|
||||
const stored = fs.readdirSync(data).filter((f) => fs.statSync(path.join(data, f)).isFile() && fs.readFileSync(path.join(data, f)).includes(Buffer.from(BOT)));
|
||||
check('로그인 후에도 앱 데이터에 봇 토큰 없음', stored.length === 0, stored.join(','));
|
||||
check('계정 표시', st?.account.user?.id === FRIEND && st.account.role === 'user');
|
||||
// 창 보안: 설정 창이 바깥 페이지로 넘어가지 않는다 (넘어가면 그 페이지가 window.gvr 를 쓸 수 있다)
|
||||
await gvr(`(location.href = 'https://127.0.0.1:1/evil', 1)`);
|
||||
await sleep(1500);
|
||||
const where = (await gvr('location.protocol + (typeof window.gvr)')).v;
|
||||
check('설정 창은 바깥 주소로 넘어가지 않는다', where === 'file:object', where);
|
||||
|
||||
// 일반 유저 권한
|
||||
const r1 = await gvr(`window.gvr.updateSettings({ discord: { botMode: 'custom' } })`);
|
||||
check('유저: 다른 봇으로 바꾸기 거절', !r1.ok && /관리자만/.test(r1.err ?? ''));
|
||||
const r2 = await gvr(`window.gvr.updateSettings({ storage: { retentionDays: 30 } })`);
|
||||
check('유저: 보관 기간 변경 거절', !r2.ok && /관리자만/.test(r2.err ?? ''));
|
||||
const r3 = await gvr(`window.gvr.setSecret('botToken', 'x')`);
|
||||
check('유저: 봇 토큰 입력 거절', !r3.ok);
|
||||
const r4 = await gvr(`window.gvr.clearTrainingData()`);
|
||||
check('유저: 학습 데이터 삭제 거절', !r4.ok && /관리자만/.test(r4.err ?? ''));
|
||||
const r5 = await gvr(`window.gvr.updateSettings({ general: { sfx: false } })`);
|
||||
check('유저: 일반 설정은 바꿀 수 있음', r5.ok && r5.v.general.sfx === false);
|
||||
const r6 = await gvr(`window.gvr.adminAddUser('${SUPER}', 'user')`);
|
||||
check('유저: 유저 등록 API 거절 (서버)', !r6.ok && /최고 관리자만/.test(r6.err ?? ''));
|
||||
await gvr(`(location.hash = '#/settings/storage', 1)`);
|
||||
await shot('electron-user-storage');
|
||||
|
||||
// 등록 해제 → 다시 확인하면 잠김 · 봇 멈춤
|
||||
await admin.adminRemoveUser(FRIEND);
|
||||
a = (await gvr('window.gvr.authRecheck()')).v;
|
||||
check('등록 해제 후 확인 → 등록되지 않은 아이디로 잠김', a.status === 'not_registered' && !a.appReady, a.status);
|
||||
check('잠긴 뒤 코어 요청 막힘', /로그인이 필요합니다/.test((await gvr('window.gvr.getState()')).err ?? ''));
|
||||
const secrets = fs.existsSync(path.join(data, 'secrets.bin')) ? fs.readFileSync(path.join(data, 'secrets.bin')).toString('latin1') : '';
|
||||
check('잠긴 뒤 앱 토큰 삭제', !secrets.includes('appToken'));
|
||||
await shot('electron-not-registered');
|
||||
} finally {
|
||||
ws?.close();
|
||||
try {
|
||||
process.kill(-proc.pid!, 'SIGTERM');
|
||||
} catch {
|
||||
/* 이미 끝남 */
|
||||
}
|
||||
await sleep(1500);
|
||||
await site.close();
|
||||
await source.destroy();
|
||||
dc.close();
|
||||
fs.writeFileSync(path.join(work, 'electron.log'), logs.join('\n'));
|
||||
console.log(`작업 폴더 ${work}`);
|
||||
}
|
||||
const failed = results.filter((r) => !r[1]);
|
||||
console.log(`\n${results.length - failed.length}/${results.length} 통과`);
|
||||
process.exit(failed.length ? 1 : 0);
|
||||
@@ -2,6 +2,8 @@
|
||||
// node --import tsx scripts/voice-e2e.mts <guildId> <voiceChannelId>
|
||||
// 필요: secrets.json 의 겜녹이·테스트봇 토큰, worker/.venv, tiny 모델(HF 캐시)
|
||||
// M7 실사용 시험: GVR_E2E_SET=demo (시연 대화 28문장, 문장별 CER·지연), GVR_E2E_MODEL=<모델 폴더 경로>, GVR_E2E_DEVICE=cuda
|
||||
// GVR_E2E_RELAY=1: 겜녹이 봇을 사이트 서버 중계로 쓴다 (이 저장소의 사이트 서버 코드를 띄워 봇 토큰은 서버에만 두고,
|
||||
// 앱은 로그인 토큰으로 /app/bot/ws 에 붙는다. 디스코드 OAuth 만 가짜). 끝나면 앱 데이터 폴더에 봇 토큰이 없는지도 본다
|
||||
import { Client, GatewayIntentBits } from 'discord.js';
|
||||
import { joinVoiceChannel, entersState, VoiceConnectionStatus, createAudioPlayer, createAudioResource, StreamType, AudioPlayerStatus } from '@discordjs/voice';
|
||||
import fs from 'node:fs';
|
||||
@@ -32,7 +34,62 @@ fs.writeFileSync(
|
||||
}),
|
||||
);
|
||||
process.env.GVR_RECORD_BOTS = '1';
|
||||
process.env.GVR_BOT_TOKEN = GVR_TOKEN;
|
||||
const RELAY = process.env.GVR_E2E_RELAY === '1';
|
||||
let relayStop: (() => Promise<void>) | null = null;
|
||||
let settings: any;
|
||||
if (RELAY) {
|
||||
delete process.env.GVR_BOT_TOKEN;
|
||||
const http = await import('node:http');
|
||||
const { buildServer } = await import('../../site/server/src/app.ts');
|
||||
const { DiscordSource } = await import('../../site/server/src/discord-source.ts');
|
||||
const { AppAuth } = await import('../src/core/auth.ts');
|
||||
const { SettingsStore } = await import('../src/core/settings.ts');
|
||||
const SUPER = '293719842274541579';
|
||||
// 가짜 디스코드 OAuth: code = 로그인할 아이디
|
||||
const dc = http.createServer((req, res) => {
|
||||
res.setHeader('content-type', 'application/json');
|
||||
if (req.url === '/oauth2/token') return void res.end(JSON.stringify({ access_token: SUPER }));
|
||||
if (req.url === '/users/@me') return void res.end(JSON.stringify({ id: SUPER, username: 'e2e', global_name: 'e2e', avatar: null }));
|
||||
res.statusCode = 404;
|
||||
res.end('{}');
|
||||
});
|
||||
await new Promise<void>((r) => dc.listen(0, '127.0.0.1', () => r()));
|
||||
const source = new DiscordSource({ info: (o, m) => console.log('[site]', m ?? '', JSON.stringify(o)), error: (o, m) => console.error('[site]', m ?? '', o) });
|
||||
const { app: site } = await buildServer(
|
||||
{
|
||||
port: 0, host: '127.0.0.1', publicUrl: 'http://placeholder', clientId: 'cid', clientSecret: 's', botToken: GVR_TOKEN,
|
||||
allowedGuilds: [], owners: [SUPER], superAdmins: [SUPER], sessionSecret: 'x'.repeat(32), dataDir: path.join(work, 'site'),
|
||||
webDir: '/nonexistent', version: 'e2e', discordApi: `http://127.0.0.1:${(dc.address() as any).port}`, assetUpstream: {},
|
||||
},
|
||||
{ botSource: source },
|
||||
);
|
||||
site.log.level = 'warn';
|
||||
await site.listen({ host: '127.0.0.1', port: 0 });
|
||||
const base = `http://127.0.0.1:${(site.server.address() as any).port}`;
|
||||
await source.login(GVR_TOKEN);
|
||||
const appDir = path.join(work, 'app');
|
||||
fs.mkdirSync(appDir);
|
||||
fs.copyFileSync(path.join(work, 'settings.json'), path.join(appDir, 'settings.json'));
|
||||
settings = new SettingsStore(appDir);
|
||||
settings.update({ site: { serverUrl: base }, stt: { modelsDir: models } });
|
||||
const auth = new AppAuth(settings, {
|
||||
version: 'e2e',
|
||||
pollMs: 100,
|
||||
openUrl: async (url: string) => {
|
||||
const start = await fetch(url.replace('http://placeholder', base), { redirect: 'manual' });
|
||||
const state = new URL(start.headers.get('location')!).searchParams.get('state')!;
|
||||
await fetch(`${base}/auth/discord/callback?code=${SUPER}&state=${encodeURIComponent(state)}`, { headers: { cookie: start.headers.getSetCookie()[0]!.split(';')[0]! }, redirect: 'manual' });
|
||||
},
|
||||
});
|
||||
const a = await auth.login();
|
||||
if (a.status !== 'ok') throw new Error(`앱 로그인 실패: ${a.status} ${a.error}`);
|
||||
console.log('앱 로그인 (서버 중계 모드):', a.user?.name, a.role);
|
||||
relayStop = async () => {
|
||||
await site.close();
|
||||
await source.destroy();
|
||||
dc.close();
|
||||
};
|
||||
} else process.env.GVR_BOT_TOKEN = GVR_TOKEN;
|
||||
const DEMO = process.env.GVR_E2E_SET === 'demo';
|
||||
const demoSrc = fs.readFileSync(path.join(import.meta.dirname, 'demo-stack.mts'), 'utf8');
|
||||
const SENTENCES = DEMO
|
||||
@@ -47,7 +104,7 @@ for (const [i, s] of SENTENCES.entries()) {
|
||||
clips.push(f);
|
||||
}
|
||||
const { startCore } = await import('../src/core/index.ts');
|
||||
const core = await startCore({ dataDir: work, resourcesDir: path.join(root, 'app', 'resources'), worker: { cmd: path.join(root, 'worker/.venv/bin/python'), args: ['-m', 'gvr_worker'], cwd: path.join(root, 'worker') }, version: 'e2e' });
|
||||
const core = await startCore({ dataDir: RELAY ? path.join(work, 'app') : work, settings, resourcesDir: path.join(root, 'app', 'resources'), worker: { cmd: path.join(root, 'worker/.venv/bin/python'), args: ['-m', 'gvr_worker'], cwd: path.join(root, 'worker') }, version: 'e2e' });
|
||||
const wait = async (fn: () => boolean, ms: number, label: string) => {
|
||||
const t = Date.now();
|
||||
while (!fn()) {
|
||||
@@ -59,6 +116,7 @@ let ok = false;
|
||||
const spk = new Client({ intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildVoiceStates] });
|
||||
try {
|
||||
await wait(() => core.bot.state.status === 'ready', 30000, 'gvr bot ready');
|
||||
if (RELAY) console.log('겜녹이 봇 연결:', core.bot.gateway?.kind, core.bot.state.user?.name);
|
||||
await wait(() => core.stt.status.slots.realtime.state === 'loaded', 120000, 'model');
|
||||
await spk.login(SPEAKER_TOKEN);
|
||||
await new Promise((r) => spk.once('clientReady', r));
|
||||
@@ -120,6 +178,20 @@ try {
|
||||
console.log(`녹음 제외 후 새 발화: ${after - before}개 (0 이어야 함)`);
|
||||
const texts = rows.map((r) => r.text || '').join(' ');
|
||||
ok = rows.length >= SENTENCES.length && /레이즈|오퍼|치킨/.test(texts) && after === before && (!DEMO || cerAvg < 0.15);
|
||||
if (RELAY) {
|
||||
// 서버 중계 모드: 봇은 서버 연결이어야 하고, 앱 데이터 폴더 어디에도 봇 토큰이 없어야 한다
|
||||
const leaked: string[] = [];
|
||||
const scan = (d: string) => {
|
||||
for (const f of fs.readdirSync(d, { withFileTypes: true })) {
|
||||
const p = path.join(d, f.name);
|
||||
if (f.isDirectory()) scan(p);
|
||||
else if (f.isFile() && fs.statSync(p).size < 200 * 1024 * 1024 && fs.readFileSync(p).includes(Buffer.from(GVR_TOKEN))) leaked.push(p);
|
||||
}
|
||||
};
|
||||
scan(path.join(work, 'app'));
|
||||
console.log(`봇 연결 방식: ${core.bot.gateway?.kind} · 앱 데이터에 봇 토큰: ${leaked.length ? leaked.join(', ') : '없음'}`);
|
||||
ok &&= core.bot.gateway?.kind === 'remote' && leaked.length === 0;
|
||||
}
|
||||
conn.destroy();
|
||||
await wait(() => !core.bot.state.recording.active, 20000, 'gvr leaves after speaker').catch(() => console.log('(겜녹이 퇴장 대기 시간 초과)'));
|
||||
console.log('겜녹이 퇴장:', !core.bot.state.recording.active);
|
||||
@@ -128,6 +200,7 @@ try {
|
||||
} finally {
|
||||
await spk.destroy();
|
||||
await core.stop();
|
||||
await relayStop?.();
|
||||
console.log(ok ? 'VOICE E2E PASS' : 'VOICE E2E FAIL');
|
||||
process.exit(ok ? 0 : 1);
|
||||
}
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
import Fastify, { type FastifyInstance } from 'fastify';
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import type { MatchDetail, MatchPlayer, Overview, User, UserProfile, Word } from '@gvr/shared';
|
||||
import type { CulpritAnalysis, CulpritResult, MatchDetail, MatchPlayer, Overview, User, UserProfile, Word } from '@gvr/shared';
|
||||
import type { Culprit } from '../culprit.js';
|
||||
import type { Store, UserRow } from '../db/db.js';
|
||||
import type { Dictionary } from '../dict/dictionary.js';
|
||||
import type { GameManager } from '../games/manager.js';
|
||||
@@ -14,6 +15,7 @@ export interface ApiDeps {
|
||||
timeline: Timeline;
|
||||
games: GameManager;
|
||||
dict: Dictionary;
|
||||
culprit: Culprit;
|
||||
bus: Bus;
|
||||
settings: () => Settings;
|
||||
trainingDir: () => string;
|
||||
@@ -166,6 +168,7 @@ export async function buildApi(d: ApiDeps): Promise<FastifyInstance> {
|
||||
items: p.items,
|
||||
rank: p.rank ?? null,
|
||||
userId: p.puuid ? userOf(p.puuid) : undefined,
|
||||
stats: p.stats,
|
||||
}));
|
||||
const evRows = store.events(m.id);
|
||||
const utts = store.db.prepare('SELECT rowid,* FROM utterances WHERE match_id=? ORDER BY started_at').all(m.id) as any[];
|
||||
@@ -251,6 +254,47 @@ export async function buildApi(d: ApiDeps): Promise<FastifyInstance> {
|
||||
).map(([key, count]) => ({ key, label: d.dict.labels[key] ?? key, count })),
|
||||
}));
|
||||
|
||||
// ---------------------------------------------------------------- 범인찾기 (계획서 v1.1)
|
||||
// /api/culprit/matches* : 사이트(브라우저)가 보는 목록 · 상세
|
||||
// /api/culprit/internal/* : 사이트 서버만 부른다 (AI 자료 만들기 · 결과 저장). 서버가 붙이는 x-gvr-internal 헤더가 있어야 하고,
|
||||
// 서버 중계는 브라우저 요청의 이 헤더를 넘기지 않는다 (relay 가 range · content-type · accept 만 넘김)
|
||||
const internalOnly = (req: { headers: Record<string, unknown> }) => req.headers['x-gvr-internal'] === '1';
|
||||
|
||||
app.get<{ Querystring: Record<string, string> }>('/api/culprit/matches', async (req) => {
|
||||
const q = req.query;
|
||||
return d.culprit.list({ game: q.game === 'valorant' || q.game === 'lol' ? q.game : undefined, limit: q.limit ? Number(q.limit) : 50 });
|
||||
});
|
||||
app.get<{ Params: { id: string } }>('/api/culprit/matches/:id', async (req, reply) => {
|
||||
const m = store.getMatch(req.params.id);
|
||||
if (!m) return reply.code(404).send({ error: 'not_found' });
|
||||
return d.culprit.info(m);
|
||||
});
|
||||
app.get<{ Params: { id: string } }>('/api/culprit/internal/:id/input', async (req, reply) => {
|
||||
if (!internalOnly(req)) return reply.code(403).send({ error: 'forbidden' });
|
||||
const m = store.getMatch(req.params.id);
|
||||
if (!m) return reply.code(404).send({ error: 'not_found' });
|
||||
const eligibility = d.culprit.eligibility(m);
|
||||
if (eligibility.state !== 'ready' && eligibility.state !== 'done') return reply.code(409).send({ error: 'not_ready', eligibility });
|
||||
return { eligibility, input: d.culprit.buildInput(m) };
|
||||
});
|
||||
app.put<{ Params: { id: string }; Body: Partial<CulpritAnalysis> & { result?: CulpritResult } }>('/api/culprit/internal/:id/result', async (req, reply) => {
|
||||
if (!internalOnly(req)) return reply.code(403).send({ error: 'forbidden' });
|
||||
const m = store.getMatch(req.params.id);
|
||||
if (!m) return reply.code(404).send({ error: 'not_found' });
|
||||
const b = req.body || {};
|
||||
if (!b.result || !Array.isArray(b.result.players) || !Array.isArray(b.result.teams) || !b.model || !b.createdBy) return reply.code(400).send({ error: 'bad_result' });
|
||||
const saved = d.culprit.save(m.id, {
|
||||
createdAt: Date.now(),
|
||||
createdBy: { id: String(b.createdBy.id), name: String(b.createdBy.name) },
|
||||
model: String(b.model),
|
||||
result: b.result,
|
||||
players: b.players || [],
|
||||
meta: b.meta || {},
|
||||
});
|
||||
d.games.emitMatch(m.id);
|
||||
return saved;
|
||||
});
|
||||
|
||||
return app;
|
||||
}
|
||||
|
||||
|
||||
219
app/src/core/auth.ts
Normal file
@@ -0,0 +1,219 @@
|
||||
// 앱(exe) 디스코드 로그인. 사이트 서버(site/server/src/app-auth.ts)가 유저 명단을 갖고 있다.
|
||||
// - 로그인: 서버에 요청을 만들고 브라우저로 디스코드 로그인 → 결과를 받아 온다 (토큰은 DPAPI 로 암호화 저장)
|
||||
// - 확인: 시작할 때와 10분마다 /app/me. 등록 해제 · 로그아웃되면 바로 잠근다
|
||||
// - 겜녹이 봇 토큰은 받지 않는다. 봇은 사이트 서버가 연결하고 앱은 앱 토큰으로 중계받는다 (discord/gateway.ts)
|
||||
// - 서버에 잠깐 못 붙으면 마지막 확인 후 3일까지는 그대로 쓴다
|
||||
import { EventEmitter } from 'node:events';
|
||||
import type { AppLoginBegin, AppLoginPoll, AppMe, AppRole, AppUserInfo, AppUserRow } from '@gvr/shared';
|
||||
import type { SettingsStore } from './settings.js';
|
||||
import { logger } from './util/log.js';
|
||||
import { secureFetch } from './util/secure-http.js';
|
||||
import { secureServerUrl } from './util/secure-url.js';
|
||||
|
||||
const log = logger('auth');
|
||||
|
||||
export type AuthStatus = 'checking' | 'signed_out' | 'waiting' | 'ok' | 'not_registered' | 'error';
|
||||
export interface AuthState {
|
||||
status: AuthStatus;
|
||||
user: AppUserInfo | null;
|
||||
role: AppRole | null;
|
||||
/** 서버에 못 붙어 마지막 확인 결과로 쓰는 중 */
|
||||
offline: boolean;
|
||||
error: string | null;
|
||||
/** 브라우저 로그인 대기 중이면 연 주소 (브라우저가 안 열렸을 때 다시 열기용) */
|
||||
loginUrl: string | null;
|
||||
verifiedAt: number | null;
|
||||
}
|
||||
|
||||
export interface AuthOptions {
|
||||
version: string;
|
||||
openUrl: (url: string) => void | Promise<void>;
|
||||
/** 서버에 못 붙을 때 마지막 확인으로 버티는 시간 (기본 3일) */
|
||||
offlineGraceMs?: number;
|
||||
pollMs?: number;
|
||||
}
|
||||
|
||||
class HttpError extends Error {
|
||||
constructor(
|
||||
public status: number,
|
||||
public body: any,
|
||||
) {
|
||||
super(body?.message || body?.error || `HTTP ${status}`);
|
||||
}
|
||||
}
|
||||
|
||||
export class AppAuth extends EventEmitter {
|
||||
state: AuthState = { status: 'checking', user: null, role: null, offline: false, error: null, loginUrl: null, verifiedAt: null };
|
||||
private loginSeq = 0;
|
||||
/**
|
||||
* 인증 세대. 확인을 새로 시작하거나 토큰을 지우거나(등록 해제 · 로그아웃) 새로 받으면(로그인) 올라간다.
|
||||
* 늦게 도착한 이전 확인 응답(성공 · 실패 모두)은 버린다 — 잠근 뒤 옛 200 이 앱을 다시 여는 일을 막는다
|
||||
*/
|
||||
private gen = 0;
|
||||
|
||||
constructor(
|
||||
private settings: SettingsStore,
|
||||
private opts: AuthOptions,
|
||||
) {
|
||||
super();
|
||||
}
|
||||
|
||||
get ok(): boolean {
|
||||
return this.state.status === 'ok';
|
||||
}
|
||||
private get server(): string {
|
||||
return secureServerUrl(this.settings.get().site.serverUrl);
|
||||
}
|
||||
|
||||
private set(patch: Partial<AuthState>): void {
|
||||
this.state = { ...this.state, ...patch };
|
||||
this.emit('change', this.state);
|
||||
}
|
||||
|
||||
private async call<T>(method: string, path: string, body?: unknown, token = this.settings.getSecret('appToken')): Promise<T> {
|
||||
const r = await secureFetch(this.server + path, {
|
||||
method,
|
||||
headers: {
|
||||
...(body !== undefined ? { 'content-type': 'application/json' } : {}),
|
||||
...(token ? { authorization: `Bearer ${token}` } : {}),
|
||||
'x-gvr-version': this.opts.version,
|
||||
},
|
||||
body: body !== undefined ? JSON.stringify(body) : undefined,
|
||||
timeoutMs: 15000,
|
||||
});
|
||||
const text = await r.text();
|
||||
let json: any = null;
|
||||
try {
|
||||
json = text ? JSON.parse(text) : null;
|
||||
} catch {
|
||||
/* JSON 아님 */
|
||||
}
|
||||
if (!r.ok) throw new HttpError(r.status, json);
|
||||
return json as T;
|
||||
}
|
||||
|
||||
/** 로그인 정보를 지운다 (등록 해제 · 로그아웃) */
|
||||
private forget(): void {
|
||||
this.gen++;
|
||||
for (const k of ['appToken', 'auth'] as const) if (this.settings.hasSecret(k)) this.settings.setSecret(k, null);
|
||||
}
|
||||
|
||||
/** 저장된 토큰으로 서버에 확인 */
|
||||
async check(): Promise<AuthState> {
|
||||
if (this.state.status === 'waiting') return this.state;
|
||||
const token = this.settings.getSecret('appToken');
|
||||
const gen = ++this.gen;
|
||||
if (!token) {
|
||||
// 등록 해제로 잠긴 화면은 다시 확인해도 그대로 둔다 (봇 중계가 끊기며 바로 확인한 뒤 또 확인이 와도 "등록되지 않은 아이디" 유지)
|
||||
if (this.state.status === 'not_registered') return this.state;
|
||||
this.set({ status: 'signed_out', user: null, role: null, offline: false, error: null, verifiedAt: null });
|
||||
return this.state;
|
||||
}
|
||||
// 응답을 기다리는 사이 다른 확인 · 로그아웃 · 잠금 · 새 로그인이 있었으면 이 응답은 버린다
|
||||
const stale = () => gen !== this.gen || this.settings.getSecret('appToken') !== token;
|
||||
try {
|
||||
const me = await this.call<AppMe>('GET', '/app/me', undefined, token);
|
||||
if (stale()) return this.state;
|
||||
const cache = { user: me.user, role: me.role, verifiedAt: Date.now() };
|
||||
this.settings.setSecret('auth', cache);
|
||||
this.set({ status: 'ok', user: me.user, role: me.role, offline: false, error: null, loginUrl: null, verifiedAt: cache.verifiedAt });
|
||||
} catch (e: any) {
|
||||
const lock = e instanceof HttpError && (e.status === 401 || e.status === 403);
|
||||
// 잠그라는 응답(401 · 403)은 늦게 와도 같은 토큰이면 따른다. 두 확인이 겹치면 서버가 첫 403 에서 세션을 지워
|
||||
// 뒤 확인은 401 을 받는데, 403 을 버리면 "등록되지 않은 아이디" 대신 "로그인 만료"로 잠긴다. 로그인 진행 중에는 건드리지 않는다
|
||||
if (lock ? (this.state.status as AuthStatus) === 'waiting' || this.settings.getSecret('appToken') !== token : stale()) return this.state;
|
||||
if (lock) {
|
||||
const notReg = e.status === 403 && e.body?.error === 'not_registered';
|
||||
log.warn(notReg ? '등록이 해제된 아이디라 잠급니다' : '로그인이 만료되어 잠급니다');
|
||||
const user = notReg ? (e.body?.user ?? this.state.user) : null;
|
||||
this.forget();
|
||||
this.set({ status: notReg ? 'not_registered' : 'signed_out', user, role: null, offline: false, error: notReg ? null : '로그인이 만료되었습니다. 다시 로그인해 주세요', verifiedAt: null });
|
||||
return this.state;
|
||||
}
|
||||
// 서버에 못 붙음: 마지막 확인이 유효 기간 안이면 그대로 쓴다
|
||||
const cache = this.settings.getSecret('auth');
|
||||
const grace = this.opts.offlineGraceMs ?? 3 * 24 * 3600 * 1000;
|
||||
const msg = `사이트 서버에 연결할 수 없습니다 (${e.message})`;
|
||||
if (cache && Date.now() - cache.verifiedAt < grace) {
|
||||
log.warn(`${msg} · 마지막 확인 결과로 계속 사용`);
|
||||
this.set({ status: 'ok', user: cache.user, role: cache.role, offline: true, error: msg, verifiedAt: cache.verifiedAt });
|
||||
} else {
|
||||
log.warn(msg);
|
||||
this.set({ status: 'error', offline: false, error: msg });
|
||||
}
|
||||
}
|
||||
return this.state;
|
||||
}
|
||||
|
||||
/** 브라우저로 디스코드 로그인. 끝나거나 취소될 때까지 기다린다 */
|
||||
async login(): Promise<AuthState> {
|
||||
const seq = ++this.loginSeq;
|
||||
this.gen++; // 진행 중이던 확인 응답은 버린다
|
||||
let b: AppLoginBegin;
|
||||
try {
|
||||
b = await this.call<AppLoginBegin>('POST', '/auth/app/begin', {}, undefined);
|
||||
} catch (e: any) {
|
||||
this.set({ status: 'error', error: `사이트 서버에 연결할 수 없습니다 (${e.message})`, loginUrl: null });
|
||||
return this.state;
|
||||
}
|
||||
this.set({ status: 'waiting', error: null, loginUrl: b.url, user: null, role: null });
|
||||
await this.opts.openUrl(b.url);
|
||||
while (seq === this.loginSeq && Date.now() < b.expiresAt) {
|
||||
await new Promise((r) => setTimeout(r, this.opts.pollMs ?? 2000));
|
||||
if (seq !== this.loginSeq) break;
|
||||
let r: AppLoginPoll;
|
||||
try {
|
||||
r = await this.call<AppLoginPoll>('POST', '/auth/app/poll', { id: b.id, secret: b.secret }, undefined);
|
||||
} catch (e: any) {
|
||||
if (e instanceof HttpError) r = e.body?.state ? e.body : { state: 'error', error: e.message };
|
||||
else continue; // 잠깐 끊김: 계속 기다린다
|
||||
}
|
||||
if (seq !== this.loginSeq) break;
|
||||
if (r.state === 'pending') continue;
|
||||
if (r.state === 'ok') {
|
||||
this.gen++;
|
||||
this.settings.setSecret('appToken', r.token);
|
||||
this.state = { ...this.state, status: 'checking', loginUrl: null };
|
||||
log.info(`로그인: ${r.user.name} (${r.role})`);
|
||||
return this.check();
|
||||
}
|
||||
if (r.state === 'not_registered') {
|
||||
log.warn(`등록되지 않은 아이디로 로그인 시도: ${r.user.id}`);
|
||||
this.set({ status: 'not_registered', user: r.user, role: null, error: null, loginUrl: null });
|
||||
return this.state;
|
||||
}
|
||||
this.set({ status: 'signed_out', error: r.error, loginUrl: null });
|
||||
return this.state;
|
||||
}
|
||||
if (seq === this.loginSeq) this.set({ status: 'signed_out', error: '로그인 시간이 지났습니다. 다시 시도해 주세요', loginUrl: null });
|
||||
return this.state;
|
||||
}
|
||||
|
||||
cancelLogin(): void {
|
||||
this.loginSeq++;
|
||||
if (this.state.status === 'waiting') this.set({ status: 'signed_out', error: null, loginUrl: null });
|
||||
}
|
||||
|
||||
async logout(): Promise<void> {
|
||||
this.loginSeq++;
|
||||
const token = this.settings.getSecret('appToken');
|
||||
// 먼저 로컬에서 지우고 잠근다 (서버 응답을 기다리는 사이 도착한 확인 응답이 다시 열지 못하게)
|
||||
this.forget();
|
||||
this.set({ status: 'signed_out', user: null, role: null, offline: false, error: null, loginUrl: null, verifiedAt: null });
|
||||
if (token) await this.call('POST', '/auth/app/logout', {}, token).catch(() => undefined);
|
||||
}
|
||||
|
||||
// ---- 관리자 화면 (서버가 역할을 다시 확인한다)
|
||||
adminUsers(): Promise<{ users: AppUserRow[] }> {
|
||||
return this.call('GET', '/app/admin/users');
|
||||
}
|
||||
adminAddUser(id: string, role: 'admin' | 'user'): Promise<{ users: AppUserRow[] }> {
|
||||
return this.call('POST', '/app/admin/users', { id: id.trim(), role });
|
||||
}
|
||||
adminSetRole(id: string, role: 'admin' | 'user'): Promise<{ users: AppUserRow[] }> {
|
||||
return this.call('PATCH', `/app/admin/users/${encodeURIComponent(id)}`, { role });
|
||||
}
|
||||
adminRemoveUser(id: string): Promise<{ users: AppUserRow[] }> {
|
||||
return this.call('DELETE', `/app/admin/users/${encodeURIComponent(id)}`);
|
||||
}
|
||||
}
|
||||
455
app/src/core/culprit.ts
Normal file
@@ -0,0 +1,455 @@
|
||||
import type {
|
||||
CulpritAnalysis,
|
||||
CulpritEligibility,
|
||||
CulpritInput,
|
||||
CulpritMatchInfo,
|
||||
CulpritMatchItem,
|
||||
CulpritPlayer,
|
||||
CulpritRefTarget,
|
||||
MatchPlayer,
|
||||
MatchRound,
|
||||
PlayerRating,
|
||||
} from '@gvr/shared';
|
||||
import { rateLol, rateValorant } from '@gvr/shared';
|
||||
import type { EventRow, MatchRow, Store, UtteranceRow } from './db/db.js';
|
||||
import type { GameManager } from './games/manager.js';
|
||||
import { safeJson, type Timeline } from './timeline.js';
|
||||
|
||||
/**
|
||||
* 범인찾기 (계획서 v1.1 4장): "분석할 수 있는 경기" 판정, AI 에 보낼 경기 자료(압축 텍스트) 만들기, 결과 저장.
|
||||
* AI 호출은 사이트 서버가 한다 (API 키는 서버에만 있다). 이 PC 는 자료를 만들고 결과를 저장만 한다.
|
||||
*/
|
||||
|
||||
/** 녹음 공백 허용치: 경기 처음 · 끝 · 중간에 이보다 긴 빈 곳이 있으면 "기록 부족" */
|
||||
export const COVERAGE_GAP_MS = 60000;
|
||||
/** 대화가 이보다 많으면 짧은 잡담부터 줄여서 보낸다 (경기당 비용 상한, 계획서 7장) */
|
||||
export const MAX_UTTERANCES = 2500;
|
||||
|
||||
export const CULPRIT_SCHEMA_SQL = `
|
||||
CREATE TABLE IF NOT EXISTS culprit_analyses (
|
||||
id TEXT PRIMARY KEY,
|
||||
match_id TEXT NOT NULL,
|
||||
created_at INTEGER NOT NULL,
|
||||
created_by TEXT NOT NULL,
|
||||
model TEXT NOT NULL,
|
||||
current INTEGER NOT NULL DEFAULT 1,
|
||||
result TEXT NOT NULL,
|
||||
meta TEXT NOT NULL DEFAULT '{}'
|
||||
);
|
||||
CREATE INDEX IF NOT EXISTS culprit_match ON culprit_analyses(match_id, created_at);
|
||||
`;
|
||||
|
||||
export class Culprit {
|
||||
constructor(
|
||||
private store: Store,
|
||||
private timeline: Timeline,
|
||||
private games: GameManager,
|
||||
) {
|
||||
store.db.exec(CULPRIT_SCHEMA_SQL);
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 판정
|
||||
eligibility(m: MatchRow): CulpritEligibility {
|
||||
const reasons: string[] = [];
|
||||
if (m.status !== 'complete' || !m.ended_at) return { state: 'pending', reasons: ['경기가 아직 끝나지 않았습니다'] };
|
||||
const det = safeJson<any>(m.detail, {});
|
||||
const players: any[] = det.players || [];
|
||||
const gotResult = !det.live && players.length >= 2 && (m.game !== 'valorant' || (det.roundsDetail || []).length > 0);
|
||||
if (!gotResult) reasons.push('경기 결과를 받지 못했습니다');
|
||||
const start = realStart(m);
|
||||
const end = m.ended_at;
|
||||
const gap = this.coverageGap(start, end);
|
||||
if (gap) reasons.push(gap);
|
||||
const pending = (
|
||||
this.store.db.prepare(`SELECT count(*) n FROM utterances WHERE match_id=? AND status='pending' AND audio_deleted=0`).get(m.id) as { n: number }
|
||||
).n;
|
||||
if (reasons.length) return { state: 'blocked', reasons };
|
||||
if (pending) return { state: 'pending', reasons: [`음성 변환 중 (${pending}문장 남음)`] };
|
||||
if (this.current(m.id)) return { state: 'done', reasons: [] };
|
||||
return { state: 'ready', reasons: [] };
|
||||
}
|
||||
|
||||
/** 녹음(봇이 음성채널에 있던 구간)이 경기를 덮는지. 빈 곳이 1분 넘으면 이유 문장, 아니면 null */
|
||||
coverageGap(start: number, end: number): string | null {
|
||||
const sess = this.store.db
|
||||
.prepare('SELECT started_at, ended_at FROM sessions WHERE started_at < ? AND (ended_at IS NULL OR ended_at > ?) ORDER BY started_at')
|
||||
.all(end, start) as { started_at: number; ended_at: number | null }[];
|
||||
if (!sess.length) return '녹음 기록이 없습니다';
|
||||
let cursor = start;
|
||||
let worst: { at: number; ms: number } | null = null;
|
||||
for (const s of sess) {
|
||||
const gs = Math.max(cursor, start);
|
||||
if (s.started_at - gs > COVERAGE_GAP_MS && (!worst || s.started_at - gs > worst.ms)) worst = { at: gs, ms: s.started_at - gs };
|
||||
cursor = Math.max(cursor, s.ended_at ?? Number.MAX_SAFE_INTEGER);
|
||||
}
|
||||
if (end - cursor > COVERAGE_GAP_MS && (!worst || end - cursor > worst.ms)) worst = { at: cursor, ms: end - cursor };
|
||||
if (!worst) return null;
|
||||
const min = Math.max(1, Math.round(worst.ms / 60000));
|
||||
if (worst.at <= start) return `녹음이 경기 시작 ${min}분 뒤에 시작됐습니다`;
|
||||
if (worst.at + worst.ms >= end) return `녹음이 경기 끝나기 ${min}분 전에 끝났습니다`;
|
||||
return `녹음이 경기 중 ${min}분 끊겼습니다`;
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 목록 · 상세
|
||||
list(opts: { game?: string; limit?: number }): CulpritMatchItem[] {
|
||||
const rows = this.store.listMatches({ game: opts.game, limit: Math.min(opts.limit ?? 50, 200) }).filter((m) => m.status !== 'live');
|
||||
return rows.map((m) => {
|
||||
const cur = this.current(m.id);
|
||||
const elig = this.eligibility(m);
|
||||
return {
|
||||
match: this.games.summary(m),
|
||||
eligibility: elig,
|
||||
culprits: cur
|
||||
? cur.result.teams.map((t) => {
|
||||
const p = cur.players.find((x) => x.id === t.culprit);
|
||||
return { team: t.team, name: p?.name ?? t.culprit, character: p?.character ?? null };
|
||||
})
|
||||
: [],
|
||||
};
|
||||
});
|
||||
}
|
||||
|
||||
info(m: MatchRow): CulpritMatchInfo {
|
||||
const det = safeJson<any>(m.detail, {});
|
||||
const players = this.players(m);
|
||||
const utts = this.usableUtterances(m.id);
|
||||
const events = this.store.events(m.id);
|
||||
const history = (
|
||||
this.store.db.prepare('SELECT id, created_at, created_by, model, current FROM culprit_analyses WHERE match_id=? ORDER BY created_at DESC').all(m.id) as any[]
|
||||
).map((r) => ({ id: r.id, at: r.created_at, by: safeJson(r.created_by, { id: '', name: '?' }), model: r.model, current: !!r.current }));
|
||||
return {
|
||||
match: this.games.summary(m),
|
||||
eligibility: this.eligibility(m),
|
||||
sources: {
|
||||
rounds: m.game === 'valorant' ? (det.roundsDetail || []).length : null,
|
||||
events: events.filter((e) => e.type !== 'chat').length,
|
||||
utterances: utts.length,
|
||||
chats: events.filter((e) => e.type === 'chat').length,
|
||||
extraStats: players.some((p) => p.hasExtraStats),
|
||||
},
|
||||
players: players.map(({ hasExtraStats: _x, ...p }) => p),
|
||||
analysis: this.current(m.id),
|
||||
history,
|
||||
};
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 결과
|
||||
current(matchId: string): CulpritAnalysis | null {
|
||||
const r = this.store.db.prepare('SELECT * FROM culprit_analyses WHERE match_id=? AND current=1 ORDER BY created_at DESC LIMIT 1').get(matchId) as any;
|
||||
return r ? rowToAnalysis(r) : null;
|
||||
}
|
||||
|
||||
save(matchId: string, a: Omit<CulpritAnalysis, 'id' | 'matchId'>): CulpritAnalysis {
|
||||
const id = `ca-${matchId}-${a.createdAt}`;
|
||||
const tx = this.store.db.transaction(() => {
|
||||
this.store.db.prepare('UPDATE culprit_analyses SET current=0 WHERE match_id=?').run(matchId);
|
||||
this.store.db
|
||||
.prepare('INSERT OR REPLACE INTO culprit_analyses(id,match_id,created_at,created_by,model,current,result,meta) VALUES(?,?,?,?,?,1,?,?)')
|
||||
.run(id, matchId, a.createdAt, JSON.stringify(a.createdBy), a.model, JSON.stringify({ result: a.result, players: a.players }), JSON.stringify(a.meta));
|
||||
});
|
||||
tx();
|
||||
return this.current(matchId)!;
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- AI 자료
|
||||
/** 참가자 번호(P1~P10): 우리 팀 먼저, 팀 안에서는 경기 기록 순서 */
|
||||
private players(m: MatchRow): (CulpritPlayer & { hasExtraStats: boolean })[] {
|
||||
const det = safeJson<any>(m.detail, {});
|
||||
const raw: MatchPlayer[] = det.players || [];
|
||||
const selfTeam = det.self ? raw.find((p) => p.puuid === det.self)?.team : undefined;
|
||||
const isAlly = (p: MatchPlayer) => p.ally ?? (selfTeam ? p.team === selfTeam : false);
|
||||
const sorted = [...raw.filter(isAlly), ...raw.filter((p) => !isAlly(p))];
|
||||
const accounts = this.store.listAccounts();
|
||||
const speakers = new Set(this.usableUtterances(m.id).map((u) => u.user_id));
|
||||
const ratings = ratePlayers(m, det, raw);
|
||||
return sorted.map((p, i) => {
|
||||
const userId = p.puuid ? accounts.find((a) => a.puuid === p.puuid)?.user_id : undefined;
|
||||
return {
|
||||
id: `P${i + 1}`,
|
||||
puuid: p.puuid,
|
||||
name: p.name ?? '?',
|
||||
team: isAlly(p) ? 'ally' : 'enemy',
|
||||
character: p.character ?? null,
|
||||
userId: userId ?? null,
|
||||
voice: !!userId && speakers.has(userId),
|
||||
...(p.tag ? { tag: p.tag } : {}),
|
||||
...(ratings.get(p.puuid) ? { rating: ratings.get(p.puuid) } : {}),
|
||||
hasExtraStats: !!p.stats,
|
||||
};
|
||||
});
|
||||
}
|
||||
|
||||
private usableUtterances(matchId: string): UtteranceRow[] {
|
||||
return (
|
||||
this.store.db
|
||||
.prepare(`SELECT rowid,* FROM utterances WHERE match_id=? AND text IS NOT NULL AND text<>'' AND (noise=0 OR corrected=1) ORDER BY started_at, id`)
|
||||
.all(matchId) as UtteranceRow[]
|
||||
).filter((u) => !this.store.getUser(u.user_id)?.excluded);
|
||||
}
|
||||
|
||||
/** AI 에 보낼 경기 자료. 숫자 덩어리(JSON) 대신 줄글로 보내 토큰을 아낀다 (계획서 5장) */
|
||||
buildInput(m: MatchRow): CulpritInput {
|
||||
const det = safeJson<any>(m.detail, {});
|
||||
const raw: MatchPlayer[] = det.players || [];
|
||||
const players = this.players(m);
|
||||
const byPuuid = new Map(players.filter((p) => p.puuid).map((p) => [p.puuid, p]));
|
||||
const byUser = new Map(players.filter((p) => p.userId).map((p) => [p.userId!, p]));
|
||||
const statsOf = (p: CulpritPlayer) => raw.find((r) => r.puuid === p.puuid);
|
||||
const refs: Record<string, CulpritRefTarget> = {};
|
||||
const out: string[] = [];
|
||||
const sum = this.games.summary(m);
|
||||
const rounds: MatchRound[] = m.game === 'valorant' ? det.roundsDetail || [] : [];
|
||||
const minutes = m.ended_at ? Math.round((m.ended_at - realStart(m)) / 60000) : 0;
|
||||
const resultKo = sum.win === null ? '결과 모름' : sum.win ? '우리 팀 승리' : '우리 팀 패배';
|
||||
const score = sum.score ? `${sum.score.ally}:${sum.score.enemy}` : '?';
|
||||
const basic = !players.some((p) => p.hasExtraStats);
|
||||
|
||||
// 대화: 너무 많으면 짧은 말부터 뺀다
|
||||
let utts = this.usableUtterances(m.id);
|
||||
const totalUtts = utts.length;
|
||||
if (utts.length > MAX_UTTERANCES) {
|
||||
const keep = new Set([...utts].sort((a, b) => [...(b.text ?? '')].length - [...(a.text ?? '')].length).slice(0, MAX_UTTERANCES).map((u) => u.id));
|
||||
utts = utts.filter((u) => keep.has(u.id));
|
||||
}
|
||||
|
||||
if (m.game === 'valorant') {
|
||||
out.push(`# 경기 발로란트 ${sum.mode} · ${sum.map.name} · ${score} (${resultKo}) · ${rounds.length}라운드 · ${minutes}분`);
|
||||
} else {
|
||||
out.push(`# 경기 리그 오브 레전드 ${sum.mode} · ${sum.map.name} · 킬 ${score} (${resultKo}) · ${minutes}분`);
|
||||
}
|
||||
if (basic) out.push('# 이 경기는 기본 기록만 있다 (피해량 · 첫킬 · 시야 같은 추가 지표 없음)');
|
||||
if (totalUtts > utts.length) out.push(`# 대화가 많아 ${totalUtts}문장 중 짧은 말을 빼고 ${utts.length}문장만 보냄`);
|
||||
|
||||
// 참가자
|
||||
if (m.game === 'valorant') {
|
||||
const nRounds = rounds.length || 1;
|
||||
out.push('# 참가자 (번호 이름 팀 요원(역할) K/D/A ACS 라운드당피해 KAST 라운드당피해격차 첫킬/첫데스 헤드샷 설치/해체 스킬사용 음성)');
|
||||
for (const p of players) {
|
||||
const s = statsOf(p);
|
||||
const x = s?.stats;
|
||||
const cols = [
|
||||
p.id,
|
||||
p.name,
|
||||
p.team === 'ally' ? '우리' : '상대',
|
||||
`${p.character?.name ?? '?'}${x?.role ? `(${x.role})` : ''}`,
|
||||
`${s?.kills ?? 0}/${s?.deaths ?? 0}/${s?.assists ?? 0}`,
|
||||
`ACS${Math.round((s?.score ?? 0) / (x?.rounds || nRounds))}`,
|
||||
x ? `ADR${Math.round((x.damage ?? 0) / (x.rounds || nRounds))}` : 'ADR?',
|
||||
x?.kastRounds !== undefined ? `KAST${Math.round((x.kastRounds / (x.rounds || nRounds)) * 100)}%` : '',
|
||||
x?.damageTaken !== undefined ? `피해격차${signedNum(Math.round(((x.damage ?? 0) - x.damageTaken) / (x.rounds || nRounds)))}` : '',
|
||||
x ? `첫킬${x.firstKills ?? 0}/첫데스${x.firstDeaths ?? 0}` : '',
|
||||
x?.headshotPct !== undefined ? `HS${x.headshotPct}%` : '',
|
||||
x ? `설치${x.plants ?? 0}/해체${x.defuses ?? 0}` : '',
|
||||
x?.abilityCasts !== undefined ? `스킬${x.abilityCasts}` : '',
|
||||
s?.rank ? `랭크:${s.rank}` : '',
|
||||
p.voice ? '음성O' : '음성X',
|
||||
];
|
||||
out.push(cols.filter(Boolean).join(' '));
|
||||
}
|
||||
} else {
|
||||
out.push('# 참가자 (번호 이름 팀 챔피언(포지션 추정) K/D/A CS 골드 챔피언피해 받은피해 시야 와드설치/제거/제어와드 10분CS·골드 15분CS·골드 음성)');
|
||||
for (const p of players) {
|
||||
const s = statsOf(p);
|
||||
const x = s?.stats;
|
||||
const at = (a?: { cs: number; gold: number }) => (a ? `${a.cs}·${a.gold}` : '?');
|
||||
const cols = [
|
||||
p.id,
|
||||
p.name,
|
||||
p.team === 'ally' ? '우리' : '상대',
|
||||
`${p.character?.name ?? '?'}${x?.role ? `(${x.role})` : ''}`,
|
||||
`${s?.kills ?? 0}/${s?.deaths ?? 0}/${s?.assists ?? 0}`,
|
||||
`CS${s?.cs ?? '?'}`,
|
||||
`골드${s?.gold ?? '?'}`,
|
||||
x ? `딜${x.damage ?? '?'} 받은${x.damageTaken ?? '?'} 시야${x.vision ?? '?'} 와드${x.wardsPlaced ?? 0}/${x.wardsKilled ?? 0}/${x.controlWards ?? 0}` : '',
|
||||
x ? `10분${at(x.at10)} 15분${at(x.at15)}` : '',
|
||||
p.voice ? '음성O' : '음성X',
|
||||
];
|
||||
out.push(cols.filter(Boolean).join(' '));
|
||||
}
|
||||
}
|
||||
for (const p of players) refs[`s:${p.id}`] = { kind: 'stat', pid: p.id };
|
||||
out.push(...ratingLines(m.game, players));
|
||||
|
||||
// 게임 계정이 연결되지 않은 화자
|
||||
const others = [...new Set(utts.map((u) => u.user_id))].filter((uid) => !byUser.has(uid));
|
||||
const speakerName = new Map<string, string>();
|
||||
for (const uid of others) speakerName.set(uid, `${this.store.getUser(uid)?.name ?? uid}(게임 계정 모름)`);
|
||||
if (others.length) out.push(`# 음성 화자 중 게임 계정을 모르는 사람: ${others.map((u) => speakerName.get(u)).join(', ')}`);
|
||||
const who = (uid: string) => byUser.get(uid)?.id ?? speakerName.get(uid) ?? uid;
|
||||
const pRef = (r: any) => (r?.puuid && byPuuid.get(r.puuid)?.id) || r?.name || '?';
|
||||
|
||||
if (m.game === 'lol') {
|
||||
const gd: { t: number; diff: number }[] = det.goldDiff || [];
|
||||
const pts = [5, 10, 15, 20, 25, 30, 35, 40, 45, 50]
|
||||
.map((min) => gd.find((g) => Math.round(g.t / 60000) === min))
|
||||
.filter(Boolean) as { t: number; diff: number }[];
|
||||
if (pts.length) out.push(`# 골드 차(우리-상대): ${pts.map((g) => `${Math.round(g.t / 60000)}분 ${g.diff >= 0 ? '+' : ''}${g.diff.toLocaleString('en-US')}`).join(' · ')}`);
|
||||
}
|
||||
|
||||
out.push('# 시간 순서 기록');
|
||||
type Line = { ts: number; order: number; text: string };
|
||||
const lines: Line[] = [];
|
||||
let ei = 0;
|
||||
let ci = 0;
|
||||
const events = this.store.events(m.id);
|
||||
for (const e of events) {
|
||||
if (e.type === 'round_end' || e.type === 'match_start' || e.type === 'match_end') continue;
|
||||
if (e.id.includes(':live-round:')) continue;
|
||||
const d = safeJson<any>(e.data, {});
|
||||
const t = this.timeline.eventItem(e).time.primary.replace(' · ', ' ');
|
||||
if (e.type === 'chat') {
|
||||
const key = `c${++ci}`;
|
||||
refs[key] = { kind: 'event', id: e.id, ts: e.ts, round: e.round ?? undefined };
|
||||
const ch = d.channel === 'all' ? '전체채팅' : d.channel === 'party' ? '파티채팅' : '팀채팅';
|
||||
const sender = (d.sender?.puuid && byPuuid.get(d.sender.puuid)?.id) || d.sender?.name || '?';
|
||||
lines.push({ ts: e.ts, order: 1, text: `[${key}] ${t} ${ch} ${sender}: ${clip(String(d.text ?? ''), 200)}` });
|
||||
continue;
|
||||
}
|
||||
const desc = describeEvent(e, d, pRef);
|
||||
if (!desc) continue;
|
||||
const key = `e${++ei}`;
|
||||
refs[key] = { kind: 'event', id: e.id, ts: e.ts, round: e.round ?? undefined };
|
||||
lines.push({ ts: e.ts, order: 0, text: `[${key}] ${t} ${desc}` });
|
||||
}
|
||||
// 라운드 요약 (발로란트): 라운드 끝에 넣는다
|
||||
for (const r of rounds) {
|
||||
const key = `r${r.num}`;
|
||||
refs[key] = { kind: 'round', round: r.num, ts: r.startedAt };
|
||||
lines.push({ ts: r.endedAt, order: 2, text: `[${key}] ${roundLine(r, players)}` });
|
||||
}
|
||||
let ui = 0;
|
||||
for (const u of utts) {
|
||||
const key = `u${++ui}`;
|
||||
refs[key] = { kind: 'utterance', id: u.id, ts: u.started_at };
|
||||
const t = this.timeline.utteranceItem(u).time.primary.replace(' · ', ' ');
|
||||
lines.push({ ts: u.started_at, order: 1, text: `[${key}] ${t} ${who(u.user_id)}: ${clip(u.text ?? '', 300)}` });
|
||||
}
|
||||
lines.sort((a, b) => a.ts - b.ts || a.order - b.order);
|
||||
for (const l of lines) out.push(l.text);
|
||||
|
||||
return {
|
||||
game: m.game,
|
||||
text: out.join('\n'),
|
||||
refs,
|
||||
players: players.map(({ hasExtraStats: _x, ...p }) => p),
|
||||
stats: { utterances: utts.length, utterancesTotal: totalUtts, events: ei, chats: ci, rounds: rounds.length, basic },
|
||||
lookup: {
|
||||
riotMatchId: m.id.replace(/^(val|lol)-/, '') || null,
|
||||
startedAt: realStart(m),
|
||||
endedAt: m.ended_at ?? realStart(m),
|
||||
durationSec: Math.round(((m.ended_at ?? realStart(m)) - realStart(m)) / 1000),
|
||||
},
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
/** 기록 점수 (OP.GG OP스코어 방식, packages/shared/src/rating.ts). 경기 결과가 없으면 빈 값 */
|
||||
function ratePlayers(m: MatchRow, det: any, list: MatchPlayer[]): Map<string, PlayerRating> {
|
||||
if (det.live || list.length < 2) return new Map();
|
||||
const selfTeam = det.self ? list.find((p) => p.puuid === det.self)?.team : undefined;
|
||||
const raw = list.map((p) => ({ ...p, ally: p.ally ?? (selfTeam ? p.team === selfTeam : false) }));
|
||||
if (m.game === 'valorant') {
|
||||
const rounds: MatchRound[] = det.roundsDetail || [];
|
||||
return rounds.length ? rateValorant(raw, rounds) : new Map();
|
||||
}
|
||||
const minutes = m.ended_at ? (m.ended_at - realStart(m)) / 60000 : 0;
|
||||
if (minutes < 1) return new Map();
|
||||
const win = safeJson<{ win?: boolean | null }>(m.result, {}).win;
|
||||
return rateLol(raw, minutes, typeof win === 'boolean' ? win : null);
|
||||
}
|
||||
|
||||
/** AI 자료의 "기록 점수" 칸: 점수 · 순위 · MVP/ACE · 점수를 올리고 깎은 지표 · 롤 라인전 */
|
||||
function ratingLines(game: string, players: CulpritPlayer[]): string[] {
|
||||
if (!players.some((p) => p.rating)) return [];
|
||||
const head =
|
||||
game === 'valorant'
|
||||
? '# 기록 점수 (0~10, OP.GG OP스코어 방식: 라운드 승률 · KAST · ACS · 피해 격차를 실제 OP.GG 점수에 맞춘 계산. 경기 순위/팀 순위, 경기 평균보다 점수를 올린 강점 · 깎은 약점)'
|
||||
: '# 기록 점수 (0~10, OP.GG OP스코어 방식: 킬 관여 · 데스 · 딜/받은 피해 · 골드 · CS · 레벨 · CC · 와드를 실제 OP.GG 점수에 맞춘 계산. 경기 순위/팀 순위, 경기 평균보다 점수를 올린 강점 · 깎은 약점, 라인전 = LOL.PS 방식 15분 맞라인 상대와의 차)';
|
||||
const out = [head];
|
||||
if (players.some((p) => p.rating?.basic)) out.push('# (추가 지표가 없어 K/D/A · 골드 · CS 같은 기본 기록으로만 낸 점수다)');
|
||||
const idOf = new Map(players.map((p) => [p.puuid, p.id]));
|
||||
for (const p of players) {
|
||||
const r = p.rating;
|
||||
if (!r) continue;
|
||||
const up = r.parts.filter((x) => x.good).map((x) => x.text);
|
||||
const down = r.parts.filter((x) => !x.good).map((x) => x.text);
|
||||
const parts = [up.length ? `강점 ${up.join(', ')}` : '', down.length ? `약점 ${down.join(', ')}` : ''].filter(Boolean).join(' / ');
|
||||
const lane = r.lane ? ` 라인전(15분 vs ${idOf.get(r.lane.vs) ?? '?'}) CS${signedNum(r.lane.cs)} 골드${signedNum(r.lane.gold)} 경험치${signedNum(r.lane.xp)}` : '';
|
||||
out.push(`${p.id} ${r.score.toFixed(1)}점 ${r.rank}위/팀${r.teamRank}위${r.badge ? ` ${r.badge}` : ''}${parts ? ` · ${parts}` : ''}${lane ? ` ·${lane}` : ''}`);
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
function signedNum(n: number): string {
|
||||
return `${n >= 0 ? '+' : ''}${n.toLocaleString('en-US')}`;
|
||||
}
|
||||
|
||||
function realStart(m: MatchRow): number {
|
||||
return m.started_at + m.clock_offset;
|
||||
}
|
||||
|
||||
function clip(s: string, n: number): string {
|
||||
const t = s.replace(/\s+/g, ' ').trim();
|
||||
return [...t].length > n ? [...t].slice(0, n).join('') + '…' : t;
|
||||
}
|
||||
|
||||
function describeEvent(e: EventRow, d: any, pRef: (r: any) => string): string | null {
|
||||
switch (e.type) {
|
||||
case 'kill': {
|
||||
const as = (d.assists || []).map(pRef);
|
||||
const weapon = d.weapon?.name ? ` (${d.weapon.name})` : '';
|
||||
return `킬 ${d.killer ? pRef(d.killer) : '?'} → ${pRef(d.victim)}${weapon}${as.length ? ` 어시 ${as.join(',')}` : ''}`;
|
||||
}
|
||||
case 'multikill':
|
||||
return `멀티킬 ${pRef(d.player)} ${d.count}킬`;
|
||||
case 'ace':
|
||||
return `에이스 ${pRef(d.player)}`;
|
||||
case 'spike':
|
||||
return d.action === 'defuse' ? `스파이크 해체 ${pRef(d.player)}` : `스파이크 설치 ${pRef(d.player)}${d.site ? ` (${d.site})` : ''}`;
|
||||
case 'object': {
|
||||
const team = d.ally === true ? '우리 팀' : d.ally === false ? '상대 팀' : '';
|
||||
const who = d.killer && d.object !== 'tower' && d.object !== 'inhibitor' ? ` · ${pRef(d.killer)}` : '';
|
||||
return `${d.label || d.object} ${d.object === 'tower' || d.object === 'inhibitor' ? '' : '처치 '}${team}${who}`.replace(/\s+/g, ' ').trim();
|
||||
}
|
||||
default:
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
function roundLine(r: MatchRound, players: CulpritPlayer[]): string {
|
||||
const side = r.allyAttack === undefined ? '' : r.allyAttack ? ' 우리 공격' : ' 우리 수비';
|
||||
const avg = (team: 'ally' | 'enemy') => {
|
||||
const vals = players
|
||||
.filter((p) => p.team === team)
|
||||
.map((p) => r.economy?.[p.puuid]?.loadout)
|
||||
.filter((v): v is number => typeof v === 'number');
|
||||
return vals.length ? Math.round(vals.reduce((a, b) => a + b, 0) / vals.length) : null;
|
||||
};
|
||||
const a = avg('ally');
|
||||
const en = avg('enemy');
|
||||
const eco = a !== null && en !== null ? ` · 평균 장비 우리 ${a.toLocaleString('en-US')} / 상대 ${en.toLocaleString('en-US')}` : '';
|
||||
const per = players
|
||||
.map((p) => {
|
||||
const ec = r.economy?.[p.puuid];
|
||||
const st = r.players?.[p.puuid];
|
||||
if (!ec && !st) return null;
|
||||
const lo = ec?.loadout !== undefined ? `${(ec.loadout / 1000).toFixed(1)}k` : ec ? `${(ec.spent / 1000).toFixed(1)}k쓴` : '?';
|
||||
return `${p.id} ${lo}${st ? `/${st.damage}` : ''}`;
|
||||
})
|
||||
.filter(Boolean);
|
||||
return `R${r.num}${side} 라운드 끝 · ${r.win ? '승리' : '패배'}(${r.result}) ${r.score.ally}:${r.score.enemy}${eco}${per.length ? ` · 선수 장비/피해: ${per.join(' ')}` : ''}`;
|
||||
}
|
||||
|
||||
function rowToAnalysis(r: any): CulpritAnalysis {
|
||||
const body = safeJson<any>(r.result, {});
|
||||
return {
|
||||
id: r.id,
|
||||
matchId: r.match_id,
|
||||
createdAt: r.created_at,
|
||||
createdBy: safeJson(r.created_by, { id: '', name: '?' }),
|
||||
model: r.model,
|
||||
result: body.result,
|
||||
players: body.players || [],
|
||||
meta: safeJson(r.meta, {}),
|
||||
};
|
||||
}
|
||||
@@ -10,36 +10,18 @@ import {
|
||||
type AudioPlayer,
|
||||
type VoiceConnection,
|
||||
} from '@discordjs/voice';
|
||||
import {
|
||||
ChannelType,
|
||||
Client,
|
||||
Events,
|
||||
GatewayIntentBits,
|
||||
MessageFlags,
|
||||
type ChatInputCommandInteraction,
|
||||
type Guild,
|
||||
type GuildMember,
|
||||
type VoiceBasedChannel,
|
||||
type VoiceState,
|
||||
} from 'discord.js';
|
||||
import fs from 'node:fs';
|
||||
import type { Store } from '../db/db.js';
|
||||
import type { Settings } from '../settings.js';
|
||||
import type { Bus } from '../util/events.js';
|
||||
import { newId } from '../util/ids.js';
|
||||
import type { BotGateway, GChannel, GCommand, GMember, GVoiceEvent } from './gateway.js';
|
||||
import { logger } from '../util/log.js';
|
||||
import type { Recorder } from './recorder.js';
|
||||
import type { Announcer } from './tts.js';
|
||||
|
||||
const log = logger('bot');
|
||||
|
||||
export const COMMANDS = [
|
||||
{ name: '녹음시작', description: '겜녹이를 내가 있는 음성채널로 불러 녹음을 시작합니다' },
|
||||
{ name: '녹음종료', description: '겜녹이가 음성채널에서 나가고 녹음을 끝냅니다' },
|
||||
{ name: '녹음제외', description: '내 목소리를 녹음하지 않습니다 (다음 세션에도 유지)' },
|
||||
{ name: '녹음참여', description: '녹음 제외를 풀고 다시 녹음에 참여합니다' },
|
||||
];
|
||||
|
||||
export interface BotState {
|
||||
status: 'off' | 'connecting' | 'ready' | 'error';
|
||||
error: string | null;
|
||||
@@ -52,9 +34,10 @@ export interface BotState {
|
||||
/**
|
||||
* 디스코드 봇: 나를 따라 음성채널에 들어가거나(/녹음시작) 명령으로 참여하고, TTS 로 녹음 사실을 알린다 (Q7, Q8).
|
||||
* 채팅 메시지는 보내지 않는다. 명령 응답은 본인에게만 보인다.
|
||||
* 디스코드 연결은 BotGateway 가 맡는다 (겜녹이 봇 = 사이트 서버 중계, 다른 봇 = 이 PC 가 직접 연결)
|
||||
*/
|
||||
export class Bot {
|
||||
client: Client | null = null;
|
||||
gateway: BotGateway | null = null;
|
||||
private connection: VoiceConnection | null = null;
|
||||
private player: AudioPlayer | null = null;
|
||||
private sessionId: string | null = null;
|
||||
@@ -77,134 +60,162 @@ export class Bot {
|
||||
private onGuild?: (guildId: string) => void,
|
||||
) {}
|
||||
|
||||
async start(token: string): Promise<void> {
|
||||
async start(gw: BotGateway): Promise<void> {
|
||||
await this.stop();
|
||||
this.state.status = 'connecting';
|
||||
this.state.error = null;
|
||||
const client = new Client({
|
||||
intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildVoiceStates, GatewayIntentBits.GuildMembers],
|
||||
});
|
||||
this.client = client;
|
||||
client.on(Events.ClientReady, () => void this.onReady());
|
||||
client.on(Events.VoiceStateUpdate, (o, n) => void this.onVoiceState(o, n).catch((e) => log.error('voiceState 처리 오류', e)));
|
||||
client.on(Events.InteractionCreate, (i) => {
|
||||
if (i.isChatInputCommand()) void this.onCommand(i).catch((e) => log.error('명령 처리 오류', e));
|
||||
});
|
||||
client.on(Events.Error, (e) => log.error('discord 오류', e));
|
||||
client.on(Events.GuildCreate, () => this.refreshGuilds());
|
||||
this.gateway = gw;
|
||||
const mine = (fn: (...a: any[]) => void) => (...a: any[]) => {
|
||||
if (this.gateway === gw) fn(...a);
|
||||
};
|
||||
gw.on('ready', mine(() => void this.onReady().catch((e) => log.error('봇 준비 처리 오류', e))));
|
||||
gw.on('guilds', mine(() => this.refreshGuilds()));
|
||||
gw.on('voiceState', mine((e: GVoiceEvent) => void this.onVoiceState(e).catch((err) => log.error('voiceState 처리 오류', err))));
|
||||
gw.on('command', mine((c: GCommand, respond: (content: string) => void) => void this.onCommand(c).then(respond, (e) => respond(`처리하지 못했습니다: ${e.message}`))));
|
||||
gw.on('taken', mine((guildId: string) => {
|
||||
if (this.connection && this.state.recording.channelId && this.state.guild?.id === guildId) {
|
||||
log.warn('다른 PC 가 이 서버에서 겜녹이 봇을 데려가 녹음을 멈춥니다');
|
||||
this.leave('taken');
|
||||
}
|
||||
}));
|
||||
gw.on('down', mine(() => {
|
||||
this.leave('gateway-down');
|
||||
this.state.status = 'connecting';
|
||||
this.state.error = '연결이 끊겨 다시 연결하는 중입니다';
|
||||
}));
|
||||
gw.on('unauthorized', mine(() => {
|
||||
this.state.status = 'error';
|
||||
this.state.error = '로그인이 만료되었거나 등록이 해제되었습니다';
|
||||
}));
|
||||
try {
|
||||
await client.login(token);
|
||||
await gw.start();
|
||||
} catch (e: any) {
|
||||
if (this.gateway !== gw) return;
|
||||
this.state.status = 'error';
|
||||
this.state.error = e?.message?.includes('TOKEN_INVALID') || e?.code === 'TokenInvalid' ? '봇 토큰이 올바르지 않습니다' : e.message;
|
||||
this.client = null;
|
||||
// 겜녹이 봇(서버 중계)은 뒤에서 계속 다시 붙는다. 다른 봇은 토큰이 틀렸을 수 있으니 멈춘다
|
||||
if (gw.kind === 'local') {
|
||||
this.gateway = null;
|
||||
await gw.stop().catch(() => undefined);
|
||||
}
|
||||
throw e;
|
||||
}
|
||||
}
|
||||
|
||||
async stop(): Promise<void> {
|
||||
this.leave('stop');
|
||||
if (this.client) {
|
||||
await this.client.destroy();
|
||||
this.client = null;
|
||||
const gw = this.gateway;
|
||||
this.gateway = null;
|
||||
if (gw) {
|
||||
gw.removeAllListeners();
|
||||
await gw.stop();
|
||||
}
|
||||
this.state.status = 'off';
|
||||
this.state.user = null;
|
||||
}
|
||||
|
||||
/** 녹음에서 빼야 하는 다른 봇인지 */
|
||||
isBot(userId: string): boolean {
|
||||
return !!this.gateway?.isBot(userId);
|
||||
}
|
||||
|
||||
private refreshGuilds(): void {
|
||||
if (!this.client) return;
|
||||
this.state.guilds = [...this.client.guilds.cache.values()].map((g) => ({ id: g.id, name: g.name }));
|
||||
this.state.guilds = (this.gateway?.guilds() ?? []).map((g) => ({ id: g.id, name: g.name }));
|
||||
}
|
||||
|
||||
guild(): Guild | null {
|
||||
if (!this.client) return null;
|
||||
/** 녹음할 디스코드 서버 아이디 (설정값, 없으면 봇이 들어간 첫 서버) */
|
||||
guildId(): string | null {
|
||||
const gs = this.gateway?.guilds() ?? [];
|
||||
const id = this.settings().discord.guildId;
|
||||
return (id && this.client.guilds.cache.get(id)) || this.client.guilds.cache.first() || null;
|
||||
return (id && gs.find((g) => g.id === id)?.id) || gs[0]?.id || null;
|
||||
}
|
||||
|
||||
members(): Promise<GMember[]> {
|
||||
const gid = this.guildId();
|
||||
return gid && this.gateway ? this.gateway.members(gid) : Promise.resolve([]);
|
||||
}
|
||||
|
||||
private async onReady(): Promise<void> {
|
||||
const c = this.client!;
|
||||
const gw = this.gateway!;
|
||||
const me = gw.me()!;
|
||||
this.state.status = 'ready';
|
||||
this.state.user = { id: c.user!.id, name: c.user!.username, avatar: c.user!.displayAvatarURL({ size: 128 }) };
|
||||
this.state.error = null;
|
||||
this.state.user = { id: me.id, name: me.name, avatar: me.avatar };
|
||||
this.refreshGuilds();
|
||||
const g = this.guild();
|
||||
log.info(`봇 로그인: ${c.user!.tag}, 서버 ${this.state.guilds.map((x) => x.name).join(', ')}`);
|
||||
if (!g) return;
|
||||
this.state.guild = { id: g.id, name: g.name, icon: g.iconURL({ size: 128 }) };
|
||||
log.info(`봇 로그인: ${me.name}${gw.kind === 'remote' ? ' (사이트 서버 중계)' : ''}, 서버 ${this.state.guilds.map((x) => x.name).join(', ')}`);
|
||||
const gid = this.guildId();
|
||||
if (!gid) return;
|
||||
const g = await gw.watch(gid, { commands: this.settings().discord.commandsEnabled });
|
||||
if (!g || this.gateway !== gw) return;
|
||||
this.state.guild = { id: g.id, name: g.name, icon: g.icon };
|
||||
this.onGuild?.(g.id);
|
||||
if (this.settings().discord.commandsEnabled) {
|
||||
try {
|
||||
await g.commands.set(COMMANDS);
|
||||
log.info('슬래시 명령 등록 완료');
|
||||
} catch (e) {
|
||||
log.warn('슬래시 명령 등록 실패', e);
|
||||
}
|
||||
}
|
||||
// 이미 따라갈 유저가 음성채널에 있으면 바로 들어간다
|
||||
const follow = this.settings().discord.followUserId;
|
||||
if (follow && this.settings().discord.followEnabled) {
|
||||
const m = await g.members.fetch(follow).catch(() => null);
|
||||
if (m?.voice.channel) await this.join(m.voice.channel, 'follow');
|
||||
const ch = gw.voiceChannelOf(g.id, follow);
|
||||
if (ch) await this.join(ch, 'follow').catch((e) => log.warn(`따라가기 실패: ${e.message}`));
|
||||
}
|
||||
}
|
||||
|
||||
private async onVoiceState(o: VoiceState, n: VoiceState): Promise<void> {
|
||||
const g = this.guild();
|
||||
if (!g || n.guild.id !== g.id) return;
|
||||
private async onVoiceState(e: GVoiceEvent): Promise<void> {
|
||||
const gid = this.state.guild?.id;
|
||||
if (!gid || e.guildId !== gid) return;
|
||||
const s = this.settings().discord;
|
||||
const uid = n.id;
|
||||
if (uid === this.client?.user?.id) {
|
||||
const uid = e.member.id;
|
||||
if (uid === this.state.user?.id) {
|
||||
// 누군가 봇을 끊었으면 세션 종료
|
||||
if (o.channelId && !n.channelId) this.leave('kicked');
|
||||
if (e.oldChannelId && !e.newChannelId) this.leave('kicked');
|
||||
return;
|
||||
}
|
||||
// 따라가기
|
||||
if (s.followEnabled && s.followUserId === uid && o.channelId !== n.channelId) {
|
||||
if (n.channel) await this.join(n.channel, 'follow');
|
||||
if (s.followEnabled && s.followUserId === uid && e.oldChannelId !== e.newChannelId) {
|
||||
if (e.channel) await this.join(e.channel, 'follow');
|
||||
else if (this.state.recording.reason === 'follow') this.leave('follow-left');
|
||||
}
|
||||
const myCh = this.state.recording.channelId;
|
||||
if (!myCh) return;
|
||||
// 새 사람이 들어오면 안내를 다시 튼다
|
||||
if (n.channelId === myCh && o.channelId !== myCh && n.member && (!n.member.user.bot || process.env.GVR_RECORD_BOTS === '1')) {
|
||||
this.touchUser(n.member);
|
||||
if (e.newChannelId === myCh && e.oldChannelId !== myCh && (!e.member.bot || process.env.GVR_RECORD_BOTS === '1')) {
|
||||
this.touchUser(e.member);
|
||||
this.updateParticipants();
|
||||
if (s.ttsEnabled && s.ttsOnNewMember) void this.announce();
|
||||
}
|
||||
if (o.channelId === myCh && n.channelId !== myCh) this.updateParticipants();
|
||||
if (e.oldChannelId === myCh && e.newChannelId !== myCh) this.updateParticipants();
|
||||
}
|
||||
|
||||
private touchUser(m: GuildMember): void {
|
||||
this.store.upsertUser({ id: m.id, name: m.displayName, avatar: m.displayAvatarURL({ size: 128 }) });
|
||||
private touchUser(m: GMember): void {
|
||||
this.store.upsertUser({ id: m.id, name: m.name, avatar: m.avatar });
|
||||
}
|
||||
|
||||
private channelMembers(): GMember[] {
|
||||
const id = this.state.recording.channelId;
|
||||
const gid = this.state.guild?.id;
|
||||
return id && gid && this.gateway ? this.gateway.channelMembers(gid, id) : [];
|
||||
}
|
||||
|
||||
private updateParticipants(): void {
|
||||
const ch = this.currentChannel();
|
||||
const inCh = !!this.state.recording.channelId;
|
||||
// GVR_RECORD_BOTS=1 (테스트봇으로 시험할 때)이면 봇도 사람처럼 센다. 안 그러면 30초 뒤 '빈 방'으로 나가 버린다.
|
||||
const humans = ch ? [...ch.members.values()].filter((m) => !m.user.bot || (process.env.GVR_RECORD_BOTS === '1' && m.id !== this.client?.user?.id)) : [];
|
||||
const humans = this.channelMembers().filter((m) => !m.bot || (process.env.GVR_RECORD_BOTS === '1' && m.id !== this.state.user?.id));
|
||||
this.state.recording.participants = humans.map((m) => m.id);
|
||||
this.emitState();
|
||||
// 사람이 아무도 없으면 30초 뒤 나간다
|
||||
if (this.emptyTimer) clearTimeout(this.emptyTimer);
|
||||
this.emptyTimer = null;
|
||||
if (ch && humans.length === 0) this.emptyTimer = setTimeout(() => this.leave('empty'), 30000);
|
||||
if (inCh && humans.length === 0) this.emptyTimer = setTimeout(() => this.leave('empty'), 30000);
|
||||
}
|
||||
|
||||
private currentChannel(): VoiceBasedChannel | null {
|
||||
const id = this.state.recording.channelId;
|
||||
if (!id || !this.client) return null;
|
||||
const ch = this.client.channels.cache.get(id);
|
||||
return ch && (ch.type === ChannelType.GuildVoice || ch.type === ChannelType.GuildStageVoice) ? (ch as VoiceBasedChannel) : null;
|
||||
}
|
||||
|
||||
async join(channel: VoiceBasedChannel, reason: 'follow' | 'command'): Promise<void> {
|
||||
async join(channel: GChannel, reason: 'follow' | 'command'): Promise<void> {
|
||||
const gw = this.gateway;
|
||||
const gid = this.state.guild?.id;
|
||||
if (!gw || !gid) throw new Error('봇이 준비되지 않았습니다');
|
||||
if (this.state.recording.channelId === channel.id && this.connection) return;
|
||||
if (this.connection) this.leave('move');
|
||||
log.info(`음성채널 참여: ${channel.name} (${reason})`);
|
||||
const conn = joinVoiceChannel({
|
||||
channelId: channel.id,
|
||||
guildId: channel.guild.id,
|
||||
adapterCreator: channel.guild.voiceAdapterCreator,
|
||||
guildId: gid,
|
||||
adapterCreator: gw.adapterCreator(gid),
|
||||
selfDeaf: false,
|
||||
selfMute: false,
|
||||
daveEncryption: true,
|
||||
@@ -221,20 +232,29 @@ export class Bot {
|
||||
if (this.connection === conn) this.leave('disconnected');
|
||||
}
|
||||
});
|
||||
// 연결 통로가 끊겨 어댑터가 사라진 경우 (서버 중계 끊김 등)
|
||||
conn.on(VoiceConnectionStatus.Destroyed, () => {
|
||||
if (this.connection === conn) this.leave('destroyed');
|
||||
});
|
||||
try {
|
||||
await entersState(conn, VoiceConnectionStatus.Ready, 20000);
|
||||
} catch (e) {
|
||||
log.error('음성채널 연결 실패', e);
|
||||
conn.destroy();
|
||||
if (this.connection === conn) this.connection = null;
|
||||
try {
|
||||
conn.destroy();
|
||||
} catch {
|
||||
/* 이미 끊김 */
|
||||
}
|
||||
throw new Error('음성채널 연결 실패');
|
||||
}
|
||||
if (this.connection !== conn) throw new Error('음성채널 연결이 끊겼습니다');
|
||||
const now = Date.now();
|
||||
this.sessionId = newId(now);
|
||||
this.store.startSession(this.sessionId, channel.guild.id, channel.id, channel.name, now);
|
||||
for (const m of channel.members.values()) if (!m.user.bot || process.env.GVR_RECORD_BOTS === '1') this.touchUser(m);
|
||||
this.bus.live({ type: 'users.updated', data: [] });
|
||||
this.store.startSession(this.sessionId, gid, channel.id, channel.name, now);
|
||||
this.state.recording = { active: true, channel: channel.name, channelId: channel.id, since: now, participants: [], reason };
|
||||
for (const m of this.channelMembers()) if (!m.bot || process.env.GVR_RECORD_BOTS === '1') this.touchUser(m);
|
||||
this.bus.live({ type: 'users.updated', data: [] });
|
||||
this.recorder.attach(conn, this.sessionId);
|
||||
this.player = createAudioPlayer({ behaviors: { noSubscriber: NoSubscriberBehavior.Pause } });
|
||||
conn.subscribe(this.player);
|
||||
@@ -246,15 +266,16 @@ export class Bot {
|
||||
if (this.emptyTimer) clearTimeout(this.emptyTimer);
|
||||
this.emptyTimer = null;
|
||||
this.recorder.detach();
|
||||
if (this.connection) {
|
||||
const conn = this.connection;
|
||||
this.connection = null;
|
||||
if (conn) {
|
||||
log.info(`음성채널 나감 (${why})`);
|
||||
try {
|
||||
this.connection.destroy();
|
||||
conn.destroy();
|
||||
} catch {
|
||||
/* 이미 끊김 */
|
||||
}
|
||||
}
|
||||
this.connection = null;
|
||||
this.player?.stop(true);
|
||||
this.player = null;
|
||||
if (this.sessionId) this.store.endSession(this.sessionId, Date.now());
|
||||
@@ -284,36 +305,35 @@ export class Bot {
|
||||
this.bus.live({ type: 'recording.state', data: { active: r.active, channel: r.channel, since: r.since, participants: r.participants } });
|
||||
}
|
||||
|
||||
private async onCommand(i: ChatInputCommandInteraction): Promise<void> {
|
||||
const reply = (content: string) => i.reply({ content, flags: MessageFlags.Ephemeral });
|
||||
const member = i.member as GuildMember | null;
|
||||
switch (i.commandName) {
|
||||
/** 슬래시 명령 처리. 돌려준 문장이 본인에게만 보이는 응답이 된다 */
|
||||
private async onCommand(c: GCommand): Promise<string> {
|
||||
if (c.guildId !== this.state.guild?.id) return '이 서버는 겜녹이 앱의 녹음 서버로 설정되어 있지 않습니다.';
|
||||
switch (c.name) {
|
||||
case '녹음시작': {
|
||||
const ch = member?.voice?.channel;
|
||||
if (!ch) return void (await reply('먼저 음성채널에 들어가 주세요.'));
|
||||
await i.deferReply({ flags: MessageFlags.Ephemeral });
|
||||
const ch = c.voiceChannel;
|
||||
if (!ch) return '먼저 음성채널에 들어가 주세요.';
|
||||
try {
|
||||
await this.join(ch, 'command');
|
||||
await i.editReply(`🎙️ ${ch.name} 채널 녹음을 시작했습니다.`);
|
||||
return `🎙️ ${ch.name} 채널 녹음을 시작했습니다.`;
|
||||
} catch (e: any) {
|
||||
await i.editReply(`음성채널에 들어가지 못했습니다: ${e.message}`);
|
||||
return `음성채널에 들어가지 못했습니다: ${e.message}`;
|
||||
}
|
||||
return;
|
||||
}
|
||||
case '녹음종료':
|
||||
if (!this.connection) return void (await reply('지금은 녹음 중이 아닙니다.'));
|
||||
if (!this.connection) return '지금은 녹음 중이 아닙니다.';
|
||||
this.leave('command');
|
||||
return void (await reply('⏹️ 녹음을 끝냈습니다.'));
|
||||
return '⏹️ 녹음을 끝냈습니다.';
|
||||
case '녹음제외':
|
||||
if (member) this.touchUser(member);
|
||||
this.store.setExcluded(i.user.id, true);
|
||||
this.touchUser(c.user);
|
||||
this.store.setExcluded(c.user.id, true);
|
||||
this.bus.live({ type: 'users.updated', data: [] });
|
||||
return void (await reply('🔇 이제부터 내 목소리는 녹음하지 않습니다. 다시 참여하려면 /녹음참여 를 입력하세요.'));
|
||||
return '🔇 이제부터 내 목소리는 녹음하지 않습니다. 다시 참여하려면 /녹음참여 를 입력하세요.';
|
||||
case '녹음참여':
|
||||
if (member) this.touchUser(member);
|
||||
this.store.setExcluded(i.user.id, false);
|
||||
this.touchUser(c.user);
|
||||
this.store.setExcluded(c.user.id, false);
|
||||
this.bus.live({ type: 'users.updated', data: [] });
|
||||
return void (await reply('🎙️ 다시 녹음에 참여합니다.'));
|
||||
return '🎙️ 다시 녹음에 참여합니다.';
|
||||
}
|
||||
return '알 수 없는 명령입니다.';
|
||||
}
|
||||
}
|
||||
|
||||
459
app/src/core/discord/gateway.ts
Normal file
@@ -0,0 +1,459 @@
|
||||
// 봇이 디스코드와 이야기하는 통로 두 가지
|
||||
// - LocalGateway: '다른 봇으로 진행하기' (사용자가 넣은 봇 토큰으로 이 PC 가 직접 연결)
|
||||
// - RemoteGateway: 겜녹이 봇. 봇 토큰은 사이트 서버에만 있고, 이 PC 는 서버(/app/bot/ws)를 거쳐 정보만 받는다.
|
||||
// 음성채널에 들어갈 때 서버가 디스코드에서 받은 일회용 음성 접속 정보를 넘겨주고, 음성은 이 PC ↔ 디스코드로 바로 간다
|
||||
import type { DiscordGatewayAdapterCreator, DiscordGatewayAdapterLibraryMethods } from '@discordjs/voice';
|
||||
import type { BotGwChannel, BotGwFromApp, BotGwGuild, BotGwMember, BotGwToApp } from '@gvr/shared';
|
||||
import { ChannelType, Client, Events, GatewayIntentBits, MessageFlags, type Guild, type GuildMember, type VoiceBasedChannel } from 'discord.js';
|
||||
import { EventEmitter } from 'node:events';
|
||||
import WebSocket from 'ws';
|
||||
import { logger } from '../util/log.js';
|
||||
import { TLS_TRUST } from '../util/secure-http.js';
|
||||
import { wsUrl } from '../util/secure-url.js';
|
||||
|
||||
const log = logger('gateway');
|
||||
|
||||
export type GMember = BotGwMember;
|
||||
export type GGuild = BotGwGuild;
|
||||
export type GChannel = BotGwChannel;
|
||||
export interface GVoiceEvent {
|
||||
guildId: string;
|
||||
member: GMember;
|
||||
oldChannelId: string | null;
|
||||
newChannelId: string | null;
|
||||
channel: GChannel | null;
|
||||
}
|
||||
export interface GCommand {
|
||||
name: string;
|
||||
guildId: string;
|
||||
user: GMember;
|
||||
voiceChannel: GChannel | null;
|
||||
}
|
||||
|
||||
export const COMMANDS = [
|
||||
{ name: '녹음시작', description: '겜녹이를 내가 있는 음성채널로 불러 녹음을 시작합니다' },
|
||||
{ name: '녹음종료', description: '겜녹이가 음성채널에서 나가고 녹음을 끝냅니다' },
|
||||
{ name: '녹음제외', description: '내 목소리를 녹음하지 않습니다 (다음 세션에도 유지)' },
|
||||
{ name: '녹음참여', description: '녹음 제외를 풀고 다시 녹음에 참여합니다' },
|
||||
];
|
||||
|
||||
/**
|
||||
* 이벤트: 'ready' · 'guilds' · 'voiceState' (GVoiceEvent) · 'command' (GCommand, respond(content)) ·
|
||||
* 'taken' (guildId: 다른 PC 가 봇을 데려감) · 'down' (연결 끊김) · 'unauthorized' (앱 로그인 만료 · 등록 해제)
|
||||
*/
|
||||
export interface BotGateway extends EventEmitter {
|
||||
readonly kind: 'local' | 'remote';
|
||||
me(): GMember | null;
|
||||
guilds(): GGuild[];
|
||||
start(): Promise<void>;
|
||||
stop(): Promise<void>;
|
||||
/** 이 서버의 음성 상태를 따라간다 (명령 등록 포함) */
|
||||
watch(guildId: string, opts: { commands: boolean }): Promise<GGuild | null>;
|
||||
voiceChannelOf(guildId: string, userId: string): GChannel | null;
|
||||
channel(guildId: string, channelId: string): GChannel | null;
|
||||
channelMembers(guildId: string, channelId: string): GMember[];
|
||||
members(guildId: string): Promise<GMember[]>;
|
||||
isBot(userId: string): boolean;
|
||||
adapterCreator(guildId: string): DiscordGatewayAdapterCreator;
|
||||
}
|
||||
|
||||
const gm = (m: GuildMember): GMember => ({ id: m.id, name: m.displayName, avatar: m.displayAvatarURL({ size: 128 }), bot: m.user.bot });
|
||||
const gg = (g: Guild): GGuild => ({ id: g.id, name: g.name, icon: g.iconURL({ size: 128 }) });
|
||||
const isVoice = (c: { type: ChannelType } | null | undefined): c is VoiceBasedChannel => !!c && (c.type === ChannelType.GuildVoice || c.type === ChannelType.GuildStageVoice);
|
||||
|
||||
// ------------------------------------------------------------------ 다른 봇 (토큰으로 직접 연결)
|
||||
export class LocalGateway extends EventEmitter implements BotGateway {
|
||||
readonly kind = 'local';
|
||||
private client: Client | null = null;
|
||||
|
||||
constructor(private token: string) {
|
||||
super();
|
||||
}
|
||||
|
||||
async start(): Promise<void> {
|
||||
const c = new Client({ intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildVoiceStates, GatewayIntentBits.GuildMembers] });
|
||||
this.client = c;
|
||||
c.on(Events.ClientReady, () => this.emit('ready'));
|
||||
c.on(Events.GuildCreate, () => this.emit('guilds'));
|
||||
c.on(Events.GuildDelete, () => this.emit('guilds'));
|
||||
c.on(Events.Error, (e) => log.error('discord 오류', e));
|
||||
c.on(Events.VoiceStateUpdate, (o, n) => {
|
||||
const m = n.member ?? o.member;
|
||||
if (!m) return;
|
||||
const ch = n.channel;
|
||||
this.emit('voiceState', { guildId: n.guild.id, member: gm(m), oldChannelId: o.channelId, newChannelId: n.channelId, channel: ch ? { id: ch.id, name: ch.name } : null } satisfies GVoiceEvent);
|
||||
});
|
||||
c.on(Events.InteractionCreate, async (i) => {
|
||||
if (!i.isChatInputCommand() || !i.guildId) return;
|
||||
try {
|
||||
await i.deferReply({ flags: MessageFlags.Ephemeral });
|
||||
} catch (e) {
|
||||
log.error('명령 응답 실패', e);
|
||||
return;
|
||||
}
|
||||
const m = (i.member as GuildMember | null) ?? null;
|
||||
const vc = m?.voice?.channel ?? null;
|
||||
const cmd: GCommand = {
|
||||
name: i.commandName,
|
||||
guildId: i.guildId,
|
||||
user: m ? gm(m) : { id: i.user.id, name: i.user.username, avatar: null, bot: i.user.bot },
|
||||
voiceChannel: vc ? { id: vc.id, name: vc.name } : null,
|
||||
};
|
||||
this.emit('command', cmd, (content: string) => void i.editReply(content).catch((e) => log.error('명령 응답 실패', e)));
|
||||
});
|
||||
try {
|
||||
await c.login(this.token);
|
||||
} catch (e) {
|
||||
this.client = null;
|
||||
throw e;
|
||||
}
|
||||
}
|
||||
|
||||
async stop(): Promise<void> {
|
||||
const c = this.client;
|
||||
this.client = null;
|
||||
await c?.destroy();
|
||||
}
|
||||
|
||||
me(): GMember | null {
|
||||
const u = this.client?.isReady() ? this.client.user : null;
|
||||
return u ? { id: u.id, name: u.username, avatar: u.displayAvatarURL({ size: 128 }), bot: true } : null;
|
||||
}
|
||||
guilds(): GGuild[] {
|
||||
return this.client ? [...this.client.guilds.cache.values()].map(gg) : [];
|
||||
}
|
||||
private g(id: string): Guild | null {
|
||||
return this.client?.guilds.cache.get(id) ?? null;
|
||||
}
|
||||
async watch(guildId: string, opts: { commands: boolean }): Promise<GGuild | null> {
|
||||
const g = this.g(guildId);
|
||||
if (!g) return null;
|
||||
if (opts.commands) {
|
||||
try {
|
||||
await g.commands.set(COMMANDS);
|
||||
log.info('슬래시 명령 등록 완료');
|
||||
} catch (e) {
|
||||
log.warn('슬래시 명령 등록 실패', e);
|
||||
}
|
||||
}
|
||||
return gg(g);
|
||||
}
|
||||
voiceChannelOf(guildId: string, userId: string): GChannel | null {
|
||||
const ch = this.g(guildId)?.voiceStates.cache.get(userId)?.channel;
|
||||
return ch ? { id: ch.id, name: ch.name } : null;
|
||||
}
|
||||
channel(guildId: string, channelId: string): GChannel | null {
|
||||
const ch = this.g(guildId)?.channels.cache.get(channelId);
|
||||
return isVoice(ch) ? { id: ch.id, name: ch.name } : null;
|
||||
}
|
||||
channelMembers(guildId: string, channelId: string): GMember[] {
|
||||
const ch = this.g(guildId)?.channels.cache.get(channelId);
|
||||
return isVoice(ch) ? [...ch.members.values()].map(gm) : [];
|
||||
}
|
||||
async members(guildId: string): Promise<GMember[]> {
|
||||
const g = this.g(guildId);
|
||||
if (!g) return [];
|
||||
const ms = await g.members.fetch().catch(() => g.members.cache);
|
||||
return [...ms.values()].map(gm);
|
||||
}
|
||||
isBot(userId: string): boolean {
|
||||
return !!this.client?.users.cache.get(userId)?.bot;
|
||||
}
|
||||
adapterCreator(guildId: string): DiscordGatewayAdapterCreator {
|
||||
const g = this.g(guildId);
|
||||
if (!g) throw new Error('디스코드 서버를 찾지 못했습니다');
|
||||
return g.voiceAdapterCreator;
|
||||
}
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------------ 겜녹이 봇 (사이트 서버 중계)
|
||||
export interface RemoteGatewayOptions {
|
||||
serverUrl: () => string;
|
||||
appToken: () => string | null;
|
||||
version: string;
|
||||
}
|
||||
|
||||
export class RemoteGateway extends EventEmitter implements BotGateway {
|
||||
readonly kind = 'remote';
|
||||
private ws: WebSocket | null = null;
|
||||
private stopped = true;
|
||||
private retries = 0;
|
||||
private retryTimer: NodeJS.Timeout | null = null;
|
||||
private _me: GMember | null = null;
|
||||
private _guilds: GGuild[] = [];
|
||||
private watched: { id: string; commands: boolean } | null = null;
|
||||
private wait: { resolve: (g: GGuild | null) => void } | null = null;
|
||||
private channels = new Map<string, GChannel>();
|
||||
/** userId → 음성채널 */
|
||||
private voice = new Map<string, string>();
|
||||
private known = new Map<string, GMember>();
|
||||
private adapters = new Map<string, DiscordGatewayAdapterLibraryMethods>();
|
||||
private reqs = new Map<string, { resolve: (v: any) => void; reject: (e: Error) => void }>();
|
||||
private seq = 0;
|
||||
lastError: string | null = null;
|
||||
|
||||
constructor(private opts: RemoteGatewayOptions) {
|
||||
super();
|
||||
}
|
||||
|
||||
/** 서버에 붙어 ready 를 받을 때까지 기다린다 (실패해도 뒤에서 계속 다시 붙는다) */
|
||||
start(): Promise<void> {
|
||||
try {
|
||||
wsUrl(this.opts.serverUrl(), '/app/bot/ws');
|
||||
} catch (e) {
|
||||
return Promise.reject(e);
|
||||
}
|
||||
this.stopped = false;
|
||||
return new Promise((resolve, reject) => {
|
||||
const t = setTimeout(() => {
|
||||
cleanup();
|
||||
reject(new Error(this.lastError || '사이트 서버의 겜녹이 봇에 연결하지 못했습니다'));
|
||||
}, 20000);
|
||||
const ok = () => {
|
||||
cleanup();
|
||||
resolve();
|
||||
};
|
||||
const bad = () => {
|
||||
cleanup();
|
||||
reject(new Error(this.lastError || '다시 로그인해 주세요'));
|
||||
};
|
||||
const cleanup = () => {
|
||||
clearTimeout(t);
|
||||
this.off('ready', ok);
|
||||
this.off('unauthorized', bad);
|
||||
};
|
||||
this.once('ready', ok);
|
||||
this.once('unauthorized', bad);
|
||||
this.connect();
|
||||
});
|
||||
}
|
||||
|
||||
async stop(): Promise<void> {
|
||||
this.stopped = true;
|
||||
if (this.retryTimer) clearTimeout(this.retryTimer);
|
||||
this.retryTimer = null;
|
||||
const ws = this.ws;
|
||||
this.ws = null;
|
||||
this.reset();
|
||||
ws?.close(1000);
|
||||
}
|
||||
|
||||
private reset(): void {
|
||||
this._me = null;
|
||||
for (const a of this.adapters.values()) a.destroy();
|
||||
this.adapters.clear();
|
||||
for (const r of this.reqs.values()) r.reject(new Error('사이트 서버 연결이 끊겼습니다'));
|
||||
this.reqs.clear();
|
||||
this.wait?.resolve(null);
|
||||
this.wait = null;
|
||||
}
|
||||
|
||||
private connect(): void {
|
||||
if (this.stopped) return;
|
||||
const token = this.opts.appToken();
|
||||
if (!token) {
|
||||
this.lastError = '로그인이 필요합니다';
|
||||
this.emit('unauthorized');
|
||||
return;
|
||||
}
|
||||
let url: string;
|
||||
try {
|
||||
url = wsUrl(this.opts.serverUrl(), '/app/bot/ws');
|
||||
} catch (e: any) {
|
||||
// 암호화되지 않은 주소로는 로그인 토큰을 보내지 않는다 (다시 시도하지 않음: 주소를 고쳐야 한다)
|
||||
this.lastError = e.message;
|
||||
log.error(e.message);
|
||||
return;
|
||||
}
|
||||
const ws = new WebSocket(url, { headers: { authorization: `Bearer ${token}`, 'x-gvr-version': this.opts.version }, handshakeTimeout: 10000, maxPayload: 8 * 1024 * 1024, ...TLS_TRUST });
|
||||
this.ws = ws;
|
||||
let unauthorized = false;
|
||||
let alive = Date.now();
|
||||
const ping = setInterval(() => {
|
||||
// 서버가 30초마다 ping 을 보낸다. 75초 동안 아무것도 없으면 끊고 다시 붙는다
|
||||
if (Date.now() - alive > 75000) ws.terminate();
|
||||
}, 15000);
|
||||
ws.on('ping', () => (alive = Date.now()));
|
||||
ws.on('open', () => {
|
||||
this.retries = 0;
|
||||
alive = Date.now();
|
||||
log.info('사이트 서버 겜녹이 봇 중계 연결됨');
|
||||
});
|
||||
ws.on('message', (data) => {
|
||||
alive = Date.now();
|
||||
let m: BotGwToApp;
|
||||
try {
|
||||
m = JSON.parse(String(data));
|
||||
} catch {
|
||||
return;
|
||||
}
|
||||
this.onMessage(m);
|
||||
});
|
||||
ws.on('unexpected-response', (_req, res) => {
|
||||
unauthorized = res.statusCode === 401;
|
||||
this.lastError = unauthorized ? '로그인이 만료되었습니다. 다시 로그인해 주세요' : res.statusCode === 503 ? '사이트 서버에 겜녹이 봇이 켜져 있지 않습니다' : `사이트 서버 응답 ${res.statusCode}`;
|
||||
});
|
||||
ws.on('error', (e) => {
|
||||
this.lastError ||= `사이트 서버에 연결할 수 없습니다 (${e.message})`;
|
||||
});
|
||||
ws.on('close', (code) => {
|
||||
clearInterval(ping);
|
||||
if (this.ws !== ws) return;
|
||||
this.ws = null;
|
||||
const wasReady = !!this._me;
|
||||
this.reset();
|
||||
if (wasReady) this.emit('down');
|
||||
if (unauthorized || code === 4401) {
|
||||
this.lastError = '로그인이 만료되었거나 등록이 해제되었습니다';
|
||||
this.emit('unauthorized');
|
||||
}
|
||||
if (this.stopped) return;
|
||||
const delay = Math.min(30000, 1000 * 2 ** Math.min(this.retries++, 5));
|
||||
this.retryTimer = setTimeout(() => this.connect(), delay);
|
||||
});
|
||||
}
|
||||
|
||||
private send(m: BotGwFromApp): boolean {
|
||||
if (this.ws?.readyState !== WebSocket.OPEN) return false;
|
||||
this.ws.send(JSON.stringify(m));
|
||||
return true;
|
||||
}
|
||||
|
||||
private remember(m: GMember): void {
|
||||
this.known.set(m.id, m);
|
||||
}
|
||||
|
||||
private onMessage(m: BotGwToApp): void {
|
||||
switch (m.t) {
|
||||
case 'ready':
|
||||
this.lastError = null;
|
||||
this._me = m.me;
|
||||
this._guilds = m.guilds;
|
||||
this.emit('ready');
|
||||
return;
|
||||
case 'guilds':
|
||||
this._guilds = m.guilds;
|
||||
this.emit('guilds');
|
||||
return;
|
||||
case 'guild':
|
||||
if (this.watched?.id !== m.guild.id) return;
|
||||
this.channels.clear();
|
||||
this.voice.clear();
|
||||
for (const c of m.channels) this.channels.set(c.id, c);
|
||||
for (const v of m.voice) {
|
||||
this.remember(v.member);
|
||||
this.voice.set(v.member.id, v.channelId);
|
||||
}
|
||||
this.wait?.resolve(m.guild);
|
||||
this.wait = null;
|
||||
return;
|
||||
case 'watch_denied':
|
||||
// 이 유저가 가입하지 않은 서버
|
||||
if (this.watched?.id !== m.guildId) return;
|
||||
log.warn('이 디스코드 서버에 가입되어 있지 않아 녹음할 수 없습니다');
|
||||
this.wait?.resolve(null);
|
||||
this.wait = null;
|
||||
return;
|
||||
case 'voiceState':
|
||||
if (this.watched?.id !== m.guildId) return;
|
||||
this.remember(m.member);
|
||||
if (m.channel) this.channels.set(m.channel.id, m.channel);
|
||||
if (m.newChannelId) this.voice.set(m.member.id, m.newChannelId);
|
||||
else this.voice.delete(m.member.id);
|
||||
this.emit('voiceState', { guildId: m.guildId, member: m.member, oldChannelId: m.oldChannelId, newChannelId: m.newChannelId, channel: m.channel } satisfies GVoiceEvent);
|
||||
return;
|
||||
case 'cmd': {
|
||||
this.remember(m.user);
|
||||
const cmd: GCommand = { name: m.name, guildId: m.guildId, user: m.user, voiceChannel: m.voiceChannel };
|
||||
this.emit('command', cmd, (content: string) => void this.send({ t: 'cmd_res', id: m.id, content }));
|
||||
return;
|
||||
}
|
||||
case 'vserver':
|
||||
this.adapters.get(m.guildId)?.onVoiceServerUpdate(m.data);
|
||||
return;
|
||||
case 'vstate':
|
||||
this.adapters.get(m.guildId)?.onVoiceStateUpdate(m.data);
|
||||
return;
|
||||
case 'taken':
|
||||
this.emit('taken', m.guildId);
|
||||
return;
|
||||
case 'res': {
|
||||
const r = this.reqs.get(m.id);
|
||||
if (!r) return;
|
||||
this.reqs.delete(m.id);
|
||||
if (m.ok) r.resolve(m.data);
|
||||
else r.reject(new Error(m.error || '요청 실패'));
|
||||
return;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
me(): GMember | null {
|
||||
return this._me;
|
||||
}
|
||||
guilds(): GGuild[] {
|
||||
return this._me ? this._guilds : [];
|
||||
}
|
||||
watch(guildId: string, opts: { commands: boolean }): Promise<GGuild | null> {
|
||||
this.watched = { id: guildId, ...opts };
|
||||
this.wait?.resolve(null);
|
||||
return new Promise((resolve) => {
|
||||
if (!this.send({ t: 'watch', guildId, commands: opts.commands })) return resolve(null);
|
||||
const t = setTimeout(() => {
|
||||
if (this.wait?.resolve === done) this.wait = null;
|
||||
resolve(null);
|
||||
}, 10000);
|
||||
const done = (g: GGuild | null) => {
|
||||
clearTimeout(t);
|
||||
resolve(g);
|
||||
};
|
||||
this.wait = { resolve: done };
|
||||
});
|
||||
}
|
||||
voiceChannelOf(_guildId: string, userId: string): GChannel | null {
|
||||
const id = this.voice.get(userId);
|
||||
return id ? (this.channels.get(id) ?? { id, name: id }) : null;
|
||||
}
|
||||
channel(_guildId: string, channelId: string): GChannel | null {
|
||||
return this.channels.get(channelId) ?? null;
|
||||
}
|
||||
channelMembers(_guildId: string, channelId: string): GMember[] {
|
||||
const out: GMember[] = [];
|
||||
for (const [uid, ch] of this.voice) if (ch === channelId) out.push(this.known.get(uid) ?? { id: uid, name: uid, avatar: null, bot: false });
|
||||
return out;
|
||||
}
|
||||
members(guildId: string): Promise<GMember[]> {
|
||||
const id = String(++this.seq);
|
||||
return new Promise((resolve, reject) => {
|
||||
if (!this.send({ t: 'req', id, op: 'members', guildId })) return reject(new Error('사이트 서버에 연결되어 있지 않습니다'));
|
||||
const t = setTimeout(() => {
|
||||
if (this.reqs.delete(id)) reject(new Error('사이트 서버 응답 없음'));
|
||||
}, 20000);
|
||||
this.reqs.set(id, {
|
||||
resolve: (v) => {
|
||||
clearTimeout(t);
|
||||
for (const m of v as GMember[]) this.remember(m);
|
||||
resolve(v);
|
||||
},
|
||||
reject: (e) => {
|
||||
clearTimeout(t);
|
||||
reject(e);
|
||||
},
|
||||
});
|
||||
});
|
||||
}
|
||||
isBot(userId: string): boolean {
|
||||
return !!this.known.get(userId)?.bot;
|
||||
}
|
||||
adapterCreator(guildId: string): DiscordGatewayAdapterCreator {
|
||||
return (methods) => {
|
||||
this.adapters.set(guildId, methods);
|
||||
return {
|
||||
sendPayload: (payload) => this.send({ t: 'voice', guildId, payload }),
|
||||
destroy: () => {
|
||||
if (this.adapters.get(guildId) === methods) this.adapters.delete(guildId);
|
||||
},
|
||||
};
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -40,7 +40,7 @@ export function lolObjectIcon(key: string): string {
|
||||
|
||||
interface ValCatalog {
|
||||
at: number;
|
||||
agents: Record<string, { name: string; icon: string; abilities: Record<string, { name: string; icon: string | null }> }>;
|
||||
agents: Record<string, { name: string; icon: string; role?: string; abilities: Record<string, { name: string; icon: string | null }> }>;
|
||||
maps: Record<string, { uuid: string; name: string; image: string | null; xMultiplier: number; yMultiplier: number; xScalarToAdd: number; yScalarToAdd: number }>;
|
||||
weapons: Record<string, { name: string; icon: string | null }>;
|
||||
tiers: Record<number, string>;
|
||||
@@ -81,7 +81,9 @@ export class GameAssets {
|
||||
}
|
||||
|
||||
async refreshVal(force = false): Promise<void> {
|
||||
if (!force && this.val && Date.now() - this.val.at < DAY) return;
|
||||
// v1.3: 요원 역할을 저장하지 않던 예전 캐시는 바로 다시 받는다
|
||||
const hasRoles = this.val && Object.values(this.val.agents).some((a) => a.role);
|
||||
if (!force && this.val && hasRoles && Date.now() - this.val.at < DAY) return;
|
||||
const get = async (p: string) => (await request(`https://valorant-api.com/v1/${p}`, { timeoutMs: 20000 })).data?.data;
|
||||
const [agents, maps, weapons, tiers, modes, version] = await Promise.all([
|
||||
get('agents?language=ko-KR&isPlayableCharacter=true'),
|
||||
@@ -95,7 +97,7 @@ export class GameAssets {
|
||||
for (const a of agents || []) {
|
||||
const abilities: ValCatalog['agents'][string]['abilities'] = {};
|
||||
for (const ab of a.abilities || []) abilities[ab.slot] = { name: ab.displayName, icon: assetUrl(ab.displayIcon) };
|
||||
cat.agents[a.uuid.toLowerCase()] = { name: a.displayName, icon: assetUrl(a.displayIcon)!, abilities };
|
||||
cat.agents[a.uuid.toLowerCase()] = { name: a.displayName, icon: assetUrl(a.displayIcon)!, role: a.role?.displayName ?? undefined, abilities };
|
||||
}
|
||||
for (const m of maps || [])
|
||||
cat.maps[m.mapUrl] = {
|
||||
@@ -151,6 +153,10 @@ export class GameAssets {
|
||||
const a = id ? this.val?.agents[id.toLowerCase()] : undefined;
|
||||
return { id: id || '', name: a?.name ?? '?', icon: a?.icon ?? null };
|
||||
}
|
||||
/** 요원 역할 (타격대 · 척후대 · 전략가 · 감시자). 예전 캐시에는 없다 */
|
||||
agentRole(id: string | null | undefined): string | null {
|
||||
return (id && this.val?.agents[id.toLowerCase()]?.role) || null;
|
||||
}
|
||||
valMap(mapUrl: string | null | undefined) {
|
||||
return mapUrl ? this.val?.maps[mapUrl] : undefined;
|
||||
}
|
||||
|
||||
@@ -530,6 +530,20 @@ export function processLolHistory(game: any, timeline: any, host: Pick<AdapterHo
|
||||
const it = host.assets.item(x);
|
||||
return { id: x, name: it.name, icon: it.icon };
|
||||
}),
|
||||
stats: {
|
||||
role: lolPosition(p) ?? undefined,
|
||||
damage: st.totalDamageDealtToChampions,
|
||||
damageTaken: st.totalDamageTaken,
|
||||
vision: st.visionScore,
|
||||
wardsPlaced: st.wardsPlaced,
|
||||
wardsKilled: st.wardsKilled,
|
||||
controlWards: st.visionWardsBoughtInGame,
|
||||
objectiveDamage: st.damageDealtToObjectives,
|
||||
turretDamage: st.damageDealtToTurrets,
|
||||
ccSeconds: st.timeCCingOthers,
|
||||
at10: frameAt(timeline, p.participantId, 10),
|
||||
at15: frameAt(timeline, p.participantId, 15),
|
||||
},
|
||||
};
|
||||
});
|
||||
const events: EventRow[] = [];
|
||||
@@ -602,6 +616,25 @@ export function processLolHistory(game: any, timeline: any, host: Pick<AdapterHo
|
||||
};
|
||||
}
|
||||
|
||||
/** LCU 경기 기록의 라인 · 역할 → 포지션 (사용자 지정 게임은 틀릴 수 있어 "추정") */
|
||||
export function lolPosition(p: any): string | null {
|
||||
const lane = String(p.timeline?.lane || '').toUpperCase();
|
||||
const role = String(p.timeline?.role || '').toUpperCase();
|
||||
if (p.spell1Id === 11 || p.spell2Id === 11 || lane === 'JUNGLE') return '정글';
|
||||
if (lane === 'TOP') return '탑';
|
||||
if (lane === 'MIDDLE' || lane === 'MID') return '미드';
|
||||
if (lane === 'BOTTOM' || lane === 'BOT') return role === 'DUO_SUPPORT' || role === 'SUPPORT' ? '서폿' : role === 'DUO_CARRY' || role === 'CARRY' ? '원딜' : '바텀';
|
||||
return null;
|
||||
}
|
||||
|
||||
/** 타임라인의 N분 프레임에서 그 선수 CS · 골드 · 경험치 */
|
||||
function frameAt(timeline: any, pid: number, minute: number): { cs: number; gold: number; xp: number } | undefined {
|
||||
const f = (timeline?.frames || []).find((x: any) => Math.round((x.timestamp ?? 0) / 60000) === minute);
|
||||
const pf = f?.participantFrames?.[String(pid)] ?? f?.participantFrames?.[pid];
|
||||
if (!pf) return undefined;
|
||||
return { cs: (pf.minionsKilled ?? 0) + (pf.jungleMinionsKilled ?? 0), gold: pf.totalGold ?? 0, xp: pf.xp ?? 0 };
|
||||
}
|
||||
|
||||
function prettyUnit(name: string): string {
|
||||
if (/^Turret_/.test(name)) return '포탑';
|
||||
if (/Minion/.test(name)) return '미니언';
|
||||
|
||||
@@ -5,7 +5,7 @@ import https from 'node:https';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
|
||||
/** Riot 로컬 API 는 자체 서명 인증서라 검증을 끈 에이전트로만 부른다 (127.0.0.1 전용) */
|
||||
/** Riot 로컬 API 는 자체 서명 인증서라 검증을 끈 에이전트로만 부른다. 이 PC 안(127.0.0.1 · localhost) 주소에만 쓴다 */
|
||||
const localAgent = new https.Agent({ rejectUnauthorized: false, keepAlive: true });
|
||||
|
||||
export interface HttpResult<T = any> {
|
||||
@@ -19,6 +19,8 @@ export function request<T = any>(
|
||||
): Promise<HttpResult<T>> {
|
||||
return new Promise((resolve, reject) => {
|
||||
const u = new URL(url);
|
||||
// 인증서 검증을 끄는 건 이 PC 안 주소뿐이다. 바깥 주소(Riot 원격 API 등)는 항상 검증한다 (local 을 잘못 넘겨도)
|
||||
if (opts.local && !isLocal(u)) return reject(new Error(`로컬 API 가 아닌 주소입니다: ${u.host}`));
|
||||
const body = opts.body === undefined ? undefined : JSON.stringify(opts.body);
|
||||
const lib: any = u.protocol === 'http:' ? http : https;
|
||||
const req = lib.request(
|
||||
@@ -26,7 +28,7 @@ export function request<T = any>(
|
||||
{
|
||||
method: opts.method || 'GET',
|
||||
headers: { accept: 'application/json', ...(body ? { 'content-type': 'application/json' } : {}), ...opts.headers },
|
||||
agent: u.protocol === 'https:' && (opts.local ?? isLocal(u)) ? localAgent : undefined,
|
||||
agent: u.protocol === 'https:' && isLocal(u) ? localAgent : undefined,
|
||||
timeout: opts.timeoutMs ?? 5000,
|
||||
},
|
||||
(res: any) => {
|
||||
@@ -52,7 +54,7 @@ export function request<T = any>(
|
||||
}
|
||||
|
||||
function isLocal(u: URL): boolean {
|
||||
return u.hostname === '127.0.0.1' || u.hostname === 'localhost';
|
||||
return u.hostname === '127.0.0.1' || u.hostname === 'localhost' || u.hostname === '[::1]';
|
||||
}
|
||||
|
||||
export interface Lockfile {
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
import type { KillData, ChatData, RoundEndData, PlayerRef, MatchPlayer, MatchRound } from '@gvr/shared';
|
||||
import type { KillData, ChatData, RoundEndData, PlayerRef, MatchPlayer, MatchRound, PlayerStats } from '@gvr/shared';
|
||||
import type { EventRow, RoundRow } from '../db/db.js';
|
||||
import { logger } from '../util/log.js';
|
||||
import type { GameAssets } from './assets.js';
|
||||
@@ -380,6 +380,17 @@ export function processMatchDetails(md: any, selfPuuid: string, assets: GameAsse
|
||||
}
|
||||
combat[i] = prev !== null ? prev + avg : next !== null ? next : BUY_MS + i * avg;
|
||||
}
|
||||
// 범인찾기용 선수별 누적 지표
|
||||
const tallies: Record<string, Tally> = {};
|
||||
const tally = (puuid: string) => (tallies[puuid] ||= { damage: 0, taken: 0, head: 0, shots: 0, firstKills: 0, firstDeaths: 0, plants: 0, defuses: 0, kast: 0 });
|
||||
// 공격 팀: 전반 12라운드는 Red, 후반은 Blue, 연장은 매 라운드 바뀜. 스파이크를 설치한 팀이 공격이므로 설치 기록이 반대면 뒤집는다
|
||||
const ruleAttacker = (i: number) => (i < 12 ? 'Red' : i < 24 ? 'Blue' : i % 2 === 0 ? 'Red' : 'Blue');
|
||||
let agree = 0;
|
||||
for (let i = 0; i < n; i++) {
|
||||
const planter = rr[i].bombPlanter ? players[rr[i].bombPlanter]?.teamId : null;
|
||||
if (planter) agree += planter === ruleAttacker(i) ? 1 : -1;
|
||||
}
|
||||
const attackerTeam = (i: number) => (agree >= 0 ? ruleAttacker(i) : ruleAttacker(i) === 'Red' ? 'Blue' : 'Red');
|
||||
const rounds: RoundRow[] = [];
|
||||
const roundsDetail: MatchRound[] = [];
|
||||
const events: EventRow[] = [];
|
||||
@@ -394,15 +405,28 @@ export function processMatchDetails(md: any, selfPuuid: string, assets: GameAsse
|
||||
const win = r.winningTeam === selfTeam;
|
||||
if (win) ally++;
|
||||
else enemy++;
|
||||
const economy: Record<string, { spent: number; remaining: number; weapon?: string }> = {};
|
||||
const economy: Record<string, { spent: number; remaining: number; weapon?: string; loadout?: number }> = {};
|
||||
const roundPlayers: Record<string, { kills: number; damage: number }> = {};
|
||||
for (const ps of r.playerStats || []) {
|
||||
if (ps.economy)
|
||||
economy[ps.subject] = {
|
||||
spent: ps.economy.spent ?? 0,
|
||||
remaining: ps.economy.remaining ?? 0,
|
||||
weapon: ps.economy.weapon ? assets.damageItem(null, 'Weapon', ps.economy.weapon)?.name : undefined,
|
||||
loadout: typeof ps.economy.loadoutValue === 'number' ? ps.economy.loadoutValue : undefined,
|
||||
};
|
||||
const dmg = (ps.damage || []).reduce((n: number, d: any) => n + (d.damage ?? 0), 0);
|
||||
roundPlayers[ps.subject] = { kills: (ps.kills || []).length, damage: dmg };
|
||||
const t = tally(ps.subject);
|
||||
t.damage += dmg;
|
||||
for (const d of ps.damage || []) {
|
||||
if (d.receiver) tally(d.receiver).taken += d.damage ?? 0;
|
||||
t.head += d.headshots ?? 0;
|
||||
t.shots += (d.headshots ?? 0) + (d.bodyshots ?? 0) + (d.legshots ?? 0);
|
||||
}
|
||||
}
|
||||
if (r.bombPlanter) tally(r.bombPlanter).plants++;
|
||||
if (r.bombDefuser) tally(r.bombDefuser).defuses++;
|
||||
rounds.push({
|
||||
match_id: id,
|
||||
num,
|
||||
@@ -415,10 +439,25 @@ export function processMatchDetails(md: any, selfPuuid: string, assets: GameAsse
|
||||
enemy_score: enemy,
|
||||
economy: JSON.stringify(economy),
|
||||
});
|
||||
roundsDetail.push({ num, startedAt: S + start + clockOffset, endedAt: S + end + clockOffset, win, result: roundResultKo(r.roundResult), score: { ally, enemy }, economy });
|
||||
roundsDetail.push({
|
||||
num,
|
||||
startedAt: S + start + clockOffset,
|
||||
endedAt: S + end + clockOffset,
|
||||
win,
|
||||
result: roundResultKo(r.roundResult),
|
||||
score: { ally, enemy },
|
||||
economy,
|
||||
allyAttack: attackerTeam(i) === selfTeam,
|
||||
players: roundPlayers,
|
||||
});
|
||||
// 킬
|
||||
const killsBy: Record<string, number> = {};
|
||||
const kills = (r.playerStats || []).flatMap((ps: any) => ps.kills || []).sort((x: any, y: any) => x.gameTime - y.gameTime);
|
||||
if (kills[0]) {
|
||||
if (kills[0].killer) tally(kills[0].killer).firstKills++;
|
||||
if (kills[0].victim) tally(kills[0].victim).firstDeaths++;
|
||||
}
|
||||
for (const puuid of kastRound(r, kills, players)) tally(puuid).kast++;
|
||||
for (const k of kills) {
|
||||
const killer = ref(k.killer);
|
||||
const victim = ref(k.victim)!;
|
||||
@@ -516,6 +555,7 @@ export function processMatchDetails(md: any, selfPuuid: string, assets: GameAsse
|
||||
assists: p.stats?.assists ?? 0,
|
||||
score: p.stats?.score ?? 0, // 총 전투 점수 (사이트가 라운드 수로 나눠 ACS 표시)
|
||||
rank: assets.val?.tiers[p.competitiveTier] ?? null,
|
||||
stats: playerStats(p, tallies[p.subject], assets),
|
||||
}));
|
||||
const selfTeamInfo = (md.teams || []).find((t: any) => t.teamId === selfTeam);
|
||||
const enemyTeamInfo = (md.teams || []).find((t: any) => t.teamId !== selfTeam);
|
||||
@@ -535,6 +575,50 @@ export function processMatchDetails(md: any, selfPuuid: string, assets: GameAsse
|
||||
};
|
||||
}
|
||||
|
||||
type Tally = { damage: number; taken: number; head: number; shots: number; firstKills: number; firstDeaths: number; plants: number; defuses: number; kast: number };
|
||||
|
||||
/** 트레이드로 치는 시간: 죽은 뒤 이 안에 팀원이 그 킬러를 잡으면 (vlr · tracker.gg 와 같은 5초) */
|
||||
const TRADE_MS = 5000;
|
||||
|
||||
/** 이 라운드에서 KAST(킬 · 어시 · 생존 · 트레이드 중 하나)를 한 선수 */
|
||||
export function kastRound(r: any, kills: any[], players: Record<string, any>): string[] {
|
||||
const out: string[] = [];
|
||||
for (const ps of r.playerStats || []) {
|
||||
const me = ps.subject;
|
||||
if (kills.some((k) => k.killer === me || (k.assistants || []).includes(me))) {
|
||||
out.push(me);
|
||||
continue;
|
||||
}
|
||||
const death = kills.find((k) => k.victim === me);
|
||||
if (!death) {
|
||||
out.push(me);
|
||||
continue;
|
||||
}
|
||||
const traded = kills.some(
|
||||
(k) => k.victim === death.killer && k.gameTime >= death.gameTime && k.gameTime - death.gameTime <= TRADE_MS && players[k.killer]?.teamId === players[me]?.teamId,
|
||||
);
|
||||
if (traded) out.push(me);
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
function playerStats(p: any, t: Tally | undefined, assets: GameAssets): PlayerStats {
|
||||
const ac = p.stats?.abilityCasts;
|
||||
return {
|
||||
role: assets.agentRole(p.characterId) ?? undefined,
|
||||
rounds: p.stats?.roundsPlayed ?? undefined,
|
||||
damage: t?.damage ?? 0,
|
||||
damageTaken: t?.taken ?? 0,
|
||||
kastRounds: t?.kast ?? 0,
|
||||
headshotPct: t && t.shots ? Math.round((t.head / t.shots) * 100) : undefined,
|
||||
firstKills: t?.firstKills ?? 0,
|
||||
firstDeaths: t?.firstDeaths ?? 0,
|
||||
plants: t?.plants ?? 0,
|
||||
defuses: t?.defuses ?? 0,
|
||||
abilityCasts: ac ? (ac.grenadeCasts ?? 0) + (ac.ability1Casts ?? 0) + (ac.ability2Casts ?? 0) + (ac.ultimateCasts ?? 0) : undefined,
|
||||
};
|
||||
}
|
||||
|
||||
export function roundResultKo(r: string | undefined): string {
|
||||
switch (r) {
|
||||
case 'Eliminated':
|
||||
|
||||
@@ -2,9 +2,11 @@ import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import type { FastifyInstance } from 'fastify';
|
||||
import { buildApi } from './api/server.js';
|
||||
import { Culprit } from './culprit.js';
|
||||
import { Store } from './db/db.js';
|
||||
import { Dictionary } from './dict/dictionary.js';
|
||||
import { Bot } from './discord/bot.js';
|
||||
import { LocalGateway, RemoteGateway } from './discord/gateway.js';
|
||||
import { Recorder } from './discord/recorder.js';
|
||||
import { Announcer } from './discord/tts.js';
|
||||
import { GameAssets } from './games/assets.js';
|
||||
@@ -17,6 +19,7 @@ import { WorkerClient, type WorkerCommand } from './stt/worker.js';
|
||||
import { Timeline } from './timeline.js';
|
||||
import { Bus } from './util/events.js';
|
||||
import { initLogFile, logger } from './util/log.js';
|
||||
import { hardenTlsEnv } from './util/secure-http.js';
|
||||
|
||||
const log = logger('core');
|
||||
|
||||
@@ -26,16 +29,21 @@ export interface CoreOptions {
|
||||
worker: WorkerCommand;
|
||||
version: string;
|
||||
codec?: SecretCodec;
|
||||
/** 이미 연 설정 저장소 (Electron 은 로그인 확인 때문에 코어보다 먼저 연다) */
|
||||
settings?: SettingsStore;
|
||||
/** 로컬 API 를 127.0.0.1 포트로도 연다 (설정 창·디버그용). 0 이면 열지 않음 */
|
||||
apiPort?: number;
|
||||
/** 겜녹이 봇 중계에서 로그인 만료 · 등록 해제를 알려 왔을 때 (Electron: 바로 다시 확인해서 잠근다) */
|
||||
onBotUnauthorized?: () => void;
|
||||
}
|
||||
|
||||
export type Core = Awaited<ReturnType<typeof startCore>>;
|
||||
|
||||
/** 코어 조립 (Electron 메인 프로세스와 헤드리스 CLI 가 같이 쓴다) */
|
||||
export async function startCore(opts: CoreOptions) {
|
||||
hardenTlsEnv(); // 헤드리스 CLI 도 (Electron 은 main.ts 에서 먼저)
|
||||
fs.mkdirSync(opts.dataDir, { recursive: true });
|
||||
const settings = new SettingsStore(opts.dataDir, opts.codec);
|
||||
const settings = opts.settings ?? new SettingsStore(opts.dataDir, opts.codec);
|
||||
const S = () => settings.get();
|
||||
const paths = () => resolvePaths(opts.dataDir, S());
|
||||
initLogFile(paths().logs);
|
||||
@@ -63,7 +71,7 @@ export async function startCore(opts: CoreOptions) {
|
||||
const u = store.getUser(uid);
|
||||
if (u?.excluded) return true;
|
||||
// 다른 봇(음악봇 등)은 녹음하지 않는다. 자동 테스트에서만 GVR_RECORD_BOTS=1 로 연다.
|
||||
return process.env.GVR_RECORD_BOTS !== '1' && !!bot.client?.users.cache.get(uid)?.bot;
|
||||
return process.env.GVR_RECORD_BOTS !== '1' && bot.isBot(uid);
|
||||
},
|
||||
matchAt: (ts) => games.liveMatchAt(ts),
|
||||
});
|
||||
@@ -72,11 +80,13 @@ export async function startCore(opts: CoreOptions) {
|
||||
if (!S().discord.guildId) settings.update({ discord: { guildId: gid } });
|
||||
});
|
||||
|
||||
const culprit = new Culprit(store, timeline, games);
|
||||
const api: FastifyInstance = await buildApi({
|
||||
store,
|
||||
timeline,
|
||||
games,
|
||||
dict,
|
||||
culprit,
|
||||
bus,
|
||||
settings: S,
|
||||
trainingDir: () => paths().training,
|
||||
@@ -110,16 +120,27 @@ export async function startCore(opts: CoreOptions) {
|
||||
relay.start();
|
||||
if (opts.apiPort) await api.listen({ host: '127.0.0.1', port: opts.apiPort });
|
||||
|
||||
// 겜녹이 봇: 봇 토큰은 사이트 서버에만 있다. 앱 로그인 토큰으로 서버 중계에 붙는다.
|
||||
// 다른 봇: 사용자가 넣은 토큰으로 이 PC 가 직접 연결 (개발용 GVR_BOT_TOKEN 도 여기)
|
||||
const startBot = async () => {
|
||||
const token = settings.getSecret('botToken');
|
||||
if (!token) {
|
||||
const token = settings.activeBotToken();
|
||||
let gw;
|
||||
if (token) gw = new LocalGateway(token);
|
||||
else if (S().discord.botMode === 'builtin') {
|
||||
if (!settings.getSecret('appToken')) {
|
||||
log.warn('로그인하지 않아 겜녹이 봇에 연결하지 않습니다');
|
||||
return;
|
||||
}
|
||||
gw = new RemoteGateway({ serverUrl: () => S().site.serverUrl, appToken: () => settings.getSecret('appToken') ?? null, version: opts.version });
|
||||
gw.on('unauthorized', () => opts.onBotUnauthorized?.());
|
||||
} else {
|
||||
log.warn('봇 토큰이 없습니다. 설정에서 입력해 주세요.');
|
||||
return;
|
||||
}
|
||||
try {
|
||||
await bot.start(token);
|
||||
await bot.start(gw);
|
||||
} catch (e: any) {
|
||||
log.error(`봇 로그인 실패: ${e.message}`);
|
||||
log.error(`봇 연결 실패: ${e.message}`);
|
||||
}
|
||||
};
|
||||
await startBot();
|
||||
|
||||
@@ -3,6 +3,8 @@ import WebSocket from 'ws';
|
||||
import type { LiveEvent, RelayFromDevice, RelayToDevice } from '@gvr/shared';
|
||||
import type { Bus } from '../util/events.js';
|
||||
import { logger } from '../util/log.js';
|
||||
import { secureFetch, TLS_TRUST } from '../util/secure-http.js';
|
||||
import { secureServerUrl, wsUrl } from '../util/secure-url.js';
|
||||
|
||||
const log = logger('relay');
|
||||
|
||||
@@ -60,9 +62,16 @@ export class RelayClient {
|
||||
this.status = { state: 'off', error: '사이트 서버에 등록되지 않았습니다', since: null, serverUrl: c.serverUrl };
|
||||
return;
|
||||
}
|
||||
const url = c.serverUrl.replace(/^http/, 'ws').replace(/\/$/, '') + '/device/ws';
|
||||
let url: string;
|
||||
try {
|
||||
url = wsUrl(c.serverUrl, '/device/ws');
|
||||
} catch (e: any) {
|
||||
// 암호화되지 않은 주소로는 기기 키 · 기록을 보내지 않는다
|
||||
this.status = { state: 'error', error: e.message, since: null, serverUrl: c.serverUrl };
|
||||
return;
|
||||
}
|
||||
this.status = { ...this.status, state: 'connecting', serverUrl: c.serverUrl };
|
||||
const ws = new WebSocket(url, { headers: { authorization: `Device ${c.deviceId}.${c.deviceKey}` }, handshakeTimeout: 10000, maxPayload: 8 * 1024 * 1024 });
|
||||
const ws = new WebSocket(url, { headers: { authorization: `Device ${c.deviceId}.${c.deviceKey}` }, handshakeTimeout: 10000, maxPayload: 8 * 1024 * 1024, ...TLS_TRUST });
|
||||
this.ws = ws;
|
||||
ws.on('open', () => {
|
||||
this.retries = 0;
|
||||
@@ -122,7 +131,7 @@ export class RelayClient {
|
||||
}
|
||||
try {
|
||||
const headers: Record<string, string> = {};
|
||||
for (const k of ['range', 'content-type', 'accept']) if (req.headers[k]) headers[k] = req.headers[k];
|
||||
for (const k of ['range', 'content-type', 'accept', 'x-gvr-internal']) if (req.headers[k]) headers[k] = req.headers[k];
|
||||
if (req.user) headers['x-gvr-user'] = encodeURIComponent(JSON.stringify(req.user));
|
||||
const res = await this.api.inject({ method: req.method as any, url: req.path, headers, payload: req.body ?? undefined });
|
||||
const outHeaders: Record<string, string> = {};
|
||||
@@ -149,12 +158,17 @@ export class RelayClient {
|
||||
|
||||
/** 1회용 등록 코드로 이 PC 를 사이트 서버에 등록한다 */
|
||||
export async function registerDevice(serverUrl: string, code: string, name: string): Promise<{ deviceId: string; deviceKey: string }> {
|
||||
const r = await fetch(serverUrl.replace(/\/$/, '') + '/device/register', {
|
||||
const r = await secureFetch(secureServerUrl(serverUrl) + '/device/register', {
|
||||
method: 'POST',
|
||||
headers: { 'content-type': 'application/json' },
|
||||
body: JSON.stringify({ code: code.trim(), name }),
|
||||
});
|
||||
const data: any = await r.json().catch(() => ({}));
|
||||
let data: any = {};
|
||||
try {
|
||||
data = JSON.parse(await r.text());
|
||||
} catch {
|
||||
/* JSON 아님 */
|
||||
}
|
||||
if (!r.ok) throw new Error(data.message || (r.status === 400 || r.status === 404 ? '등록 코드가 올바르지 않거나 만료되었습니다' : `서버 오류 ${r.status}`));
|
||||
return { deviceId: data.deviceId, deviceKey: data.deviceKey };
|
||||
}
|
||||
|
||||
43
app/src/core/roles.ts
Normal file
@@ -0,0 +1,43 @@
|
||||
// 역할별 권한: 일반 유저(user)가 바꿀 수 없는 관리자 전용 설정 · 기능.
|
||||
// 메인 프로세스(IPC)에서 막고, 설정 창은 같은 목록으로 잠금 표시만 한다.
|
||||
import type { AppRole } from '@gvr/shared';
|
||||
|
||||
export const isAdminRole = (r: AppRole | null | undefined): boolean => r === 'admin' || r === 'superadmin';
|
||||
|
||||
export const ROLE_LABEL: Record<AppRole, string> = { superadmin: '최고 관리자', admin: '관리자', user: '유저' };
|
||||
|
||||
/**
|
||||
* 관리자 전용 설정 (settings.json 경로 앞부분)
|
||||
* - 봇 선택: 다른 봇으로 바꾸기
|
||||
* - 녹음 안내(TTS): 녹음되는 사람들에게 알리는 장치라 끄거나 문구를 바꾸는 것은 관리자만
|
||||
* - 음성 보관 기간: 다른 사람 목소리를 얼마나 남길지 정하는 정책
|
||||
* - 사이트 서버: 주소 · PC 이름 · 등록 (모두가 보는 사이트에 연결되는 PC)
|
||||
* - 파인튜닝 일정 · 모델 교체
|
||||
*/
|
||||
export const ADMIN_ONLY_SETTINGS = ['discord.botMode', 'discord.ttsEnabled', 'discord.ttsOnNewMember', 'discord.ttsText', 'storage.retentionDays', 'site', 'finetune'] as const;
|
||||
|
||||
/** 관리자 전용 기능 (IPC 이름) */
|
||||
export const ADMIN_ONLY_ACTIONS = new Set([
|
||||
'registerDevice',
|
||||
'unregisterDevice',
|
||||
'setExcluded',
|
||||
'finetuneInstall',
|
||||
'finetuneStart',
|
||||
'finetuneStop',
|
||||
'finetuneRollback',
|
||||
'clearTrainingData',
|
||||
]);
|
||||
|
||||
/** 설정 변경(patch) 중 관리자 전용 항목의 경로 목록. 비어 있으면 누구나 바꿀 수 있는 변경 */
|
||||
export function adminOnlyPaths(patch: unknown, prefix = ''): string[] {
|
||||
if (!patch || typeof patch !== 'object' || Array.isArray(patch)) return [];
|
||||
const out: string[] = [];
|
||||
for (const [k, v] of Object.entries(patch)) {
|
||||
const p = prefix ? `${prefix}.${k}` : k;
|
||||
if (ADMIN_ONLY_SETTINGS.some((a) => p === a || p.startsWith(`${a}.`))) out.push(p);
|
||||
else if (ADMIN_ONLY_SETTINGS.some((a) => a.startsWith(`${p}.`))) out.push(...adminOnlyPaths(v, p));
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
export const ADMIN_ONLY_MESSAGE = '관리자만 바꿀 수 있는 설정입니다';
|
||||
@@ -1,10 +1,13 @@
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import type { AppRole, AppUserInfo } from '@gvr/shared';
|
||||
|
||||
export interface Settings {
|
||||
version: 1;
|
||||
firstRunDone: boolean;
|
||||
discord: {
|
||||
/** builtin = 앱에 들어 있는 겜녹이 봇, custom = 사용자가 넣은 다른 봇 토큰 */
|
||||
botMode: 'builtin' | 'custom';
|
||||
guildId: string | null;
|
||||
/** 따라갈 유저 (보통 게임 PC 주인) */
|
||||
followUserId: string | null;
|
||||
@@ -66,16 +69,25 @@ export interface Secrets {
|
||||
botToken?: string;
|
||||
deviceKey?: string;
|
||||
riotApiKey?: string;
|
||||
/** 앱 로그인 토큰 (사이트 서버가 발급) */
|
||||
appToken?: string;
|
||||
/** v1.2.0 이 받아 두던 겜녹이 봇 토큰. 이제 쓰지 않고 시작할 때 지운다 */
|
||||
builtinBotToken?: string;
|
||||
/** 마지막으로 서버에서 확인한 로그인 정보 (서버에 잠깐 못 붙을 때 쓰는 사본) */
|
||||
auth?: { user: AppUserInfo; role: AppRole; verifiedAt: number };
|
||||
}
|
||||
|
||||
export const DEFAULT_TTS_TEXT =
|
||||
'겜녹이가 이 음성채널을 녹음합니다. 녹음을 원하지 않으시면 녹음제외 명령을 입력해 주세요.';
|
||||
'겜녹이가 이 음성채널을 녹음합니다. 녹음된 대화는 AI 경기 분석에 쓰일 수 있어요. 녹음을 원하지 않으시면 녹음제외 명령을 입력해 주세요.';
|
||||
/** v1.2.2 까지의 기본 문구. 이 문구를 그대로 쓰던 설치는 새 기본 문구(AI 분석 안내 포함)로 바꾼다 */
|
||||
const OLD_DEFAULT_TTS_TEXTS = ['겜녹이가 이 음성채널을 녹음합니다. 녹음을 원하지 않으시면 녹음제외 명령을 입력해 주세요.'];
|
||||
|
||||
export function defaultSettings(): Settings {
|
||||
return {
|
||||
version: 1,
|
||||
firstRunDone: false,
|
||||
discord: {
|
||||
botMode: 'builtin',
|
||||
guildId: null,
|
||||
followUserId: null,
|
||||
followEnabled: true,
|
||||
@@ -144,6 +156,8 @@ export class SettingsStore {
|
||||
private secrets: Secrets;
|
||||
private listeners = new Set<(s: Settings) => void>();
|
||||
|
||||
private envBotToken: string | null;
|
||||
|
||||
constructor(
|
||||
private dataDir: string,
|
||||
private codec: SecretCodec = plainCodec,
|
||||
@@ -151,8 +165,10 @@ export class SettingsStore {
|
||||
this.file = path.join(dataDir, 'settings.json');
|
||||
this.secretFile = path.join(dataDir, 'secrets.bin');
|
||||
this.cur = defaultSettings();
|
||||
let saved: any = null;
|
||||
try {
|
||||
this.cur = deepMerge(defaultSettings(), JSON.parse(fs.readFileSync(this.file, 'utf8')));
|
||||
saved = JSON.parse(fs.readFileSync(this.file, 'utf8'));
|
||||
this.cur = deepMerge(defaultSettings(), saved);
|
||||
} catch {
|
||||
/* 첫 실행 */
|
||||
}
|
||||
@@ -162,8 +178,24 @@ export class SettingsStore {
|
||||
} catch {
|
||||
/* 없음 */
|
||||
}
|
||||
// 개발/헤드리스: 환경변수로 비밀값 주입
|
||||
if (process.env.GVR_BOT_TOKEN) this.secrets.botToken = process.env.GVR_BOT_TOKEN;
|
||||
// v1.0.0 에서 직접 토큰을 넣어 쓰던 설치는 그 봇을 계속 쓴다
|
||||
if (saved && !saved.discord?.botMode && this.secrets.botToken) this.cur.discord.botMode = 'custom';
|
||||
// 범인찾기(AI 분석) 안내: 기본 문구를 바꾸지 않고 쓰던 설치는 새 기본 문구로 (직접 고친 문구는 그대로)
|
||||
if (OLD_DEFAULT_TTS_TEXTS.includes(this.cur.discord.ttsText)) this.cur.discord.ttsText = DEFAULT_TTS_TEXT;
|
||||
// 개발/헤드리스: 환경변수 토큰이 있으면 모드와 상관없이 그것을 쓴다
|
||||
this.envBotToken = process.env.GVR_BOT_TOKEN || null;
|
||||
// v1.2.0 은 서버에서 받은 겜녹이 봇 토큰을 저장해 두었다. 이제는 서버가 봇을 대신 연결하므로 남기지 않는다
|
||||
if (this.secrets.builtinBotToken) this.setSecret('builtinBotToken', null);
|
||||
}
|
||||
|
||||
/** 겜녹이 봇을 쓸 수 있는지 (로그인해 있으면 사이트 서버 중계로 연결한다. 봇 토큰은 이 PC 에 오지 않는다) */
|
||||
get hasBuiltinBot(): boolean {
|
||||
return !!this.secrets.appToken;
|
||||
}
|
||||
/** 이 PC 가 직접 로그인할 봇 토큰: 다른 봇 모드의 토큰 또는 개발용 GVR_BOT_TOKEN (겜녹이 봇은 null) */
|
||||
activeBotToken(): string | null {
|
||||
if (this.envBotToken) return this.envBotToken;
|
||||
return this.cur.discord.botMode === 'custom' ? this.secrets.botToken || null : null;
|
||||
}
|
||||
|
||||
get(): Settings {
|
||||
|
||||
@@ -10,6 +10,7 @@ const listeners = new Set<(line: string) => void>();
|
||||
export function initLogFile(dir: string): void {
|
||||
fs.mkdirSync(dir, { recursive: true });
|
||||
const day = new Date().toISOString().slice(0, 10);
|
||||
stream?.end(); // 로그아웃 후 다시 로그인하면 코어를 다시 띄운다
|
||||
stream = fs.createWriteStream(path.join(dir, `gvr-${day}.log`), { flags: 'a' });
|
||||
}
|
||||
export function setLogLevel(l: Level): void {
|
||||
|
||||
45
app/src/core/util/secure-http.ts
Normal file
@@ -0,0 +1,45 @@
|
||||
// 사이트 서버와의 https/wss 통신에 쓰는 인증서 신뢰 설정.
|
||||
// Node 에 들어 있는 Mozilla 루트 인증서만 믿고, 검증은 항상 켠다. 그래서 아래 방법으로는 통신을 엿볼 수 없다
|
||||
// - NODE_TLS_REJECT_UNAUTHORIZED=0 (검증 끄기), NODE_EXTRA_CA_CERTS · NODE_USE_SYSTEM_CA (가짜 루트 인증서 끼우기)
|
||||
// - Windows 인증서 저장소에 가짜 루트 인증서 설치 (프록시 · 감시 프로그램)
|
||||
import https from 'node:https';
|
||||
import tls from 'node:tls';
|
||||
|
||||
export const TLS_TRUST: { ca: string[]; rejectUnauthorized: true } = { ca: [...tls.rootCertificates], rejectUnauthorized: true };
|
||||
const agent = new https.Agent({ ...TLS_TRUST, keepAlive: true });
|
||||
|
||||
export interface SecureResponse {
|
||||
status: number;
|
||||
ok: boolean;
|
||||
text(): Promise<string>;
|
||||
}
|
||||
|
||||
/** fetch 와 비슷한 작은 요청 함수. https 는 위 신뢰 설정으로, http 는 이 PC 안 주소(개발 · 테스트, secureServerUrl 이 거른다)만 */
|
||||
export function secureFetch(url: string, init: { method?: string; headers?: Record<string, string>; body?: string; timeoutMs?: number } = {}): Promise<SecureResponse> {
|
||||
const u = new URL(url);
|
||||
if (u.protocol === 'http:') {
|
||||
return fetch(url, { method: init.method, headers: init.headers, body: init.body, signal: AbortSignal.timeout(init.timeoutMs ?? 15000) });
|
||||
}
|
||||
if (u.protocol !== 'https:') return Promise.reject(new Error(`지원하지 않는 주소: ${u.protocol}`));
|
||||
return new Promise((resolve, reject) => {
|
||||
const req = https.request(u, { method: init.method || 'GET', headers: init.headers, agent, ...TLS_TRUST, timeout: init.timeoutMs ?? 15000 }, (res) => {
|
||||
const chunks: Buffer[] = [];
|
||||
res.on('data', (c: Buffer) => chunks.push(c));
|
||||
res.on('error', reject);
|
||||
res.on('end', () => {
|
||||
const status = res.statusCode || 0;
|
||||
const body = Buffer.concat(chunks).toString('utf8');
|
||||
resolve({ status, ok: status >= 200 && status < 300, text: async () => body });
|
||||
});
|
||||
});
|
||||
req.on('timeout', () => req.destroy(new Error('timeout')));
|
||||
req.on('error', reject);
|
||||
if (init.body) req.write(init.body);
|
||||
req.end();
|
||||
});
|
||||
}
|
||||
|
||||
/** 검증을 끄는 환경변수는 시작할 때 지운다 (사이트 밖 통신: 다른 봇 모드의 디스코드 연결 · Riot 원격 API 등도 검증하게) */
|
||||
export function hardenTlsEnv(): void {
|
||||
delete process.env.NODE_TLS_REJECT_UNAUTHORIZED;
|
||||
}
|
||||
22
app/src/core/util/secure-url.ts
Normal file
@@ -0,0 +1,22 @@
|
||||
// 사이트 서버 주소 검사. 로그인 토큰 · 기기 키 · 기록이 오가므로 암호화(https/wss)되지 않은 주소로는 보내지 않는다.
|
||||
// 이 PC 안(127.0.0.1 · localhost)만 http 를 허용한다 (개발 · 테스트용)
|
||||
const LOOPBACK = new Set(['127.0.0.1', 'localhost', '[::1]']);
|
||||
|
||||
export class InsecureServerUrlError extends Error {}
|
||||
|
||||
/** 안전한 주소면 끝의 / 를 뗀 주소를, 아니면 오류를 던진다 */
|
||||
export function secureServerUrl(raw: string): string {
|
||||
let u: URL;
|
||||
try {
|
||||
u = new URL(String(raw).trim());
|
||||
} catch {
|
||||
throw new InsecureServerUrlError('사이트 서버 주소가 올바르지 않습니다');
|
||||
}
|
||||
if (u.username || u.password) throw new InsecureServerUrlError('사이트 서버 주소에 아이디 · 비밀번호를 넣을 수 없습니다');
|
||||
const ok = u.protocol === 'https:' || (u.protocol === 'http:' && LOOPBACK.has(u.hostname));
|
||||
if (!ok) throw new InsecureServerUrlError('사이트 서버 주소는 https:// 로 시작해야 합니다 (암호화되지 않은 주소로는 로그인 정보와 기록을 보내지 않습니다)');
|
||||
return u.origin + u.pathname.replace(/\/+$/, '');
|
||||
}
|
||||
|
||||
/** http(s) 주소를 같은 보안 수준의 WebSocket 주소로 (https → wss, http → ws) */
|
||||
export const wsUrl = (base: string, path: string) => secureServerUrl(base).replace(/^http/, 'ws') + path;
|
||||
@@ -1,5 +1,6 @@
|
||||
// 설정 창(렌더러) ↔ Electron 메인 프로세스 IPC 계약. preload 가 window.gvr 로 노출한다.
|
||||
import type { User } from '@gvr/shared';
|
||||
import type { AppRole, AppUserInfo, AppUserRow, User } from '@gvr/shared';
|
||||
import type { AuthState } from '../core/auth.js';
|
||||
import type { DiagItem } from '../core/diagnostics.js';
|
||||
import type { BotState } from '../core/discord/bot.js';
|
||||
import type { RelayStatus } from '../core/relay/client.js';
|
||||
@@ -40,11 +41,24 @@ export interface FinetuneStatus {
|
||||
log: string[];
|
||||
}
|
||||
|
||||
/** 로그인 화면용 상태. appReady = 로그인 후 코어(봇 · 녹음)가 다 떴는지 */
|
||||
export interface AuthView extends AuthState {
|
||||
appReady: boolean;
|
||||
/** 로그인 후 코어 시작 실패 */
|
||||
appError: string | null;
|
||||
version: string;
|
||||
serverUrl: string;
|
||||
}
|
||||
|
||||
export interface AppState {
|
||||
/** 로그인한 계정 · 역할 (user 는 관리자 전용 설정을 못 바꾼다) */
|
||||
account: { user: AppUserInfo | null; role: AppRole | null; offline: boolean };
|
||||
version: string;
|
||||
dataDir: string;
|
||||
portable: boolean;
|
||||
settings: Settings;
|
||||
/** 겜녹이 기본 봇 토큰을 서버에서 받아 두었는지 */
|
||||
builtinBot: boolean;
|
||||
secrets: { botToken: boolean; riotApiKey: boolean; deviceKey: boolean };
|
||||
secretCodec: string;
|
||||
bot: BotState;
|
||||
@@ -58,6 +72,16 @@ export interface AppState {
|
||||
}
|
||||
|
||||
export interface GvrApi {
|
||||
authState(): Promise<AuthView>;
|
||||
onAuth(cb: (s: AuthView) => void): () => void;
|
||||
authLogin(): Promise<AuthView>;
|
||||
authCancel(): Promise<void>;
|
||||
authLogout(): Promise<void>;
|
||||
authRecheck(): Promise<AuthView>;
|
||||
adminUsers(): Promise<{ users: AppUserRow[] }>;
|
||||
adminAddUser(id: string, role: 'admin' | 'user'): Promise<{ users: AppUserRow[] }>;
|
||||
adminSetRole(id: string, role: 'admin' | 'user'): Promise<{ users: AppUserRow[] }>;
|
||||
adminRemoveUser(id: string): Promise<{ users: AppUserRow[] }>;
|
||||
getState(): Promise<AppState>;
|
||||
onState(cb: (s: AppState) => void): () => void;
|
||||
updateSettings(patch: DeepPartial<Settings>): Promise<Settings>;
|
||||
|
||||
@@ -2,23 +2,28 @@ import { app, BrowserWindow, dialog, ipcMain, shell } from 'electron';
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import { toUser } from '../core/api/server.js';
|
||||
import type { AppAuth, AuthState } from '../core/auth.js';
|
||||
import { runDiagnostics } from '../core/diagnostics.js';
|
||||
import { synthesize } from '../core/discord/tts.js';
|
||||
import type { Core } from '../core/index.js';
|
||||
import { registerDevice } from '../core/relay/client.js';
|
||||
import { dirSize } from '../core/retention.js';
|
||||
import type { AppState, DownloadProgress, GvrApi } from './api-types.js';
|
||||
import { secureServerUrl } from '../core/util/secure-url.js';
|
||||
import { ADMIN_ONLY_ACTIONS, ADMIN_ONLY_MESSAGE, adminOnlyPaths, isAdminRole } from '../core/roles.js';
|
||||
import type { AppState, AuthView, DownloadProgress, GvrApi } from './api-types.js';
|
||||
import type { Finetuner } from './finetune.js';
|
||||
|
||||
type Handlers = { [K in keyof GvrApi]?: (...args: any[]) => any };
|
||||
|
||||
export function buildState(core: Core, opts: { dataDir: string; portable: boolean }): AppState {
|
||||
export function buildState(core: Core, opts: { dataDir: string; portable: boolean; auth: AuthState }): AppState {
|
||||
const s = core.settings.get();
|
||||
return {
|
||||
account: { user: opts.auth.user, role: opts.auth.role, offline: opts.auth.offline },
|
||||
version: core.version,
|
||||
dataDir: opts.dataDir,
|
||||
portable: opts.portable,
|
||||
settings: s,
|
||||
builtinBot: core.settings.hasBuiltinBot,
|
||||
secrets: { botToken: core.settings.hasSecret('botToken'), riotApiKey: core.settings.hasSecret('riotApiKey'), deviceKey: core.settings.hasSecret('deviceKey') },
|
||||
secretCodec: core.settings.codecName,
|
||||
bot: core.bot.state,
|
||||
@@ -35,18 +40,66 @@ export function buildState(core: Core, opts: { dataDir: string; portable: boolea
|
||||
};
|
||||
}
|
||||
|
||||
/** 설정 창의 window.gvr 요청 처리 (api-types.ts GvrApi) */
|
||||
export function registerIpc(core: Core, ft: Finetuner, ctx: { dataDir: string; portable: boolean; win: () => BrowserWindow | null; finishWizard: () => void; quit: () => void }) {
|
||||
export interface IpcContext {
|
||||
dataDir: string;
|
||||
portable: boolean;
|
||||
win: () => BrowserWindow | null;
|
||||
finishWizard: () => void;
|
||||
quit: () => void;
|
||||
auth: AppAuth;
|
||||
/** 로그인해서 코어가 떠 있으면 코어 · 파인튜너 */
|
||||
current: () => { core: Core; ft: Finetuner } | null;
|
||||
authView: () => AuthView;
|
||||
/** 로그인 화면에서 다시 확인 (서버 연결 실패 후 재시도) */
|
||||
recheck: () => Promise<void>;
|
||||
}
|
||||
|
||||
/** 설정 창의 window.gvr 요청 처리 (api-types.ts GvrApi). 로그인 · 관리자 요청은 코어 없이도 받는다 */
|
||||
export function registerIpc(ctx: IpcContext) {
|
||||
const send = (ch: string, payload: unknown) => ctx.win()?.webContents.send(ch, payload);
|
||||
const progress = (p: DownloadProgress) => send('gvr:progress', p);
|
||||
const role = () => (ctx.auth.ok ? ctx.auth.state.role : null);
|
||||
|
||||
// 로그인해야 쓰는 요청은 지금 떠 있는 코어로 보낸다 (로그아웃 후 다시 로그인하면 코어가 새로 뜬다)
|
||||
const live = () => {
|
||||
const c = ctx.auth.ok ? ctx.current() : null;
|
||||
if (!c) throw new Error('로그인이 필요합니다');
|
||||
return c;
|
||||
};
|
||||
const core = new Proxy({} as Core, { get: (_t, k) => (live().core as any)[k] });
|
||||
const ft = new Proxy({} as Finetuner, {
|
||||
get: (_t, k) => {
|
||||
const f = live().ft as any;
|
||||
return typeof f[k] === 'function' ? f[k].bind(f) : f[k];
|
||||
},
|
||||
});
|
||||
|
||||
const h: Handlers = {
|
||||
getState: () => buildState(core, ctx),
|
||||
updateSettings: (patch) => core.settings.update(patch),
|
||||
setSecret: (key, value) => core.settings.setSecret(key, value),
|
||||
getState: () => buildState(core, { ...ctx, auth: ctx.auth.state }),
|
||||
updateSettings: (patch) => {
|
||||
if (!isAdminRole(role()) && adminOnlyPaths(patch).length) throw new Error(ADMIN_ONLY_MESSAGE);
|
||||
// 사이트 서버 주소는 https 만 (로그인 토큰 · 기기 키 · 기록이 오간다)
|
||||
if (patch?.site?.serverUrl !== undefined) patch = { ...patch, site: { ...patch.site, serverUrl: secureServerUrl(patch.site.serverUrl) } };
|
||||
return core.settings.update(patch);
|
||||
},
|
||||
setSecret: (key, value) => {
|
||||
if (key !== 'botToken' && key !== 'riotApiKey') throw new Error('바꿀 수 없는 값입니다');
|
||||
if (key === 'botToken' && !isAdminRole(role())) throw new Error(ADMIN_ONLY_MESSAGE);
|
||||
return core.settings.setSecret(key, value);
|
||||
},
|
||||
|
||||
testBotToken: async (token?: string) => {
|
||||
const t = token || core.settings.getSecret('botToken');
|
||||
const t = token || core.settings.activeBotToken();
|
||||
// 겜녹이 봇은 토큰이 이 PC 에 없다: 사이트 서버 중계로 붙어 보고 결과를 알려 준다
|
||||
if (!t && core.settings.get().discord.botMode === 'builtin') {
|
||||
const b = core.bot;
|
||||
if (b.state.status !== 'ready' || b.gateway?.kind !== 'remote') {
|
||||
await b.stop();
|
||||
await core.startBot();
|
||||
}
|
||||
if (b.state.status !== 'ready' || !b.state.user) return { ok: false, error: b.state.error ?? '사이트 서버의 겜녹이 봇에 연결하지 못했습니다' };
|
||||
return { ok: true, bot: b.state.user, guilds: b.state.guilds };
|
||||
}
|
||||
if (!t) return { ok: false, error: '봇 토큰을 입력해 주세요' };
|
||||
const get = (p: string) => fetch(`https://discord.com/api/v10${p}`, { headers: { authorization: `Bot ${t}` } });
|
||||
try {
|
||||
@@ -70,10 +123,8 @@ export function registerIpc(core: Core, ft: Finetuner, ctx: { dataDir: string; p
|
||||
return core.bot.state.status === 'ready' || core.bot.state.status === 'connecting' ? { ok: true } : { ok: false, error: core.bot.state.error ?? '봇을 시작하지 못했습니다' };
|
||||
},
|
||||
guildMembers: async () => {
|
||||
const g = core.bot.guild();
|
||||
if (!g) return [];
|
||||
const ms = await g.members.fetch().catch(() => g.members.cache);
|
||||
return [...ms.values()].map((m) => ({ id: m.id, name: m.displayName, avatar: m.displayAvatarURL({ size: 64 }), bot: m.user.bot })).sort((a, b) => a.name.localeCompare(b.name, 'ko'));
|
||||
const ms = await core.bot.members().catch(() => []);
|
||||
return ms.map((m) => ({ id: m.id, name: m.name, avatar: m.avatar, bot: m.bot })).sort((a, b) => a.name.localeCompare(b.name, 'ko'));
|
||||
},
|
||||
previewTts: async (text: string, voice: string) => {
|
||||
try {
|
||||
@@ -282,7 +333,26 @@ export function registerIpc(core: Core, ft: Finetuner, ctx: { dataDir: string; p
|
||||
quit: () => ctx.quit(),
|
||||
};
|
||||
|
||||
const authHandlers: Handlers = {
|
||||
authState: () => ctx.authView(),
|
||||
authLogin: () => ctx.auth.login().then(() => ctx.authView()),
|
||||
authCancel: () => ctx.auth.cancelLogin(),
|
||||
authLogout: () => ctx.auth.logout(),
|
||||
authRecheck: () => ctx.recheck().then(() => ctx.authView()),
|
||||
adminUsers: () => ctx.auth.adminUsers(),
|
||||
adminAddUser: (id: string, r: 'admin' | 'user') => ctx.auth.adminAddUser(id, r),
|
||||
adminSetRole: (id: string, r: 'admin' | 'user') => ctx.auth.adminSetRole(id, r),
|
||||
adminRemoveUser: (id: string) => ctx.auth.adminRemoveUser(id),
|
||||
openExternal: h.openExternal,
|
||||
quit: h.quit,
|
||||
};
|
||||
for (const [name, fn] of Object.entries(authHandlers)) ipcMain.handle(`gvr:${name}`, async (_e, ...args) => fn!(...args));
|
||||
for (const [name, fn] of Object.entries(h)) {
|
||||
ipcMain.handle(`gvr:${name}`, async (_e, ...args) => fn!(...args));
|
||||
if (name in authHandlers) continue;
|
||||
ipcMain.handle(`gvr:${name}`, async (_e, ...args) => {
|
||||
live();
|
||||
if (ADMIN_ONLY_ACTIONS.has(name) && !isAdminRole(role())) throw new Error('관리자만 쓸 수 있는 기능입니다');
|
||||
return fn!(...args);
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,14 +1,20 @@
|
||||
// 겜녹이 Electron 메인 프로세스: 트레이 아이콘 + 설정 창 + 첫 실행 마법사. 실제 일은 코어(src/core)가 한다.
|
||||
import { app, BrowserWindow, Menu, nativeImage, safeStorage, shell, Tray } from 'electron';
|
||||
import { app, BrowserWindow, Menu, nativeImage, safeStorage, session, shell, Tray } from 'electron';
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import { pathToFileURL } from 'node:url';
|
||||
import { AppAuth } from '../core/auth.js';
|
||||
import { startCore, type Core } from '../core/index.js';
|
||||
import { plainCodec, type SecretCodec } from '../core/settings.js';
|
||||
import { plainCodec, SettingsStore, type SecretCodec } from '../core/settings.js';
|
||||
import { logger } from '../core/util/log.js';
|
||||
import { hardenTlsEnv, secureFetch } from '../core/util/secure-http.js';
|
||||
import { Finetuner } from './finetune.js';
|
||||
import type { AuthView } from './api-types.js';
|
||||
import { buildState, registerIpc } from './ipc.js';
|
||||
import { brandDir, rendererDir, resolveDataDir, resourcesDir, workerCommand } from './paths.js';
|
||||
|
||||
// 인증서 검증을 끄는 환경변수(NODE_TLS_REJECT_UNAUTHORIZED=0)는 무시한다. fuses 로 막지 못하는 변수라 가장 먼저 지운다
|
||||
hardenTlsEnv();
|
||||
const log = logger('app');
|
||||
const argv = process.argv.slice(1);
|
||||
const flag = (name: string) => argv.includes(`--${name}`);
|
||||
@@ -23,11 +29,32 @@ if (!SMOKE && !app.requestSingleInstanceLock()) {
|
||||
|
||||
let core: Core | null = null;
|
||||
let ft: Finetuner | null = null;
|
||||
// 로그인: 설정 저장소와 로그인 확인은 코어보다 먼저 연다. 등록된 아이디로 로그인해야 코어(봇 · 녹음 · 사이트 연결)를 띄운다
|
||||
let settings: SettingsStore | null = null;
|
||||
let auth: AppAuth | null = null;
|
||||
let win: BrowserWindow | null = null;
|
||||
let tray: Tray | null = null;
|
||||
let quitting = false;
|
||||
const dataDir = resolveDataDir(opt('data-dir'));
|
||||
|
||||
// 창 보안: 설정 창(window.gvr 로 로그인 · 관리자 기능을 부를 수 있다)에는 앱에 들어 있는 화면만 띄운다.
|
||||
// 링크를 눌러 바깥 페이지가 이 창에 열리면 그 페이지가 window.gvr 를 쓸 수 있으므로, 바깥 주소는 브라우저로만 연다
|
||||
app.on('web-contents-created', (_e, wc) => {
|
||||
const own = pathToFileURL(path.join(rendererDir(), 'index.html')).href;
|
||||
const guard = (e: Electron.Event, url: string) => {
|
||||
if (url.split(/[?#]/)[0] === own) return;
|
||||
e.preventDefault();
|
||||
if (/^https?:\/\//.test(url)) void shell.openExternal(url);
|
||||
};
|
||||
wc.on('will-navigate', guard);
|
||||
wc.on('will-redirect', guard);
|
||||
wc.on('will-attach-webview', (e) => e.preventDefault());
|
||||
wc.setWindowOpenHandler(({ url }) => {
|
||||
if (/^https?:\/\//.test(url)) void shell.openExternal(url);
|
||||
return { action: 'deny' };
|
||||
});
|
||||
});
|
||||
|
||||
function dpapiCodec(): SecretCodec {
|
||||
// Windows: safeStorage = DPAPI (현재 사용자 계정에 묶인 암호화, N-03)
|
||||
if (safeStorage.isEncryptionAvailable()) return { name: process.platform === 'win32' ? 'dpapi' : 'os-keychain', encrypt: (s) => safeStorage.encryptString(s), decrypt: (b) => safeStorage.decryptString(b) };
|
||||
@@ -43,8 +70,9 @@ function trayImage(state: 'idle' | 'rec' | 'off'): Electron.NativeImage {
|
||||
}
|
||||
|
||||
function openWindow(route?: string): void {
|
||||
if (!core) return;
|
||||
const r = route ?? (core.settings.get().firstRunDone ? '/settings/discord' : '/wizard');
|
||||
if (!settings) return;
|
||||
const first = settings.get().firstRunDone;
|
||||
const r = route ?? (first ? '/settings/discord' : '/wizard');
|
||||
if (win && !win.isDestroyed()) {
|
||||
win.webContents.executeJavaScript(`location.hash = ${JSON.stringify('#' + r)}`).catch(() => undefined);
|
||||
win.show();
|
||||
@@ -56,7 +84,7 @@ function openWindow(route?: string): void {
|
||||
height: 760,
|
||||
minWidth: 960,
|
||||
minHeight: 640,
|
||||
title: core.settings.get().firstRunDone ? '겜녹이 · 설정' : '겜녹이 · 첫 실행 설정',
|
||||
title: first ? '겜녹이 · 설정' : '겜녹이 · 첫 실행 설정',
|
||||
icon: path.join(brandDir(), 'icon.png'),
|
||||
backgroundColor: '#0b141c',
|
||||
autoHideMenuBar: true,
|
||||
@@ -74,14 +102,15 @@ function openWindow(route?: string): void {
|
||||
win?.hide();
|
||||
}
|
||||
});
|
||||
win.webContents.setWindowOpenHandler(({ url }) => {
|
||||
if (/^https?:\/\//.test(url)) void shell.openExternal(url);
|
||||
return { action: 'deny' };
|
||||
});
|
||||
}
|
||||
|
||||
function updateTray(): void {
|
||||
if (!tray || !core) return;
|
||||
if (!tray) return;
|
||||
if (!core) {
|
||||
tray.setImage(trayImage('off'));
|
||||
tray.setToolTip(`겜녹이\n${auth?.state.status === 'not_registered' ? '등록되지 않은 아이디' : '로그인이 필요합니다'}`);
|
||||
return;
|
||||
}
|
||||
const st = core.bot.state;
|
||||
const rel = core.relay.status;
|
||||
const rec = st.recording.active;
|
||||
@@ -96,7 +125,17 @@ function updateTray(): void {
|
||||
}
|
||||
|
||||
function buildTrayMenu(): void {
|
||||
if (!tray || !core) return;
|
||||
if (!tray) return;
|
||||
if (!core) {
|
||||
tray.setContextMenu(
|
||||
Menu.buildFromTemplate([
|
||||
{ label: '겜녹이 로그인', click: () => openWindow() },
|
||||
{ type: 'separator' },
|
||||
{ label: '종료', click: () => void quit() },
|
||||
]),
|
||||
);
|
||||
return;
|
||||
}
|
||||
const c = core;
|
||||
tray.setContextMenu(
|
||||
Menu.buildFromTemplate([
|
||||
@@ -116,8 +155,8 @@ async function quit(): Promise<void> {
|
||||
if (quitting) return;
|
||||
quitting = true;
|
||||
try {
|
||||
ft?.dispose();
|
||||
await core?.stop();
|
||||
auth?.cancelLogin();
|
||||
await stopApp();
|
||||
} catch (e) {
|
||||
log.error('종료 중 오류', e);
|
||||
}
|
||||
@@ -130,8 +169,14 @@ async function smoke(): Promise<void> {
|
||||
const out: Record<string, unknown> = { version: app.getVersion(), dataDir, resources: resourcesDir() };
|
||||
let code = 1;
|
||||
try {
|
||||
const c = await startCore({ dataDir, resourcesDir: resourcesDir(), worker: workerCommand(), version: app.getVersion(), codec: dpapiCodec() });
|
||||
const st = new SettingsStore(dataDir, dpapiCodec());
|
||||
// 로그인: 토큰이 없는 새 설치는 로그인 화면(signed_out)이어야 한다. exe 에는 겜녹이 봇 토큰이 없어야 한다
|
||||
const a = await new AppAuth(st, { version: app.getVersion(), openUrl: () => undefined }).check();
|
||||
out.auth = a.status;
|
||||
out.builtinBot = st.hasBuiltinBot;
|
||||
const c = await startCore({ dataDir, resourcesDir: resourcesDir(), worker: workerCommand(), version: app.getVersion(), settings: st });
|
||||
out.codec = c.settings.codecName;
|
||||
out.botMode = c.settings.get().discord.botMode;
|
||||
const ready = await new Promise<any>((res) => {
|
||||
if (c.worker.ready) return res(true);
|
||||
const t = setTimeout(() => res(false), 120000);
|
||||
@@ -141,14 +186,22 @@ async function smoke(): Promise<void> {
|
||||
});
|
||||
});
|
||||
out.worker = ready;
|
||||
// 봇: 로그인 전이라 봇 토큰이 없으니 봇은 꺼져 있어야 한다 (토큰이 exe 에 들어 있지 않다는 확인)
|
||||
out.bot = { status: c.bot.state.status, error: c.bot.state.error };
|
||||
const botOk = a.status === 'signed_out' && !st.hasBuiltinBot && c.bot.state.status !== 'ready';
|
||||
out.gpu = await c.worker.request('gpu_info', {}, 30000).catch((e) => String(e));
|
||||
// 사이트 서버 https: 앱이 믿는 루트 인증서(Node 내장 Mozilla 목록)만으로 실제 서버 인증서가 검증되는지
|
||||
out.siteTls = await secureFetch(`${c.settings.get().site.serverUrl}/healthz`, { timeoutMs: 20000 }).then(
|
||||
(r) => r.ok,
|
||||
(e) => String(e?.message ?? e),
|
||||
);
|
||||
c.settings.setSecret('riotApiKey', 'smoke-test');
|
||||
out.secretRoundTrip = c.settings.getSecret('riotApiKey') === 'smoke-test';
|
||||
c.settings.setSecret('riotApiKey', null);
|
||||
out.dict = c.store.listDict().length;
|
||||
out.renderer = fs.existsSync(path.join(rendererDir(), 'index.html'));
|
||||
out.tray = fs.existsSync(path.join(brandDir(), 'tray.png'));
|
||||
code = ready && out.secretRoundTrip && out.renderer && out.tray ? 0 : 1;
|
||||
code = ready && botOk && out.secretRoundTrip && out.renderer && out.tray && out.siteTls === true ? 0 : 1;
|
||||
await c.stop();
|
||||
} catch (e: any) {
|
||||
out.error = e.stack || e.message;
|
||||
@@ -158,29 +211,121 @@ async function smoke(): Promise<void> {
|
||||
app.exit(code);
|
||||
}
|
||||
|
||||
app.whenReady().then(async () => {
|
||||
if (SMOKE) return smoke();
|
||||
core = await startCore({ dataDir, resourcesDir: resourcesDir(), worker: workerCommand(), version: app.getVersion(), codec: dpapiCodec() });
|
||||
/** 로그인은 됐는데 코어가 못 뜬 경우의 오류 (로그인 화면에 보여 준다) */
|
||||
let appError: string | null = null;
|
||||
const authView = (): AuthView => ({ ...auth!.state, appReady: !!core, appError, version: app.getVersion(), serverUrl: settings!.get().site.serverUrl });
|
||||
const pushAuth = () => {
|
||||
if (win && !win.isDestroyed()) win.webContents.send('gvr:auth', authView());
|
||||
};
|
||||
const pushState = () => {
|
||||
if (core && auth && win && !win.isDestroyed() && win.isVisible()) win.webContents.send('gvr:state', buildState(core, { dataDir, portable: app.isPackaged, auth: auth.state }));
|
||||
};
|
||||
const refreshShell = () => {
|
||||
pushAuth();
|
||||
buildTrayMenu();
|
||||
updateTray();
|
||||
};
|
||||
|
||||
let starting: Promise<void> | null = null;
|
||||
|
||||
/** 로그인 확인 후 코어 시작 */
|
||||
function startApp(): Promise<void> {
|
||||
if (core) return Promise.resolve();
|
||||
starting ??= (async () => {
|
||||
try {
|
||||
// 겜녹이 봇 중계가 로그인 만료 · 등록 해제를 알려 오면 10분을 기다리지 않고 바로 확인해서 잠근다
|
||||
const c = await startCore({ dataDir, resourcesDir: resourcesDir(), worker: workerCommand(), version: app.getVersion(), settings: settings!, onBotUnauthorized: () => void auth?.check() });
|
||||
core = c;
|
||||
ft = new Finetuner(c, pushState);
|
||||
ft.scheduleNightly();
|
||||
appError = null;
|
||||
} catch (e: any) {
|
||||
log.error('코어 시작 실패', e);
|
||||
appError = `겜녹이를 시작하지 못했습니다: ${e?.message ?? e}`;
|
||||
} finally {
|
||||
starting = null;
|
||||
refreshShell();
|
||||
}
|
||||
})();
|
||||
return starting;
|
||||
}
|
||||
|
||||
/** 로그아웃 · 등록 해제: 봇 · 녹음 · 사이트 연결을 모두 멈춘다 */
|
||||
async function stopApp(): Promise<void> {
|
||||
if (starting) await starting;
|
||||
if (!core) return;
|
||||
const c = core;
|
||||
ft = new Finetuner(c, () => win?.webContents.send('gvr:state', buildState(c, { dataDir, portable: app.isPackaged })));
|
||||
ft.scheduleNightly();
|
||||
registerIpc(c, ft, {
|
||||
core = null;
|
||||
ft?.dispose();
|
||||
ft = null;
|
||||
try {
|
||||
await c.stop();
|
||||
} finally {
|
||||
refreshShell();
|
||||
}
|
||||
}
|
||||
|
||||
let authChain: Promise<void> = Promise.resolve();
|
||||
function onAuthChange(): void {
|
||||
authChain = authChain
|
||||
.then(async () => {
|
||||
if (quitting) return;
|
||||
pushAuth();
|
||||
const st = auth!.state.status;
|
||||
if (st === 'ok') {
|
||||
if (!core) return startApp();
|
||||
} else if (st !== 'checking' && st !== 'waiting') {
|
||||
await stopApp();
|
||||
openWindow();
|
||||
}
|
||||
})
|
||||
.catch((e) => log.error('로그인 상태 처리 실패', e));
|
||||
}
|
||||
|
||||
app.whenReady().then(async () => {
|
||||
// 마이크 · 카메라 · 위치 · 알림 등 권한 요청은 모두 거절한다 (아이디 복사용 클립보드 쓰기만 허용)
|
||||
session.defaultSession.setPermissionRequestHandler((_wc, perm, cb) => cb(perm === 'clipboard-sanitized-write'));
|
||||
if (SMOKE) return smoke();
|
||||
settings = new SettingsStore(dataDir, dpapiCodec());
|
||||
auth = new AppAuth(settings, { version: app.getVersion(), openUrl: (u) => shell.openExternal(u) });
|
||||
const a = auth;
|
||||
registerIpc({
|
||||
dataDir,
|
||||
portable: app.isPackaged,
|
||||
win: () => (win && !win.isDestroyed() ? win : null),
|
||||
finishWizard: () => win?.setTitle('겜녹이 · 설정'),
|
||||
quit: () => void quit(),
|
||||
auth: a,
|
||||
current: () => (core && ft ? { core, ft } : null),
|
||||
authView,
|
||||
recheck: async () => {
|
||||
await a.check();
|
||||
await authChain;
|
||||
if (starting) await starting;
|
||||
},
|
||||
});
|
||||
tray = new Tray(trayImage('off'));
|
||||
tray.on('click', () => openWindow());
|
||||
buildTrayMenu();
|
||||
updateTray();
|
||||
refreshShell();
|
||||
a.on('change', onAuthChange);
|
||||
// 시작할 때 확인 → 10분마다 다시 확인 (등록 해제되면 바로 잠김). 서버에 못 붙어 막힌 상태면 1분마다 다시 시도
|
||||
let lastCheck = Date.now();
|
||||
const first = a.check();
|
||||
setInterval(() => {
|
||||
const st = a.state.status;
|
||||
if ((st === 'ok' && Date.now() - lastCheck > 10 * 60000) || (st === 'error' && Date.now() - lastCheck > 60000) || (st === 'ok' && a.state.offline && Date.now() - lastCheck > 60000)) {
|
||||
lastCheck = Date.now();
|
||||
void a.check();
|
||||
}
|
||||
}, 15000);
|
||||
setInterval(() => {
|
||||
updateTray();
|
||||
buildTrayMenu();
|
||||
if (win && !win.isDestroyed() && win.isVisible()) win.webContents.send('gvr:state', buildState(c, { dataDir, portable: app.isPackaged }));
|
||||
pushState();
|
||||
}, 1500);
|
||||
if (!flag('hidden') || !c.settings.get().firstRunDone) openWindow();
|
||||
await first;
|
||||
await authChain;
|
||||
if (!flag('hidden') || !settings.get().firstRunDone || !a.ok) openWindow();
|
||||
if (process.env.GVR_CAPTURE_DIR) void captureScreens(process.env.GVR_CAPTURE_DIR);
|
||||
});
|
||||
|
||||
|
||||
@@ -1,12 +1,13 @@
|
||||
import { contextBridge, ipcRenderer } from 'electron';
|
||||
|
||||
// window.gvr — api-types.ts 의 GvrApi. 이벤트 3개(onState, onProgress, onDiag)만 구독형이고 나머지는 invoke.
|
||||
// window.gvr — api-types.ts 의 GvrApi. 이벤트 4개(onState, onProgress, onDiag, onAuth)만 구독형이고 나머지는 invoke.
|
||||
const METHODS = [
|
||||
'getState', 'updateSettings', 'setSecret', 'testBotToken', 'restartBot', 'guildMembers', 'previewTts', 'gpuInfo', 'models',
|
||||
'download', 'deleteModel', 'applyModels', 'chooseFolder', 'registerDevice', 'unregisterDevice', 'runDiagnostics', 'storageUsage',
|
||||
'runRetention', 'users', 'setRiotIds', 'setExcluded', 'dictionary', 'addWord', 'addCorrection', 'deleteDict', 'setDictEnabled',
|
||||
'finetuneStatus', 'finetuneInstall', 'finetuneStart', 'finetuneStop', 'finetuneRollback', 'clearTrainingData', 'openExternal',
|
||||
'openPath', 'setAutoStart', 'finishWizard', 'recentLogs', 'quit',
|
||||
'authState', 'authLogin', 'authCancel', 'authLogout', 'authRecheck', 'adminUsers', 'adminAddUser', 'adminSetRole', 'adminRemoveUser',
|
||||
];
|
||||
const api: Record<string, unknown> = {};
|
||||
for (const m of METHODS) api[m] = (...args: unknown[]) => ipcRenderer.invoke(`gvr:${m}`, ...args);
|
||||
@@ -18,4 +19,5 @@ const sub = (ch: string) => (cb: (v: unknown) => void) => {
|
||||
api.onState = sub('gvr:state');
|
||||
api.onProgress = sub('gvr:progress');
|
||||
api.onDiag = sub('gvr:diag');
|
||||
api.onAuth = sub('gvr:auth');
|
||||
contextBridge.exposeInMainWorld('gvr', api);
|
||||
|
||||
143
app/src/renderer/auth/Login.tsx
Normal file
@@ -0,0 +1,143 @@
|
||||
// 로그인 화면 + 로그인 게이트. 등록된 디스코드 아이디로 로그인해야 설정 창(과 봇 · 녹음)이 열린다
|
||||
import { useEffect, useState, type ReactNode } from 'react';
|
||||
import type { AuthView } from '../../main/api-types';
|
||||
import banner from '../assets/banner.png';
|
||||
import { gvr } from '../store';
|
||||
import { Avatar, Btn, Err, Spinner } from '../ui';
|
||||
import { errMsg } from '../util';
|
||||
|
||||
export function AuthGate({ children }: { children: ReactNode }) {
|
||||
const [auth, setAuth] = useState<AuthView | null>(null);
|
||||
const [loadError, setLoadError] = useState<string | null>(null);
|
||||
useEffect(() => {
|
||||
let alive = true;
|
||||
gvr.authState().then(
|
||||
(s) => alive && setAuth(s),
|
||||
(e) => alive && setLoadError(errMsg(e)),
|
||||
);
|
||||
const off = gvr.onAuth((s) => setAuth(s));
|
||||
return () => {
|
||||
alive = false;
|
||||
off();
|
||||
};
|
||||
}, []);
|
||||
if (!auth) return <div className="boot">{loadError ? <div className="err">메인 프로세스에 연결하지 못했습니다: {loadError}</div> : <Spinner big />}</div>;
|
||||
if (auth.status === 'ok' && auth.appReady) return <>{children}</>;
|
||||
return <LoginScreen auth={auth} />;
|
||||
}
|
||||
|
||||
function LoginScreen({ auth }: { auth: AuthView }) {
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
const [copied, setCopied] = useState(false);
|
||||
useEffect(() => {
|
||||
document.title = '겜녹이 · 로그인';
|
||||
}, []);
|
||||
const login = async () => {
|
||||
setError(null);
|
||||
try {
|
||||
await gvr.authLogin();
|
||||
} catch (e) {
|
||||
setError(errMsg(e));
|
||||
}
|
||||
};
|
||||
const st = auth.status;
|
||||
const host = auth.serverUrl.replace(/^https?:\/\//, '');
|
||||
|
||||
let body: ReactNode;
|
||||
if (st === 'ok' && !auth.appReady && auth.appError) {
|
||||
body = (
|
||||
<>
|
||||
<Err>{auth.appError}</Err>
|
||||
<div className="muted small">로그인은 되었습니다. 겜녹이를 종료한 뒤 다시 실행해 주세요. 계속되면 GVR-Data\logs 의 로그를 관리자에게 보내 주세요.</div>
|
||||
</>
|
||||
);
|
||||
} else if (st === 'checking' || (st === 'ok' && !auth.appReady)) {
|
||||
body = (
|
||||
<div className="row gap muted">
|
||||
<Spinner /> {st === 'ok' ? '겜녹이를 시작하는 중…' : '로그인 확인 중…'}
|
||||
</div>
|
||||
);
|
||||
} else if (st === 'waiting') {
|
||||
body = (
|
||||
<>
|
||||
<div className="row gap">
|
||||
<Spinner /> 브라우저에서 디스코드 로그인을 마쳐 주세요
|
||||
</div>
|
||||
<div className="hint">
|
||||
브라우저가 열리지 않았다면{' '}
|
||||
<a href="#" onClick={(e) => (e.preventDefault(), auth.loginUrl && void gvr.openExternal(auth.loginUrl))}>
|
||||
로그인 페이지 다시 열기 ↗
|
||||
</a>
|
||||
</div>
|
||||
<div className="row end">
|
||||
<Btn onClick={() => gvr.authCancel()}>취소</Btn>
|
||||
</div>
|
||||
</>
|
||||
);
|
||||
} else if (st === 'not_registered') {
|
||||
body = (
|
||||
<>
|
||||
<div className="login-bad">⛔ 등록되지 않은 아이디입니다</div>
|
||||
{auth.user && (
|
||||
<div className="login-who">
|
||||
<Avatar name={auth.user.name} src={auth.user.avatar} size={32} />
|
||||
<div className="grow">
|
||||
<div>{auth.user.name}</div>
|
||||
<div className="id">{auth.user.id}</div>
|
||||
</div>
|
||||
<Btn
|
||||
small
|
||||
onClick={async () => {
|
||||
await navigator.clipboard.writeText(auth.user!.id).catch(() => undefined);
|
||||
setCopied(true);
|
||||
}}
|
||||
>
|
||||
{copied ? '복사됨 ✓' : '아이디 복사'}
|
||||
</Btn>
|
||||
</div>
|
||||
)}
|
||||
<div className="muted small">이 계정은 겜녹이를 쓸 수 없습니다. 관리자에게 위 디스코드 아이디 등록을 요청한 뒤 다시 로그인해 주세요.</div>
|
||||
<Btn primary onClick={login}>
|
||||
다시 로그인
|
||||
</Btn>
|
||||
</>
|
||||
);
|
||||
} else {
|
||||
body = (
|
||||
<>
|
||||
<div className="muted small">등록된 디스코드 계정으로 로그인해야 겜녹이를 쓸 수 있습니다. 로그인 버튼을 누르면 브라우저에서 디스코드 로그인 창이 열립니다.</div>
|
||||
{st === 'error' && (
|
||||
<div className="row gap">
|
||||
<Err>{auth.error}</Err>
|
||||
<span className="grow" />
|
||||
<Btn small onClick={() => gvr.authRecheck()}>
|
||||
다시 시도
|
||||
</Btn>
|
||||
</div>
|
||||
)}
|
||||
{st === 'signed_out' && auth.error && <Err>{auth.error}</Err>}
|
||||
<Btn primary onClick={login}>
|
||||
디스코드로 로그인
|
||||
</Btn>
|
||||
</>
|
||||
);
|
||||
}
|
||||
|
||||
return (
|
||||
<div className="login">
|
||||
<div className="login-card">
|
||||
<img className="banner" src={banner} alt="겜녹이" />
|
||||
<div className="h login-title">로그인</div>
|
||||
{body}
|
||||
<Err>{error}</Err>
|
||||
<div className="login-foot">
|
||||
겜녹이 v{auth.version} · {host}
|
||||
<span className="grow" />
|
||||
<Btn small ghost onClick={() => gvr.quit()}>
|
||||
종료
|
||||
</Btn>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -3,7 +3,7 @@
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<!-- 브라우저 개발용: window.gvr 가 없으면 main.tsx 가 mock-gvr 로 대신한다.
|
||||
?first=1 → 첫 실행(마법사) 상태, ?nogpu=1 → GPU 없음, ?empty=1 → 봇 토큰 없음 -->
|
||||
?first=1 → 첫 실행(마법사) 상태, ?nogpu=1 → GPU 없음, ?empty=1 → 봇 토큰 없음, ?custom=1 → 다른 봇 모드, ?nobuiltin=1 → 기본 봇 없는 빌드 -->
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>겜녹이 · 설정 (dev)</title>
|
||||
<link rel="stylesheet" href="renderer.css">
|
||||
|
||||
@@ -1,9 +1,12 @@
|
||||
// 겜녹이 설정 창 렌더러 진입점. 라우팅: #/wizard[/단계] · #/settings/<탭>
|
||||
import { useEffect, useState, type ReactNode } from 'react';
|
||||
import { createRoot } from 'react-dom/client';
|
||||
import { ROLE_LABEL, isAdminRole } from '../core/roles';
|
||||
import tray from './assets/tray@2x.png';
|
||||
import { AuthGate } from './auth/Login';
|
||||
import { AppProvider, isMock, useApp } from './store';
|
||||
import './styles.css';
|
||||
import { AdminTab } from './tabs/AdminTab';
|
||||
import { AudioTab } from './tabs/AudioTab';
|
||||
import { DiagTab } from './tabs/DiagTab';
|
||||
import { DictTab } from './tabs/DictTab';
|
||||
@@ -12,7 +15,7 @@ import { GamesTab } from './tabs/GamesTab';
|
||||
import { GeneralTab } from './tabs/GeneralTab';
|
||||
import { StorageTab } from './tabs/StorageTab';
|
||||
import { SttTab } from './tabs/SttTab';
|
||||
import { Dot } from './ui';
|
||||
import { Avatar, Dot } from './ui';
|
||||
import { go } from './util';
|
||||
import { Wizard } from './wizard/Wizard';
|
||||
|
||||
@@ -26,6 +29,9 @@ const TABS: { id: string; icon: string; label: string; el: () => ReactNode }[] =
|
||||
{ id: 'diag', icon: '🔬', label: '진단', el: () => <DiagTab /> },
|
||||
{ id: 'general', icon: '⚙️', label: '일반', el: () => <GeneralTab /> },
|
||||
];
|
||||
/** 관리자 · 최고 관리자에게만 보이는 탭 */
|
||||
const ADMIN_TAB = { id: 'admin', icon: '🛡️', label: '관리자', el: () => <AdminTab /> };
|
||||
const tabsFor = (role: string | null) => (isAdminRole(role as never) ? [...TABS, ADMIN_TAB] : TABS);
|
||||
|
||||
function useHash(): string {
|
||||
const [h, setH] = useState(location.hash);
|
||||
@@ -38,7 +44,7 @@ function useHash(): string {
|
||||
}
|
||||
|
||||
function Router() {
|
||||
const { settings } = useApp();
|
||||
const { settings, state } = useApp();
|
||||
const hash = useHash();
|
||||
const parts = hash.replace(/^#\/?/, '').split('/');
|
||||
|
||||
@@ -53,10 +59,11 @@ function Router() {
|
||||
}, [isWizard]);
|
||||
|
||||
if (isWizard) return <Wizard step={Math.max(1, Math.min(5, Number(parts[1]) || 1))} />;
|
||||
const tab = TABS.find((t) => t.id === parts[1]) ?? TABS[0]!;
|
||||
const tabs = tabsFor(state.account.role);
|
||||
const tab = tabs.find((t) => t.id === parts[1]) ?? tabs[0]!;
|
||||
return (
|
||||
<div className="app">
|
||||
<Nav current={tab.id} />
|
||||
<Nav current={tab.id} tabs={tabs} />
|
||||
<main className="content" key={tab.id}>
|
||||
{tab.el()}
|
||||
</main>
|
||||
@@ -64,8 +71,9 @@ function Router() {
|
||||
);
|
||||
}
|
||||
|
||||
function Nav({ current }: { current: string }) {
|
||||
function Nav({ current, tabs }: { current: string; tabs: typeof TABS }) {
|
||||
const { state } = useApp();
|
||||
const acc = state.account;
|
||||
const bot = state.bot.status;
|
||||
const botTone = bot === 'ready' ? 'ok' : bot === 'connecting' ? 'warn' : bot === 'error' ? 'err' : 'off';
|
||||
const botText = bot === 'ready' ? (state.bot.recording.active ? '녹음 중' : '정상') : bot === 'connecting' ? '연결 중' : bot === 'error' ? '오류' : '꺼짐';
|
||||
@@ -74,13 +82,21 @@ function Nav({ current }: { current: string }) {
|
||||
const relayText = r === 'online' ? '연결됨' : r === 'connecting' ? '연결 중' : r === 'error' ? '오류' : '미등록';
|
||||
return (
|
||||
<nav className="side">
|
||||
{TABS.map((t) => (
|
||||
{tabs.map((t) => (
|
||||
<a key={t.id} href={`#/settings/${t.id}`} className={`tab ${t.id === current ? 'on' : ''}`}>
|
||||
<span className="ic">{t.icon}</span>
|
||||
{t.label}
|
||||
</a>
|
||||
))}
|
||||
<div className="nav-status">
|
||||
{acc.user && (
|
||||
<a href="#/settings/general" className="nav-account" title={acc.offline ? '사이트 서버에 연결되지 않아 마지막 확인 결과로 쓰는 중' : acc.user.id}>
|
||||
<Avatar name={acc.user.name} src={acc.user.avatar} size={18} />
|
||||
{acc.user.name}
|
||||
{acc.role && <span className={`role ${acc.role}`}>{ROLE_LABEL[acc.role]}</span>}
|
||||
{acc.offline && <span className="t-warn">·오프라인</span>}
|
||||
</a>
|
||||
)}
|
||||
<div className="brand-mini">
|
||||
<img src={tray} alt="" />
|
||||
겜녹이 v{state.version}
|
||||
@@ -101,7 +117,9 @@ function Nav({ current }: { current: string }) {
|
||||
}
|
||||
|
||||
createRoot(document.getElementById('root')!).render(
|
||||
<AppProvider>
|
||||
<Router />
|
||||
</AppProvider>,
|
||||
<AuthGate>
|
||||
<AppProvider>
|
||||
<Router />
|
||||
</AppProvider>
|
||||
</AuthGate>,
|
||||
);
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
// 브라우저 개발/스크린샷용 가짜 GvrApi. window.gvr 가 없을 때만 쓴다.
|
||||
// URL 옵션: ?first=1 (첫 실행 · 마법사), ?nogpu=1 (GPU 없음), ?empty=1 (봇 토큰 없음), ?dl=0.6 (다운로드 시작 위치 비율)
|
||||
import type { User } from '@gvr/shared';
|
||||
// ?login=signed_out|not_registered|error (로그인 화면), ?role=superadmin|admin|user (기본 superadmin)
|
||||
import type { AppRole, AppUserRow, User } from '@gvr/shared';
|
||||
import type { DiagItem } from '../core/diagnostics';
|
||||
import type { Settings } from '../core/settings';
|
||||
import type { AppState, DownloadProgress, FinetuneStatus, GvrApi, ModelsInfo } from '../main/api-types';
|
||||
import type { AppState, AuthView, DownloadProgress, FinetuneStatus, GvrApi, ModelsInfo } from '../main/api-types';
|
||||
import { MODEL_META } from './models-meta';
|
||||
import { deepMerge, sleep } from './util';
|
||||
|
||||
@@ -14,12 +15,13 @@ function defaults(): Settings {
|
||||
version: 1,
|
||||
firstRunDone: false,
|
||||
discord: {
|
||||
botMode: 'builtin',
|
||||
guildId: null,
|
||||
followUserId: null,
|
||||
followEnabled: true,
|
||||
commandsEnabled: true,
|
||||
ttsEnabled: true,
|
||||
ttsText: '겜녹이가 이 음성채널을 녹음합니다. 녹음을 원하지 않으시면 녹음제외 명령을 입력해 주세요.',
|
||||
ttsText: '겜녹이가 이 음성채널을 녹음합니다. 녹음된 대화는 AI 경기 분석에 쓰일 수 있어요. 녹음을 원하지 않으시면 녹음제외 명령을 입력해 주세요.',
|
||||
ttsOnNewMember: true,
|
||||
ttsVoice: 'ko-KR-SunHiNeural',
|
||||
},
|
||||
@@ -84,17 +86,49 @@ export function createMockGvr(): GvrApi {
|
||||
|
||||
const settings = defaults();
|
||||
settings.firstRunDone = !first;
|
||||
if (q.has('custom')) settings.discord.botMode = 'custom';
|
||||
if (!noToken) {
|
||||
settings.discord.guildId = 'g1';
|
||||
settings.discord.followUserId = 'u1';
|
||||
settings.site.deviceId = 'dev_8f2c';
|
||||
}
|
||||
|
||||
const role = (q.get('role') as AppRole) || 'superadmin';
|
||||
const me = { id: '293719842274541579', name: role === 'user' ? '민준' : '사금향', avatar: null };
|
||||
const login = q.get('login');
|
||||
const auth: AuthView = {
|
||||
status: login === 'signed_out' || login === 'not_registered' || login === 'error' ? login : 'ok',
|
||||
user: login === 'not_registered' ? { id: '987654321098765432', name: '모르는사람', avatar: null } : login ? null : me,
|
||||
role: login ? null : role,
|
||||
offline: false,
|
||||
error: login === 'error' ? '사이트 서버에 연결할 수 없습니다 (fetch failed)' : null,
|
||||
loginUrl: null,
|
||||
verifiedAt: login ? null : now,
|
||||
appReady: !login,
|
||||
appError: null,
|
||||
version: '1.2.0',
|
||||
serverUrl: 'https://gvr.tkrmagid.kr',
|
||||
};
|
||||
const authListeners = new Set<(s: AuthView) => void>();
|
||||
const emitAuth = () => authListeners.forEach((l) => l(structuredClone(auth)));
|
||||
let adminRows: AppUserRow[] = [
|
||||
{ id: '293719842274541579', name: '사금향', avatar: null, role: 'superadmin', fixed: true, addedBy: null, addedAt: null, lastSeenAt: now - 60000, lastVersion: '1.2.0' },
|
||||
{ id: '1352267557213573160', name: '두번째관리자', avatar: null, role: 'superadmin', fixed: true, addedBy: null, addedAt: null, lastSeenAt: now - 3 * 86400000, lastVersion: '1.2.0' },
|
||||
{ id: '401234567890123456', name: '서연', avatar: null, role: 'admin', fixed: false, addedBy: '293719842274541579', addedAt: now - 5 * 86400000, lastSeenAt: now - 2 * 3600000, lastVersion: '1.2.0' },
|
||||
{ id: '402345678901234567', name: '민준', avatar: null, role: 'user', fixed: false, addedBy: '293719842274541579', addedAt: now - 4 * 86400000, lastSeenAt: now - 20 * 60000, lastVersion: '1.2.0' },
|
||||
{ id: '403456789012345678', name: '지호', avatar: null, role: 'user', fixed: false, addedBy: '293719842274541579', addedAt: now - 86400000, lastSeenAt: null, lastVersion: null },
|
||||
];
|
||||
const adminCheck = (lvl: 'admin' | 'superadmin') => {
|
||||
if (lvl === 'superadmin' ? role !== 'superadmin' : role === 'user') throw new Error(lvl === 'superadmin' ? '유저 등록은 최고 관리자만 할 수 있습니다' : '관리자만 볼 수 있습니다');
|
||||
};
|
||||
|
||||
const state: AppState = {
|
||||
version: '1.0.0',
|
||||
account: { user: me, role, offline: false },
|
||||
version: '1.2.0',
|
||||
dataDir: 'D:\\겜녹이\\GVR-Data',
|
||||
portable: true,
|
||||
settings,
|
||||
builtinBot: !q.has('nobuiltin'),
|
||||
secrets: { botToken: !noToken, riotApiKey: false, deviceKey: !noToken },
|
||||
secretCodec: 'dpapi',
|
||||
bot: noToken
|
||||
@@ -210,6 +244,60 @@ export function createMockGvr(): GvrApi {
|
||||
}, 4000);
|
||||
|
||||
const api: GvrApi = {
|
||||
async authState() {
|
||||
await sleep(60);
|
||||
return structuredClone(auth);
|
||||
},
|
||||
onAuth(cb) {
|
||||
authListeners.add(cb);
|
||||
return () => authListeners.delete(cb);
|
||||
},
|
||||
async authLogin() {
|
||||
Object.assign(auth, { status: 'waiting', loginUrl: 'https://gvr.tkrmagid.kr/auth/app/start/mock', error: null });
|
||||
emitAuth();
|
||||
await sleep(2500);
|
||||
if (auth.status !== 'waiting') return structuredClone(auth);
|
||||
Object.assign(auth, { status: 'ok', user: me, role, loginUrl: null, appReady: true, verifiedAt: Date.now() });
|
||||
emitAuth();
|
||||
return structuredClone(auth);
|
||||
},
|
||||
async authCancel() {
|
||||
Object.assign(auth, { status: 'signed_out', loginUrl: null });
|
||||
emitAuth();
|
||||
},
|
||||
async authLogout() {
|
||||
Object.assign(auth, { status: 'signed_out', user: null, role: null, appReady: false, error: null });
|
||||
emitAuth();
|
||||
},
|
||||
async authRecheck() {
|
||||
await sleep(600);
|
||||
return structuredClone(auth);
|
||||
},
|
||||
async adminUsers() {
|
||||
await sleep(200);
|
||||
adminCheck('admin');
|
||||
return { users: structuredClone(adminRows) };
|
||||
},
|
||||
async adminAddUser(id, r) {
|
||||
await sleep(400);
|
||||
adminCheck('superadmin');
|
||||
if (!/^\d{17,20}$/.test(id.trim())) throw new Error('디스코드 아이디는 17~20자리 숫자입니다');
|
||||
if (adminRows.some((u) => u.id === id.trim())) adminRows = adminRows.map((u) => (u.id === id.trim() && !u.fixed ? { ...u, role: r } : u));
|
||||
else adminRows.push({ id: id.trim(), name: `새유저${adminRows.length}`, avatar: null, role: r, fixed: false, addedBy: me.id, addedAt: Date.now(), lastSeenAt: null, lastVersion: null });
|
||||
return { users: structuredClone(adminRows) };
|
||||
},
|
||||
async adminSetRole(id, r) {
|
||||
await sleep(200);
|
||||
adminCheck('superadmin');
|
||||
adminRows = adminRows.map((u) => (u.id === id && !u.fixed ? { ...u, role: r } : u));
|
||||
return { users: structuredClone(adminRows) };
|
||||
},
|
||||
async adminRemoveUser(id) {
|
||||
await sleep(200);
|
||||
adminCheck('superadmin');
|
||||
adminRows = adminRows.filter((u) => u.id !== id || u.fixed);
|
||||
return { users: structuredClone(adminRows) };
|
||||
},
|
||||
async getState() {
|
||||
await sleep(80);
|
||||
return structuredClone(state);
|
||||
@@ -229,9 +317,11 @@ export function createMockGvr(): GvrApi {
|
||||
emit();
|
||||
},
|
||||
async testBotToken(token) {
|
||||
// 실제 IPC 처럼 부를 때의 모드로 토큰을 고른다 (응답은 늦게 온다)
|
||||
const noSaved = state.settings.discord.botMode === 'builtin' ? !state.builtinBot : !state.secrets.botToken;
|
||||
await sleep(900);
|
||||
if (token !== undefined && token.length < 20) return { ok: false, error: '토큰이 올바르지 않습니다 (401 Unauthorized)' };
|
||||
if (token === undefined && !state.secrets.botToken) return { ok: false, error: '저장된 토큰이 없습니다' };
|
||||
if (token === undefined && noSaved) return { ok: false, error: '저장된 토큰이 없습니다' };
|
||||
return {
|
||||
ok: true,
|
||||
bot: { id: 'b1', name: '겜녹이#4821', avatar: null },
|
||||
@@ -242,6 +332,11 @@ export function createMockGvr(): GvrApi {
|
||||
};
|
||||
},
|
||||
async restartBot() {
|
||||
if (state.settings.discord.botMode === 'builtin' ? !state.builtinBot : !state.secrets.botToken) {
|
||||
state.bot = { ...state.bot, status: 'off', error: null, user: null, guild: null, guilds: [] };
|
||||
emit();
|
||||
return { ok: false, error: '봇 토큰이 없습니다' };
|
||||
}
|
||||
state.bot.status = 'connecting';
|
||||
emit();
|
||||
await sleep(900);
|
||||
|
||||
@@ -159,6 +159,7 @@ input[type='number'].input { flex: none; padding: 7px 8px; }
|
||||
.radio button { flex: 1; text-align: left; border: 1px solid var(--line); border-radius: 10px; padding: 12px 14px; font-size: 13px; background: var(--field); cursor: pointer; }
|
||||
.radio button.on { border: 2px solid var(--accent); background: #1e1419; padding: 11px 13px; }
|
||||
.radio b { display: block; margin-bottom: 4px; font-size: 14px; }
|
||||
.radio + .field, .radio + .lab { margin-top: 14px; }
|
||||
.recstat { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; font-size: 14px; }
|
||||
.recstat.idle { color: var(--muted); font-size: 13px; }
|
||||
.rec-dot { width: 10px; height: 10px; border-radius: 50%; background: var(--accent); box-shadow: 0 0 0 4px rgba(255, 70, 85, 0.2); animation: pulse 1.6s infinite; }
|
||||
@@ -295,3 +296,25 @@ input[type='number'].input { flex: none; padding: 7px 8px; }
|
||||
.modal-bg { position: fixed; inset: 0; background: rgba(3, 8, 12, 0.66); display: flex; align-items: center; justify-content: center; z-index: 60; }
|
||||
.modal { width: 420px; background: var(--panel); border: 1px solid var(--line); border-radius: 14px; padding: 22px; box-shadow: 0 20px 60px rgba(0, 0, 0, 0.5); }
|
||||
.modal-text { font-size: 14px; line-height: 1.6; margin-bottom: 18px; white-space: pre-wrap; }
|
||||
|
||||
/* ---------- 로그인 · 관리자 ---------- */
|
||||
.admin-lock { border: 0; min-width: 0; padding: 0; margin: 0; }
|
||||
.admin-lock .locked { opacity: 0.5; pointer-events: none; }
|
||||
.lock-note { font-size: 12px; color: var(--gold); margin-bottom: 8px; }
|
||||
.login { height: 100%; display: flex; align-items: center; justify-content: center; padding: 24px; }
|
||||
.login-card { width: 440px; background: var(--panel); border: 1px solid var(--line); border-radius: 16px; padding: 28px 30px 22px; display: flex; flex-direction: column; gap: 14px; }
|
||||
.login-card .banner { width: 100%; border-radius: 10px; border: 1px solid var(--line); display: block; }
|
||||
.login-title { font-size: 20px; font-weight: 800; }
|
||||
.login-card .btn.discord { background: #5865f2; border-color: #5865f2; color: #fff; font-weight: 700; padding: 12px 16px; font-size: 14px; }
|
||||
.login-who { display: flex; align-items: center; gap: 10px; background: var(--field); border: 1px solid var(--line); border-radius: 10px; padding: 10px 12px; }
|
||||
.login-who .id { font-family: var(--font-mono); font-size: 12px; color: var(--muted); }
|
||||
.login-bad { color: #ff6b77; font-weight: 700; font-size: 15px; }
|
||||
.login-foot { display: flex; align-items: center; gap: 8px; font-size: 12px; color: var(--dim); border-top: 1px solid var(--line); padding-top: 12px; }
|
||||
.role { display: inline-block; font-size: 11px; padding: 2px 8px; border-radius: 6px; font-weight: 700; }
|
||||
.role.superadmin { background: rgba(255, 70, 85, 0.16); color: #ff8a94; }
|
||||
.role.admin { background: rgba(242, 178, 58, 0.16); color: var(--gold); }
|
||||
.role.user { background: rgba(20, 193, 183, 0.14); color: var(--mint); }
|
||||
.nav-account { display: flex; align-items: center; gap: 6px; margin-bottom: 4px; color: #b9c6d2; }
|
||||
.admin-list { list-style: none; display: flex; flex-direction: column; gap: 6px; font-size: 13px; }
|
||||
.admin-list li { display: flex; gap: 8px; align-items: baseline; }
|
||||
.admin-list li .muted { font-size: 12px; }
|
||||
|
||||
195
app/src/renderer/tabs/AdminTab.tsx
Normal file
@@ -0,0 +1,195 @@
|
||||
// 관리자 탭: 유저 등록(최고 관리자만) · 등록 유저 목록 · 관리자 전용 기능 안내
|
||||
import { useState } from 'react';
|
||||
import type { AppUserRow } from '@gvr/shared';
|
||||
import { ROLE_LABEL } from '../../core/roles';
|
||||
import { gvr, useAction, useApp, useLoad } from '../store';
|
||||
import { Avatar, Btn, Err, Page, Section, Select, Spinner } from '../ui';
|
||||
import { fmtAgo, fmtDate } from '../util';
|
||||
|
||||
const ROLE_OPTIONS = [
|
||||
{ value: 'user' as const, label: '유저' },
|
||||
{ value: 'admin' as const, label: '관리자' },
|
||||
];
|
||||
|
||||
/** 일반 유저가 바꿀 수 없는 것 (core/roles.ts 와 같은 목록) */
|
||||
const ADMIN_FEATURES: { what: string; why: string; tab: string }[] = [
|
||||
{ what: '다른 봇으로 바꾸기 · 봇 토큰 입력', why: '겜녹이 봇 대신 다른 봇을 붙이는 설정', tab: 'discord' },
|
||||
{ what: '녹음 안내(TTS) 끄기 · 안내 문구 변경', why: '녹음되는 사람에게 알리는 장치', tab: 'discord' },
|
||||
{ what: '음성 보관 기간', why: '다른 사람 목소리를 얼마나 남길지 정하는 정책', tab: 'storage' },
|
||||
{ what: '사이트 서버 주소 · PC 이름 · 사이트 등록/해제', why: '모두가 보는 사이트에 연결되는 PC', tab: 'storage' },
|
||||
{ what: '학습 데이터 삭제', why: '되돌릴 수 없는 삭제', tab: 'storage' },
|
||||
{ what: '파인튜닝 (학습 · 되돌리기 · 자동 일정)', why: '인식 모델을 바꾸는 작업', tab: 'stt' },
|
||||
];
|
||||
|
||||
function AddUser({ onDone }: { onDone: (users: AppUserRow[]) => void }) {
|
||||
const { toast } = useApp();
|
||||
const [id, setId] = useState('');
|
||||
const [role, setRole] = useState<'user' | 'admin'>('user');
|
||||
const act = useAction();
|
||||
const valid = /^\d{17,20}$/.test(id.trim());
|
||||
const add = async () => {
|
||||
const r = await act.run(() => gvr.adminAddUser(id.trim(), role));
|
||||
if (r) {
|
||||
onDone(r.users);
|
||||
setId('');
|
||||
toast(`${r.users.find((u) => u.id === id.trim())?.name ?? id.trim()} 등록됨`);
|
||||
}
|
||||
};
|
||||
return (
|
||||
<>
|
||||
<div className="field">
|
||||
<input
|
||||
className={`input mono ${id && !valid ? 'bad' : ''}`}
|
||||
value={id}
|
||||
placeholder="디스코드 아이디 (숫자 17~20자리)"
|
||||
spellCheck={false}
|
||||
onChange={(e) => setId(e.target.value.replace(/\s/g, ''))}
|
||||
onKeyDown={(e) => e.key === 'Enter' && valid && void add()}
|
||||
/>
|
||||
<Select width={110} value={role} options={ROLE_OPTIONS} onChange={setRole} />
|
||||
<Btn primary disabled={!valid} busy={act.busy} onClick={add}>
|
||||
등록
|
||||
</Btn>
|
||||
</div>
|
||||
<div className="hint">디스코드 설정 → 고급 → 개발자 모드를 켠 뒤, 프로필을 오른쪽 클릭 → '사용자 ID 복사'로 아이디를 얻습니다. 등록되지 않은 사람이 로그인하면 화면에 아이디가 나오니 그것을 받아도 됩니다.</div>
|
||||
<Err>{act.error}</Err>
|
||||
</>
|
||||
);
|
||||
}
|
||||
|
||||
function UserTable({ users, superAdmin, onChange }: { users: AppUserRow[]; superAdmin: boolean; onChange: (users: AppUserRow[]) => void }) {
|
||||
const { state, confirm, toast } = useApp();
|
||||
const act = useAction();
|
||||
const name = (id: string | null) => (id ? (users.find((u) => u.id === id)?.name ?? id) : '-');
|
||||
return (
|
||||
<>
|
||||
<div className="table-wrap" style={{ maxHeight: 460 }}>
|
||||
<table className="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th>계정</th>
|
||||
<th>역할</th>
|
||||
<th>마지막 접속</th>
|
||||
<th>등록</th>
|
||||
{superAdmin && <th />}
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{users.map((u) => (
|
||||
<tr key={u.id}>
|
||||
<td>
|
||||
<div className="row gap">
|
||||
<Avatar name={u.name} src={u.avatar} size={24} />
|
||||
<div>
|
||||
<div>
|
||||
{u.name}
|
||||
{u.id === state.account.user?.id && <span className="muted small"> (나)</span>}
|
||||
</div>
|
||||
<div className="mono dim small">{u.id}</div>
|
||||
</div>
|
||||
</div>
|
||||
</td>
|
||||
<td>
|
||||
{superAdmin && !u.fixed ? (
|
||||
<Select
|
||||
width={100}
|
||||
value={u.role as 'user' | 'admin'}
|
||||
options={ROLE_OPTIONS}
|
||||
disabled={act.busy}
|
||||
onChange={async (r) => {
|
||||
const res = await act.run(() => gvr.adminSetRole(u.id, r));
|
||||
if (res) {
|
||||
onChange(res.users);
|
||||
toast(`${u.name} → ${ROLE_LABEL[r]}`);
|
||||
}
|
||||
}}
|
||||
/>
|
||||
) : (
|
||||
<span className={`role ${u.role}`}>{ROLE_LABEL[u.role]}</span>
|
||||
)}
|
||||
</td>
|
||||
<td className="small">
|
||||
{u.lastSeenAt ? (
|
||||
<span title={fmtDate(u.lastSeenAt)}>
|
||||
{fmtAgo(u.lastSeenAt)}
|
||||
{u.lastVersion && <span className="dim"> · v{u.lastVersion}</span>}
|
||||
</span>
|
||||
) : (
|
||||
<span className="dim">접속 기록 없음</span>
|
||||
)}
|
||||
</td>
|
||||
<td className="small muted">{u.fixed ? '고정' : `${name(u.addedBy)} · ${u.addedAt ? fmtDate(u.addedAt) : '-'}`}</td>
|
||||
{superAdmin && (
|
||||
<td className="r">
|
||||
{!u.fixed && (
|
||||
<Btn
|
||||
small
|
||||
danger
|
||||
disabled={act.busy}
|
||||
onClick={async () => {
|
||||
if (!(await confirm(`${u.name} (${u.id}) 등록을 해제할까요? 이 사람의 겜녹이는 다음 확인 때(최대 10분) 바로 잠깁니다.`, { ok: '등록 해제', danger: true }))) return;
|
||||
const res = await act.run(() => gvr.adminRemoveUser(u.id));
|
||||
if (res) {
|
||||
onChange(res.users);
|
||||
toast(`${u.name} 등록 해제`);
|
||||
}
|
||||
}}
|
||||
>
|
||||
해제
|
||||
</Btn>
|
||||
)}
|
||||
</td>
|
||||
)}
|
||||
</tr>
|
||||
))}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<Err>{act.error}</Err>
|
||||
</>
|
||||
);
|
||||
}
|
||||
|
||||
export function AdminTab() {
|
||||
const { state } = useApp();
|
||||
const superAdmin = state.account.role === 'superadmin';
|
||||
const list = useLoad(() => gvr.adminUsers());
|
||||
const users = list.data?.users ?? [];
|
||||
const set = (u: AppUserRow[]) => list.setData({ users: u });
|
||||
return (
|
||||
<Page
|
||||
title="관리자"
|
||||
desc={
|
||||
<>
|
||||
겜녹이는 등록된 디스코드 계정으로 로그인해야 쓸 수 있습니다. 유저 등록 · 역할 변경은 <b>최고 관리자</b>만, 목록 보기와 관리자 전용 설정은 <b>관리자</b>도 할 수 있습니다.
|
||||
{state.account.offline && <span className="t-warn"> 지금은 사이트 서버에 연결되지 않아 목록을 불러오지 못할 수 있습니다.</span>}
|
||||
</>
|
||||
}
|
||||
>
|
||||
<Section title="유저 등록" sub="최고 관리자만">
|
||||
{superAdmin ? <AddUser onDone={set} /> : <div className="lock-note">🔒 유저 등록 · 역할 변경 · 등록 해제는 최고 관리자만 할 수 있습니다. 아래 목록은 볼 수 있습니다.</div>}
|
||||
</Section>
|
||||
<Section
|
||||
title={`등록된 계정 ${users.length ? `${users.length}명` : ''}`}
|
||||
right={
|
||||
<Btn small ghost onClick={list.reload}>
|
||||
새로고침
|
||||
</Btn>
|
||||
}
|
||||
>
|
||||
{list.loading && !list.data ? <Spinner /> : list.error ? <Err>{list.error}</Err> : <UserTable users={users} superAdmin={superAdmin} onChange={set} />}
|
||||
</Section>
|
||||
<Section title="관리자 전용 기능" sub="일반 유저 화면에서는 잠겨 있습니다">
|
||||
<ul className="admin-list">
|
||||
{ADMIN_FEATURES.map((f) => (
|
||||
<li key={f.what}>
|
||||
<span>🔒</span>
|
||||
<a href={`#/settings/${f.tab}`}>{f.what}</a>
|
||||
<span className="muted">· {f.why}</span>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</Section>
|
||||
</Page>
|
||||
);
|
||||
}
|
||||
@@ -1,8 +1,8 @@
|
||||
import { useEffect, useRef, useState } from 'react';
|
||||
import type { GvrApi } from '../../main/api-types';
|
||||
import { gvr, useAction, useApp, useLoad } from '../store';
|
||||
import { Avatar, Btn, DraftInput, Err, Line, Ok, Page, Section, Select, ToggleLine } from '../ui';
|
||||
import { fmtClock, fmtDuration } from '../util';
|
||||
import { AdminOnly, Avatar, Btn, DraftInput, Err, Line, Ok, Page, Section, Select, ToggleLine, useIsAdmin } from '../ui';
|
||||
import { errMsg, fmtClock, fmtDuration } from '../util';
|
||||
|
||||
type TestResult = Awaited<ReturnType<GvrApi['testBotToken']>>;
|
||||
|
||||
@@ -12,15 +12,24 @@ export const VOICES = [
|
||||
{ value: 'ko-KR-HyunsuMultilingualNeural', label: '현수 · 남성 2' },
|
||||
];
|
||||
|
||||
/** 봇 토큰 입력 + 연결 테스트 (+ 저장). 마법사에서는 테스트 성공 시 바로 저장한다. */
|
||||
/** 봇 선택(겜녹이 기본 봇 / 다른 봇) + 연결 테스트. 다른 봇은 토큰 입력 · 저장. 마법사에서는 테스트 성공 시 바로 저장한다. */
|
||||
export function BotTokenSection({ wizard, onResult }: { wizard?: boolean; onResult?: (r: TestResult) => void }) {
|
||||
const { state, toast } = useApp();
|
||||
const { state, settings, save, toast } = useApp();
|
||||
const admin = useIsAdmin();
|
||||
const mode = settings.discord.botMode;
|
||||
const custom = mode === 'custom';
|
||||
const [token, setToken] = useState('');
|
||||
const [show, setShow] = useState(false);
|
||||
const [result, setResult] = useState<TestResult | null>(null);
|
||||
const test = useAction();
|
||||
const [testing, setTesting] = useState(false);
|
||||
const [testError, setTestError] = useState<string | null>(null);
|
||||
const saver = useAction();
|
||||
|
||||
const report = (r: TestResult) => {
|
||||
setResult(r);
|
||||
onResult?.(r);
|
||||
};
|
||||
|
||||
const saveToken = async (t: string) => {
|
||||
const r = await saver.run(async () => {
|
||||
await gvr.setSecret('botToken', t);
|
||||
@@ -32,52 +41,137 @@ export function BotTokenSection({ wizard, onResult }: { wizard?: boolean; onResu
|
||||
}
|
||||
};
|
||||
|
||||
// 연결 테스트 요청 번호. 봇을 바꾸거나 새 테스트를 시작하면 올라가고, 늦게 온 이전 응답(결과 · 오류 · 진행 표시)은 버린다
|
||||
const testSeq = useRef(0);
|
||||
const cancelTest = () => {
|
||||
testSeq.current++;
|
||||
setTesting(false);
|
||||
setTestError(null);
|
||||
};
|
||||
const testBot = async (t?: string): Promise<TestResult | undefined> => {
|
||||
const id = ++testSeq.current;
|
||||
setTesting(true);
|
||||
setTestError(null);
|
||||
try {
|
||||
const r = await gvr.testBotToken(t);
|
||||
if (id !== testSeq.current) return undefined;
|
||||
if (!r.ok) setTestError(r.error ?? '실패했습니다');
|
||||
return r;
|
||||
} catch (e) {
|
||||
if (id === testSeq.current) setTestError(errMsg(e));
|
||||
return undefined;
|
||||
} finally {
|
||||
if (id === testSeq.current) setTesting(false);
|
||||
}
|
||||
};
|
||||
|
||||
const runTest = async () => {
|
||||
const t = token.trim();
|
||||
const r = await test.run(() => gvr.testBotToken(t || undefined));
|
||||
const t = custom ? token.trim() : '';
|
||||
const r = await testBot(t || undefined);
|
||||
if (!r) return;
|
||||
setResult(r);
|
||||
onResult?.(r);
|
||||
report(r);
|
||||
if (r.ok && wizard && t) await saveToken(t);
|
||||
};
|
||||
|
||||
// 봇 바꾸기: 모드를 저장하고 봇을 새 토큰으로 다시 띄운다 (다른 봇인데 토큰이 아직 없으면 봇은 꺼진 채로 둔다)
|
||||
const switchMode = async (m: 'builtin' | 'custom') => {
|
||||
if (m === mode || saver.busy) return;
|
||||
cancelTest();
|
||||
setResult(null);
|
||||
setToken('');
|
||||
onResult?.({ ok: false });
|
||||
const r = await saver.run(async () => {
|
||||
await save({ discord: { botMode: m } });
|
||||
const res = await gvr.restartBot();
|
||||
// 다른 봇인데 토큰을 아직 안 넣었으면 봇이 꺼진 채인 게 정상이다 (오류로 보이지 않게)
|
||||
return m === 'custom' && !state.secrets.botToken ? { ok: true as const } : res;
|
||||
});
|
||||
if (m === 'builtin') {
|
||||
if (r?.ok) toast('겜녹이 봇으로 연결');
|
||||
const t = await testBot();
|
||||
if (t) report(t);
|
||||
} else if (state.secrets.botToken) {
|
||||
if (r?.ok) toast('저장된 다른 봇으로 연결');
|
||||
}
|
||||
};
|
||||
|
||||
// 마법사에서 겜녹이 봇이면 들어오자마자 연결을 확인해 서버 목록을 채운다
|
||||
const autoTested = useRef(false);
|
||||
useEffect(() => {
|
||||
if (!wizard || custom || !state.builtinBot || autoTested.current) return;
|
||||
autoTested.current = true;
|
||||
void runTest();
|
||||
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||
}, [wizard, custom, state.builtinBot]);
|
||||
|
||||
const bot = state.bot;
|
||||
const inviteId = result?.ok ? result.bot?.id : bot.user?.id;
|
||||
return (
|
||||
<Section title="봇 연결">
|
||||
<div className="lab">봇 토큰 (암호화 저장)</div>
|
||||
<div className="field">
|
||||
<input
|
||||
className="input mono"
|
||||
type={show ? 'text' : 'password'}
|
||||
value={token}
|
||||
spellCheck={false}
|
||||
autoComplete="off"
|
||||
placeholder={state.secrets.botToken ? '저장된 토큰 사용 중 · 바꾸려면 새 토큰 입력' : 'Discord Developer Portal → Bot → Reset Token 으로 받은 토큰'}
|
||||
onChange={(e) => {
|
||||
setToken(e.target.value);
|
||||
setResult(null);
|
||||
}}
|
||||
onKeyDown={(e) => e.key === 'Enter' && void runTest()}
|
||||
/>
|
||||
<button type="button" className="btn icon" title={show ? '가리기' : '보기'} onClick={() => setShow(!show)}>
|
||||
{show ? '🙈' : '👁'}
|
||||
<div className="radio">
|
||||
<button type="button" className={!custom ? 'on' : ''} disabled={saver.busy || (!admin && custom)} onClick={() => switchMode('builtin')}>
|
||||
<b>🤖 겜녹이 봇으로 진행 {!custom && '✓'}</b>
|
||||
<span className="muted">{state.builtinBot ? '기본값 · 사이트 서버를 거쳐 바로 연결' : '로그인해야 쓸 수 있습니다'}</span>
|
||||
</button>
|
||||
<button type="button" className={custom ? 'on' : ''} disabled={saver.busy || !admin} onClick={() => switchMode('custom')} title={admin ? undefined : '관리자만 바꿀 수 있습니다'}>
|
||||
<b>🔑 다른 봇으로 진행하기 {custom && '✓'}</b>
|
||||
<span className="muted">{admin ? '직접 만든 봇의 토큰을 넣어서 사용' : '🔒 관리자만 바꿀 수 있습니다'}</span>
|
||||
</button>
|
||||
{!wizard && token.trim() && (
|
||||
<Btn onClick={() => saveToken(token.trim())} busy={saver.busy}>
|
||||
저장
|
||||
</Btn>
|
||||
)}
|
||||
<Btn primary onClick={runTest} busy={test.busy} disabled={!token.trim() && !state.secrets.botToken}>
|
||||
연결 테스트
|
||||
</Btn>
|
||||
</div>
|
||||
{custom && admin && (
|
||||
<>
|
||||
<div className="lab">봇 토큰 (암호화 저장)</div>
|
||||
<div className="field">
|
||||
<input
|
||||
className="input mono"
|
||||
type={show ? 'text' : 'password'}
|
||||
value={token}
|
||||
spellCheck={false}
|
||||
autoComplete="off"
|
||||
placeholder={state.secrets.botToken ? '저장된 토큰 사용 중 · 바꾸려면 새 토큰 입력' : 'Discord Developer Portal → Bot → Reset Token 으로 받은 토큰'}
|
||||
onChange={(e) => {
|
||||
setToken(e.target.value);
|
||||
setResult(null);
|
||||
}}
|
||||
onKeyDown={(e) => e.key === 'Enter' && void runTest()}
|
||||
/>
|
||||
<button type="button" className="btn icon" title={show ? '가리기' : '보기'} onClick={() => setShow(!show)}>
|
||||
{show ? '🙈' : '👁'}
|
||||
</button>
|
||||
{!wizard && token.trim() && (
|
||||
<Btn onClick={() => saveToken(token.trim())} busy={saver.busy}>
|
||||
저장
|
||||
</Btn>
|
||||
)}
|
||||
<Btn primary onClick={runTest} busy={testing} disabled={!token.trim() && !state.secrets.botToken}>
|
||||
연결 테스트
|
||||
</Btn>
|
||||
</div>
|
||||
</>
|
||||
)}
|
||||
{!custom && (
|
||||
<div className="field">
|
||||
<Btn primary onClick={runTest} busy={testing || saver.busy} disabled={!state.builtinBot}>
|
||||
연결 확인
|
||||
</Btn>
|
||||
{inviteId && (
|
||||
<a
|
||||
href="#"
|
||||
className="small"
|
||||
onClick={(e) => (e.preventDefault(), void gvr.openExternal(`https://discord.com/oauth2/authorize?client_id=${inviteId}&scope=bot%20applications.commands&permissions=3148800`))}
|
||||
>
|
||||
내 서버에 겜녹이 초대 ↗
|
||||
</a>
|
||||
)}
|
||||
</div>
|
||||
)}
|
||||
<div className="result">
|
||||
{test.error || saver.error ? (
|
||||
<Err>{test.error || saver.error}</Err>
|
||||
{testError || saver.error ? (
|
||||
<Err>{testError || saver.error}</Err>
|
||||
) : result ? (
|
||||
result.ok ? (
|
||||
<Ok>
|
||||
연결 성공 · {result.bot?.name} · 서버 {result.guilds?.length ?? 0}곳{token.trim() && !wizard ? ' · 저장을 눌러야 적용됩니다' : ''}
|
||||
연결 성공 · {result.bot?.name} · 서버 {result.guilds?.length ?? 0}곳{custom && token.trim() && !wizard ? ' · 저장을 눌러야 적용됩니다' : ''}
|
||||
</Ok>
|
||||
) : (
|
||||
<Err>{result.error ?? '연결 실패'}</Err>
|
||||
@@ -91,7 +185,7 @@ export function BotTokenSection({ wizard, onResult }: { wizard?: boolean; onResu
|
||||
) : bot.status === 'error' ? (
|
||||
<Err>{bot.error ?? '봇 연결 오류'}</Err>
|
||||
) : (
|
||||
<div className="muted">봇이 연결되지 않았습니다. 토큰을 넣고 연결 테스트를 눌러 주세요.</div>
|
||||
<div className="muted">{custom ? '봇이 연결되지 않았습니다. 토큰을 넣고 연결 테스트를 눌러 주세요.' : '봇이 연결되지 않았습니다. 연결 확인을 눌러 주세요.'}</div>
|
||||
)}
|
||||
</div>
|
||||
</Section>
|
||||
@@ -221,12 +315,16 @@ export function DiscordTab() {
|
||||
</div>
|
||||
</Section>
|
||||
<Section title="녹음 안내 (TTS 음성) · 개인정보">
|
||||
<ToggleLine label="봇이 음성채널에 들어가면 TTS로 녹음 사실 안내" on={d.ttsEnabled} onChange={(v) => save({ discord: { ttsEnabled: v } })} />
|
||||
<ToggleLine label="새 사람이 들어오면 다시 안내" on={d.ttsOnNewMember} disabled={!d.ttsEnabled} onChange={(v) => save({ discord: { ttsOnNewMember: v } })} />
|
||||
<Line label="안내 문구">
|
||||
<div className="tts-text">
|
||||
<DraftInput multiline value={d.ttsText} onCommit={(v) => save({ discord: { ttsText: v } })} />
|
||||
</div>
|
||||
<AdminOnly note="녹음 안내를 끄거나 문구를 바꾸는 것은 관리자만 할 수 있습니다">
|
||||
<ToggleLine label="봇이 음성채널에 들어가면 TTS로 녹음 사실 안내" on={d.ttsEnabled} onChange={(v) => save({ discord: { ttsEnabled: v } })} />
|
||||
<ToggleLine label="새 사람이 들어오면 다시 안내" on={d.ttsOnNewMember} disabled={!d.ttsEnabled} onChange={(v) => save({ discord: { ttsOnNewMember: v } })} />
|
||||
<Line label="안내 문구">
|
||||
<div className="tts-text">
|
||||
<DraftInput multiline value={d.ttsText} onCommit={(v) => save({ discord: { ttsText: v } })} />
|
||||
</div>
|
||||
</Line>
|
||||
</AdminOnly>
|
||||
<Line label="안내 미리듣기">
|
||||
<TtsPreview />
|
||||
</Line>
|
||||
<Line label="목소리">
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
import { ROLE_LABEL } from '../../core/roles';
|
||||
import icon from '../assets/icon.png';
|
||||
import { gvr, useAction, useApp, useLoad } from '../store';
|
||||
import { Btn, Err, Line, Page, Section, Spinner, Toggle, ToggleLine } from '../ui';
|
||||
import { Avatar, Btn, Err, Line, Page, Section, Spinner, Toggle, ToggleLine } from '../ui';
|
||||
|
||||
const SITE = 'https://gvr.tkrmagid.kr';
|
||||
|
||||
@@ -8,8 +9,33 @@ export function GeneralTab() {
|
||||
const { state, settings, save, confirm, toast } = useApp();
|
||||
const logs = useLoad(() => gvr.recentLogs());
|
||||
const auto = useAction();
|
||||
const acc = state.account;
|
||||
return (
|
||||
<Page title="일반">
|
||||
<Section title="계정">
|
||||
<div className="row gap">
|
||||
{acc.user && <Avatar name={acc.user.name} src={acc.user.avatar} size={32} />}
|
||||
<div className="grow">
|
||||
<div>
|
||||
{acc.user?.name ?? '-'} {acc.role && <span className={`role ${acc.role}`}>{ROLE_LABEL[acc.role]}</span>}
|
||||
</div>
|
||||
<div className="mono dim small">
|
||||
{acc.user?.id}
|
||||
{acc.offline && <span className="t-warn"> · 사이트 서버에 연결되지 않아 마지막 확인 결과로 사용 중</span>}
|
||||
</div>
|
||||
</div>
|
||||
<Btn
|
||||
onClick={async () => {
|
||||
if (await confirm('로그아웃할까요? 봇 · 녹음 · 사이트 연결이 멈추고, 다시 로그인해야 쓸 수 있습니다.', { ok: '로그아웃', danger: true })) await gvr.authLogout();
|
||||
}}
|
||||
>
|
||||
로그아웃
|
||||
</Btn>
|
||||
</div>
|
||||
<div className="hint" style={{ marginTop: 8 }}>
|
||||
디스코드 계정으로 로그인했습니다. 10분마다 등록 여부를 다시 확인하며, 등록이 해제되면 바로 잠깁니다. 사이트 서버에 연결되지 않으면 마지막 확인 뒤 3일까지는 그대로 쓸 수 있습니다.
|
||||
</div>
|
||||
</Section>
|
||||
<Section title="실행">
|
||||
<Line label="윈도우 시작 시 자동 실행" hint="사이트를 계속 열어 두려면 권장">
|
||||
<Toggle
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
import { useState } from 'react';
|
||||
import { gvr, useAction, useApp, useLoad } from '../store';
|
||||
import { Btn, DraftInput, Err, FolderRow, Line, NumInput, Ok, Page, Section, Spinner } from '../ui';
|
||||
import { AdminOnly, Btn, DraftInput, Err, FolderRow, Line, NumInput, Ok, Page, Section, Spinner, useIsAdmin } from '../ui';
|
||||
import { fmtBytes, fmtDate } from '../util';
|
||||
|
||||
/** 녹음 폴더 + 보관 기간 (마법사에서도 사용) */
|
||||
@@ -19,20 +19,24 @@ export function AudioStorage() {
|
||||
}}
|
||||
onReset={() => save({ storage: { audioDir: null } })}
|
||||
/>
|
||||
<Line label="음성 보관 기간" hint="지나면 음성 파일만 삭제, 텍스트 · 경기 기록은 보관">
|
||||
<NumInput value={st.retentionDays} min={1} max={365} width={70} suffix="일" onCommit={(n) => save({ storage: { retentionDays: Math.round(n) } })} />
|
||||
</Line>
|
||||
<AdminOnly note="음성 보관 기간은 관리자만 바꿀 수 있습니다">
|
||||
<Line label="음성 보관 기간" hint="지나면 음성 파일만 삭제, 텍스트 · 경기 기록은 보관">
|
||||
<NumInput value={st.retentionDays} min={1} max={365} width={70} suffix="일" onCommit={(n) => save({ storage: { retentionDays: Math.round(n) } })} />
|
||||
</Line>
|
||||
</AdminOnly>
|
||||
</>
|
||||
);
|
||||
}
|
||||
|
||||
/** 사이트 등록 코드 입력 (마법사에서도 사용) */
|
||||
export function RegisterDevice() {
|
||||
export function RegisterDevice({ quiet }: { quiet?: boolean }) {
|
||||
const { state, settings, toast } = useApp();
|
||||
const [code, setCode] = useState('');
|
||||
const act = useAction();
|
||||
const admin = useIsAdmin();
|
||||
const registered = !!settings.site.deviceId && state.secrets.deviceKey;
|
||||
if (registered) return null;
|
||||
if (!admin) return quiet ? null : <div className="lock-note">🔒 사이트 등록은 관리자만 할 수 있습니다. 필요하면 관리자에게 요청해 주세요.</div>;
|
||||
return (
|
||||
<>
|
||||
<div className="field">
|
||||
@@ -127,6 +131,7 @@ function Usage() {
|
||||
|
||||
export function StorageTab() {
|
||||
const { state, settings, save, confirm, toast } = useApp();
|
||||
const admin = useIsAdmin();
|
||||
const site = settings.site;
|
||||
const relay = state.relay;
|
||||
const registered = !!site.deviceId && state.secrets.deviceKey;
|
||||
@@ -141,18 +146,20 @@ export function StorageTab() {
|
||||
</Section>
|
||||
<Usage />
|
||||
<Section title="사이트 서버" sub="이 PC가 사이트로 연결을 열어 둡니다 (포트 개방 불필요)">
|
||||
<Line label="서버 주소">
|
||||
<DraftInput mono value={site.serverUrl} onCommit={(v) => save({ site: { serverUrl: v.trim() } })} className="w320" />
|
||||
</Line>
|
||||
<Line label="이 PC 이름" hint="사이트에 보이는 이름">
|
||||
<DraftInput value={site.deviceName} onCommit={(v) => save({ site: { deviceName: v.trim() || 'GAME-PC' } })} className="w320" />
|
||||
</Line>
|
||||
<AdminOnly note="사이트 서버 설정은 관리자만 바꿀 수 있습니다">
|
||||
<Line label="서버 주소">
|
||||
<DraftInput mono value={site.serverUrl} onCommit={(v) => save({ site: { serverUrl: v.trim() } })} className="w320" />
|
||||
</Line>
|
||||
<Line label="이 PC 이름" hint="사이트에 보이는 이름">
|
||||
<DraftInput value={site.deviceName} onCommit={(v) => save({ site: { deviceName: v.trim() || 'GAME-PC' } })} className="w320" />
|
||||
</Line>
|
||||
</AdminOnly>
|
||||
<div className={`relay ${relay.state}`}>
|
||||
<span className={`dot ${relay.state === 'online' ? 'ok' : relay.state === 'connecting' ? 'warn' : relay.state === 'error' ? 'err' : 'off'}`} />
|
||||
<b>{relayText}</b>
|
||||
{registered && <span className="muted mono small">기기 ID {site.deviceId}</span>}
|
||||
<span className="grow" />
|
||||
{registered && (
|
||||
{registered && admin && (
|
||||
<Btn
|
||||
small
|
||||
busy={unreg.busy}
|
||||
@@ -165,22 +172,24 @@ export function StorageTab() {
|
||||
</Btn>
|
||||
)}
|
||||
</div>
|
||||
<RegisterDevice />
|
||||
<RegisterDevice quiet />
|
||||
<Err>{unreg.error}</Err>
|
||||
</Section>
|
||||
<Section title="학습 데이터">
|
||||
<Line label="학습 데이터 전체 삭제" hint="교정한 문장의 음성 조각과 합성 음성을 지웁니다. 대화 기록과 모델은 남습니다">
|
||||
<Btn
|
||||
danger
|
||||
busy={clear.busy}
|
||||
onClick={async () => {
|
||||
if (!(await confirm('학습 데이터를 모두 지울까요? 되돌릴 수 없습니다.', { ok: '전체 삭제', danger: true }))) return;
|
||||
if (await clear.runOk(() => gvr.clearTrainingData())) toast('학습 데이터 삭제됨');
|
||||
}}
|
||||
>
|
||||
전체 삭제
|
||||
</Btn>
|
||||
</Line>
|
||||
<AdminOnly>
|
||||
<Line label="학습 데이터 전체 삭제" hint="교정한 문장의 음성 조각과 합성 음성을 지웁니다. 대화 기록과 모델은 남습니다">
|
||||
<Btn
|
||||
danger
|
||||
busy={clear.busy}
|
||||
onClick={async () => {
|
||||
if (!(await confirm('학습 데이터를 모두 지울까요? 되돌릴 수 없습니다.', { ok: '전체 삭제', danger: true }))) return;
|
||||
if (await clear.runOk(() => gvr.clearTrainingData())) toast('학습 데이터 삭제됨');
|
||||
}}
|
||||
>
|
||||
전체 삭제
|
||||
</Btn>
|
||||
</Line>
|
||||
</AdminOnly>
|
||||
<Err>{clear.error}</Err>
|
||||
</Section>
|
||||
</Page>
|
||||
|
||||
@@ -3,7 +3,7 @@ import type { FinetuneStatus } from '../../main/api-types';
|
||||
import { CARD_MODELS, COMPUTE_TYPES } from '../models-meta';
|
||||
import { DownloadRow, GpuCard, ModelCard, useSttData, type ModelRole } from '../stt-parts';
|
||||
import { gvr, useAction, useApp } from '../store';
|
||||
import { Bar, Btn, Err, FolderRow, Line, NumInput, Page, Section, Select, Spinner, ToggleLine } from '../ui';
|
||||
import { AdminOnly, Bar, Btn, Err, FolderRow, Line, NumInput, Page, Section, Select, Spinner, ToggleLine } from '../ui';
|
||||
import { fmtDate, fmtMb } from '../util';
|
||||
|
||||
const SLOT_TEXT: Record<string, string> = { empty: '대기', loading: '불러오는 중', loaded: '사용 중', missing: '파일 없음', error: '오류' };
|
||||
@@ -77,38 +77,40 @@ function Finetune() {
|
||||
<Bar pct={st.step !== null && st.total ? (st.step / st.total) * 100 : 5} color="linear-gradient(90deg,#14c1b7,#5fe0d8)" />
|
||||
</div>
|
||||
)}
|
||||
<div className="row wrap gap">
|
||||
{!st.toolsInstalled && (
|
||||
<Btn primary busy={st.installing} onClick={() => call(() => gvr.finetuneInstall(), '학습 도구 설치 시작')}>
|
||||
학습 도구 설치 (약 3GB)
|
||||
<AdminOnly note="파인튜닝은 관리자만 할 수 있습니다">
|
||||
<div className="row wrap gap">
|
||||
{!st.toolsInstalled && (
|
||||
<Btn primary busy={st.installing} onClick={() => call(() => gvr.finetuneInstall(), '학습 도구 설치 시작')}>
|
||||
학습 도구 설치 (약 3GB)
|
||||
</Btn>
|
||||
)}
|
||||
<Btn primary={st.toolsInstalled} disabled={!st.toolsInstalled || st.running} onClick={() => call(() => gvr.finetuneStart(), '학습 시작')}>
|
||||
지금 학습
|
||||
</Btn>
|
||||
)}
|
||||
<Btn primary={st.toolsInstalled} disabled={!st.toolsInstalled || st.running} onClick={() => call(() => gvr.finetuneStart(), '학습 시작')}>
|
||||
지금 학습
|
||||
</Btn>
|
||||
<Btn disabled={!st.running} onClick={() => call(() => gvr.finetuneStop(), '학습 중지')}>
|
||||
중지
|
||||
</Btn>
|
||||
<Btn
|
||||
disabled={!st.previousModel || st.running}
|
||||
onClick={async () => {
|
||||
if (await confirm(`이전 모델(${st.previousModel})로 되돌릴까요?`, { ok: '되돌리기' })) await call(() => gvr.finetuneRollback(), '이전 모델로 되돌림');
|
||||
}}
|
||||
>
|
||||
이전 모델로 되돌리기
|
||||
</Btn>
|
||||
<span className="grow" />
|
||||
<span className="muted small">자동 학습</span>
|
||||
<Select
|
||||
width={190}
|
||||
value={settings.finetune.schedule}
|
||||
options={[
|
||||
{ value: 'off', label: '끔' },
|
||||
{ value: 'nightly', label: '매일 새벽 자동' },
|
||||
]}
|
||||
onChange={(v) => save({ finetune: { schedule: v } })}
|
||||
/>
|
||||
</div>
|
||||
<Btn disabled={!st.running} onClick={() => call(() => gvr.finetuneStop(), '학습 중지')}>
|
||||
중지
|
||||
</Btn>
|
||||
<Btn
|
||||
disabled={!st.previousModel || st.running}
|
||||
onClick={async () => {
|
||||
if (await confirm(`이전 모델(${st.previousModel})로 되돌릴까요?`, { ok: '되돌리기' })) await call(() => gvr.finetuneRollback(), '이전 모델로 되돌림');
|
||||
}}
|
||||
>
|
||||
이전 모델로 되돌리기
|
||||
</Btn>
|
||||
<span className="grow" />
|
||||
<span className="muted small">자동 학습</span>
|
||||
<Select
|
||||
width={190}
|
||||
value={settings.finetune.schedule}
|
||||
options={[
|
||||
{ value: 'off', label: '끔' },
|
||||
{ value: 'nightly', label: '매일 새벽 자동' },
|
||||
]}
|
||||
onChange={(v) => save({ finetune: { schedule: v } })}
|
||||
/>
|
||||
</div>
|
||||
</AdminOnly>
|
||||
<Err>{act.error}</Err>
|
||||
<div className="hint" style={{ marginTop: 8 }}>
|
||||
게임이 켜지면 학습을 바로 멈춥니다. 학습 전후 같은 검증 문장의 오류율(CER)이 좋아졌을 때만 새 모델로 바꿉니다.
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
// 공용 UI 조각
|
||||
import { useState, type ReactNode } from 'react';
|
||||
import { useDraft } from './store';
|
||||
import { isAdminRole } from '../core/roles';
|
||||
import { useApp, useDraft } from './store';
|
||||
import { errMsg } from './util';
|
||||
|
||||
export function Page({ title, desc, children }: { title: string; desc?: ReactNode; children: ReactNode }) {
|
||||
@@ -226,3 +227,20 @@ export function FolderRow({ path, placeholder, onChoose, onReset }: { path: stri
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
/** 로그인한 계정이 관리자(최고 관리자 포함)인지 */
|
||||
export function useIsAdmin(): boolean {
|
||||
return isAdminRole(useApp().state.account.role);
|
||||
}
|
||||
|
||||
/** 관리자 전용 설정: 일반 유저에게는 잠근 채로 보여 준다 (실제 차단은 메인 프로세스가 한다) */
|
||||
export function AdminOnly({ children, note = '관리자만 바꿀 수 있습니다' }: { children: ReactNode; note?: ReactNode }) {
|
||||
const admin = useIsAdmin();
|
||||
if (admin) return <>{children}</>;
|
||||
return (
|
||||
<fieldset className="admin-lock" disabled>
|
||||
{note && <div className="lock-note">🔒 {note}</div>}
|
||||
<div className="locked">{children}</div>
|
||||
</fieldset>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -13,8 +13,19 @@ export function deepMerge<T>(base: T, over: unknown): T {
|
||||
}
|
||||
|
||||
export function errMsg(e: unknown): string {
|
||||
if (e instanceof Error) return e.message;
|
||||
return String(e);
|
||||
const m = e instanceof Error ? e.message : String(e);
|
||||
// IPC 오류는 "Error invoking remote method 'gvr:x': Error: 메시지" 로 온다
|
||||
return m.replace(/^Error invoking remote method '[^']+': (?:\w*Error: )?/, '');
|
||||
}
|
||||
|
||||
/** "3분 전" · "2시간 전" · "4일 전" */
|
||||
export function fmtAgo(ts: number | null | undefined): string {
|
||||
if (!ts) return '-';
|
||||
const s = Math.max(0, (Date.now() - ts) / 1000);
|
||||
if (s < 60) return '방금';
|
||||
if (s < 3600) return `${Math.floor(s / 60)}분 전`;
|
||||
if (s < 86400) return `${Math.floor(s / 3600)}시간 전`;
|
||||
return `${Math.floor(s / 86400)}일 전`;
|
||||
}
|
||||
|
||||
/** MB → "1.6GB" / "464MB" */
|
||||
|
||||
@@ -30,12 +30,16 @@ function Step1({ onTested }: { onTested: (ok: boolean) => void }) {
|
||||
<Head
|
||||
title="디스코드 봇 연결"
|
||||
desc={
|
||||
<>
|
||||
Discord Developer Portal에서 만든 봇의 토큰을 넣어 주세요. 봇에는 음성 연결 · 슬래시 명령 권한과 Server Members Intent가 필요합니다.{' '}
|
||||
<a href="#" onClick={(e) => (e.preventDefault(), void gvr.openExternal('https://discord.com/developers/applications'))}>
|
||||
포털 열기 ↗
|
||||
</a>
|
||||
</>
|
||||
settings.discord.botMode === 'builtin' ? (
|
||||
<>기본으로 겜녹이 봇을 씁니다. 토큰을 넣을 필요 없이 바로 연결됩니다. 직접 만든 봇을 쓰려면 '다른 봇으로 진행하기'를 골라 주세요.</>
|
||||
) : (
|
||||
<>
|
||||
Discord Developer Portal에서 만든 봇의 토큰을 넣어 주세요. 봇에는 음성 연결 · 슬래시 명령 권한과 Server Members Intent가 필요합니다.{' '}
|
||||
<a href="#" onClick={(e) => (e.preventDefault(), void gvr.openExternal('https://discord.com/developers/applications'))}>
|
||||
포털 열기 ↗
|
||||
</a>
|
||||
</>
|
||||
)
|
||||
}
|
||||
/>
|
||||
<BotTokenSection
|
||||
@@ -209,10 +213,11 @@ function Step5() {
|
||||
}
|
||||
|
||||
export function Wizard({ step }: { step: number }) {
|
||||
const { state } = useApp();
|
||||
const { state, settings } = useApp();
|
||||
const [tokenOk, setTokenOk] = useState(false);
|
||||
const finish = useAction();
|
||||
const canNext1 = tokenOk || (state.secrets.botToken && state.bot.status === 'ready');
|
||||
const hasToken = settings.discord.botMode === 'builtin' ? state.builtinBot : state.secrets.botToken;
|
||||
const canNext1 = tokenOk || (hasToken && state.bot.status === 'ready');
|
||||
const to = (n: number) => go(`#/wizard/${n}`);
|
||||
|
||||
return (
|
||||
|
||||
255
app/test/auth.test.ts
Normal file
@@ -0,0 +1,255 @@
|
||||
// 앱 로그인(core/auth.ts) ↔ 실제 사이트 서버 코드(site/server) 통합 테스트. 디스코드만 가짜.
|
||||
import { test } from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import fs from 'node:fs';
|
||||
import http from 'node:http';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import { buildServer } from '../../site/server/src/app.ts';
|
||||
import { AppAuth } from '../src/core/auth.ts';
|
||||
import { adminOnlyPaths } from '../src/core/roles.ts';
|
||||
import { SettingsStore } from '../src/core/settings.ts';
|
||||
|
||||
const SUPER = '1352267557213573160';
|
||||
const FRIEND = '111111111111111111';
|
||||
const STRANGER = '222222222222222222';
|
||||
const BOT = 'MTExMTExMTExMTExMTExMTEx.FAKE00.server-delivered-token-xxxxxxxx';
|
||||
const tmp = () => fs.mkdtempSync(path.join(process.env.TMPDIR || os.tmpdir(), 'gvr-auth-'));
|
||||
delete process.env.GVR_BOT_TOKEN;
|
||||
|
||||
async function fakeDiscord() {
|
||||
const names: Record<string, string> = { [SUPER]: '관리자', [FRIEND]: '친구', [STRANGER]: '모르는사람' };
|
||||
const srv = http.createServer((req, res) => {
|
||||
const u = new URL(req.url!, 'http://x');
|
||||
res.setHeader('content-type', 'application/json');
|
||||
if (u.pathname === '/oauth2/token') {
|
||||
let b = '';
|
||||
req.on('data', (c) => (b += c));
|
||||
req.on('end', () => res.end(JSON.stringify({ access_token: new URLSearchParams(b).get('code') })));
|
||||
return;
|
||||
}
|
||||
if (u.pathname === '/users/@me') {
|
||||
const id = String(req.headers.authorization).replace('Bearer ', '');
|
||||
return res.end(JSON.stringify({ id, username: names[id], global_name: names[id], avatar: null }));
|
||||
}
|
||||
const m = /^\/users\/(\d+)$/.exec(u.pathname);
|
||||
if (m && names[m[1]!]) return res.end(JSON.stringify({ id: m[1], username: names[m[1]!], global_name: names[m[1]!], avatar: null }));
|
||||
res.statusCode = 404;
|
||||
res.end('{}');
|
||||
});
|
||||
await new Promise<void>((r) => srv.listen(0, '127.0.0.1', () => r()));
|
||||
return { url: `http://127.0.0.1:${(srv.address() as any).port}`, close: () => srv.close() };
|
||||
}
|
||||
|
||||
async function stack() {
|
||||
const dc = await fakeDiscord();
|
||||
const { app } = await buildServer({
|
||||
port: 0, host: '127.0.0.1', publicUrl: 'http://placeholder', clientId: 'cid', clientSecret: 's', botToken: BOT,
|
||||
allowedGuilds: [], owners: [SUPER], superAdmins: [SUPER], sessionSecret: 'x'.repeat(32), dataDir: tmp(), webDir: '/nonexistent',
|
||||
version: 'test', discordApi: dc.url, assetUpstream: {},
|
||||
});
|
||||
await app.listen({ host: '127.0.0.1', port: 0 });
|
||||
const base = `http://127.0.0.1:${(app.server.address() as any).port}`;
|
||||
/** 브라우저 흉내: 로그인 주소 → 디스코드(가짜) → 콜백. who = 디스코드에서 로그인한 계정 */
|
||||
const browser = (who: string) => async (url: string) => {
|
||||
const start = await fetch(url.replace('http://placeholder', base), { redirect: 'manual' });
|
||||
const state = new URL(start.headers.get('location')!).searchParams.get('state')!;
|
||||
const cookie = start.headers.getSetCookie()[0]!.split(';')[0]!;
|
||||
await fetch(`${base}/auth/discord/callback?code=${who}&state=${encodeURIComponent(state)}`, { headers: { cookie }, redirect: 'manual' });
|
||||
};
|
||||
const settingsFor = (dir = tmp()) => {
|
||||
const s = new SettingsStore(dir);
|
||||
s.update({ site: { serverUrl: base } });
|
||||
return s;
|
||||
};
|
||||
return { base, browser, settingsFor, close: async () => (await app.close(), dc.close()) };
|
||||
}
|
||||
|
||||
test('앱 로그인: 등록된 아이디만 열리고, 겜녹이 봇 토큰은 로그인해도 앱에 오지 않는다', async () => {
|
||||
const s = await stack();
|
||||
try {
|
||||
// 로그인 전: 토큰 없음 → 로그인 화면
|
||||
const st = s.settingsFor();
|
||||
const auth = new AppAuth(st, { version: '1.2.0', openUrl: s.browser(STRANGER), pollMs: 20 });
|
||||
assert.equal((await auth.check()).status, 'signed_out');
|
||||
assert.equal(st.activeBotToken(), null);
|
||||
|
||||
// 미등록 아이디 → 등록되지 않은 아이디, 토큰 없음
|
||||
const r1 = await auth.login();
|
||||
assert.equal(r1.status, 'not_registered');
|
||||
assert.equal(r1.user?.id, STRANGER);
|
||||
assert.equal(st.hasSecret('appToken'), false);
|
||||
assert.equal(st.activeBotToken(), null);
|
||||
|
||||
// 최고 관리자 로그인 → 앱 토큰만 받는다. 봇 토큰은 서버 응답 어디에도 없다
|
||||
const adminSt = s.settingsFor();
|
||||
const admin = new AppAuth(adminSt, { version: '1.2.0', openUrl: s.browser(SUPER), pollMs: 20 });
|
||||
const r2 = await admin.login();
|
||||
assert.equal(r2.status, 'ok');
|
||||
assert.equal(r2.role, 'superadmin');
|
||||
assert.equal(adminSt.hasBuiltinBot, true);
|
||||
assert.equal(adminSt.activeBotToken(), null);
|
||||
const me = await (await fetch(`${s.base}/app/me`, { headers: { authorization: `Bearer ${adminSt.getSecret('appToken')}` } })).text();
|
||||
assert.ok(me.includes(SUPER) && !me.includes(BOT) && !me.includes('botToken'), me);
|
||||
|
||||
// 최고 관리자가 친구 등록 (관리자 화면 API)
|
||||
const list = await admin.adminAddUser(FRIEND, 'user');
|
||||
assert.ok(list.users.some((u) => u.id === FRIEND && u.role === 'user'));
|
||||
|
||||
// 친구 로그인 → 일반 유저
|
||||
const dir = tmp();
|
||||
const frSt = s.settingsFor(dir);
|
||||
const fr = new AppAuth(frSt, { version: '1.2.0', openUrl: s.browser(FRIEND), pollMs: 20 });
|
||||
const r3 = await fr.login();
|
||||
assert.equal(r3.status, 'ok');
|
||||
assert.equal(r3.role, 'user');
|
||||
assert.equal(frSt.activeBotToken(), null);
|
||||
await assert.rejects(fr.adminAddUser(STRANGER, 'user'), /최고 관리자만/);
|
||||
await assert.rejects(fr.adminUsers(), /관리자만/);
|
||||
// 다시 켜도 (새 SettingsStore) 로그인 유지
|
||||
assert.equal((await new AppAuth(s.settingsFor(dir), { version: '1.2.0', openUrl: () => undefined }).check()).status, 'ok');
|
||||
// 봇 토큰은 이 PC 어디에도 저장되지 않는다 (테스트는 평문 codec 이라 secrets.bin 도 그대로 읽힌다)
|
||||
for (const f of fs.readdirSync(dir)) assert.ok(!fs.readFileSync(path.join(dir, f), 'utf8').includes(BOT), f);
|
||||
|
||||
// 등록 해제 → 다음 확인에서 잠기고 앱 토큰을 지운다
|
||||
await admin.adminRemoveUser(FRIEND);
|
||||
const r4 = await fr.check();
|
||||
assert.equal(r4.status, 'not_registered');
|
||||
assert.equal(r4.user?.id, FRIEND);
|
||||
assert.equal((await fr.check()).status, 'not_registered', '다시 확인해도 "등록되지 않은 아이디" 화면 유지');
|
||||
assert.equal(frSt.activeBotToken(), null);
|
||||
assert.equal(frSt.hasSecret('appToken'), false);
|
||||
|
||||
// 로그아웃 → 토큰 삭제, 서버에서도 무효
|
||||
await admin.logout();
|
||||
assert.equal(admin.state.status, 'signed_out');
|
||||
assert.equal(adminSt.hasBuiltinBot, false);
|
||||
} finally {
|
||||
await s.close();
|
||||
}
|
||||
});
|
||||
|
||||
test('앱 로그인: 서버에 못 붙으면 마지막 확인 후 유예 기간까지만 쓴다', async () => {
|
||||
const s = await stack();
|
||||
const dir = tmp();
|
||||
const st = s.settingsFor(dir);
|
||||
const auth = new AppAuth(st, { version: '1.2.0', openUrl: s.browser(SUPER), pollMs: 20 });
|
||||
assert.equal((await auth.login()).status, 'ok');
|
||||
await s.close();
|
||||
// 서버 꺼짐 → 마지막 확인이 방금이라 오프라인으로 계속
|
||||
const r = await auth.check();
|
||||
assert.equal(r.status, 'ok');
|
||||
assert.equal(r.offline, true);
|
||||
assert.equal(st.hasSecret('appToken'), true);
|
||||
// 유예 기간이 지나면 막힌다 (토큰은 남겨 두어 서버가 돌아오면 다시 확인)
|
||||
const late = new AppAuth(st, { version: '1.2.0', openUrl: () => undefined, offlineGraceMs: 0 });
|
||||
const r2 = await late.check();
|
||||
assert.equal(r2.status, 'error');
|
||||
assert.match(r2.error!, /연결할 수 없습니다/);
|
||||
assert.equal(st.hasSecret('appToken'), true);
|
||||
});
|
||||
|
||||
test('관리자 전용 설정: 일반 유저가 바꾸면 안 되는 경로만 골라낸다', () => {
|
||||
assert.deepEqual(adminOnlyPaths({ discord: { botMode: 'custom' } }), ['discord.botMode']);
|
||||
assert.deepEqual(adminOnlyPaths({ discord: { guildId: 'g', ttsVoice: 'x' }, stt: { realtimeModel: 'small' } }), []);
|
||||
assert.deepEqual(adminOnlyPaths({ discord: { ttsEnabled: false, ttsText: 'x', ttsVoice: 'y' } }), ['discord.ttsEnabled', 'discord.ttsText']);
|
||||
assert.deepEqual(adminOnlyPaths({ storage: { retentionDays: 30, audioDir: 'D:/a' } }), ['storage.retentionDays']);
|
||||
assert.deepEqual(adminOnlyPaths({ site: { deviceName: 'x' } }), ['site']);
|
||||
assert.deepEqual(adminOnlyPaths({ finetune: { schedule: 'nightly' } }), ['finetune']);
|
||||
assert.deepEqual(adminOnlyPaths({ firstRunDone: true, general: { sfx: false } }), []);
|
||||
});
|
||||
|
||||
/** /app/me 응답을 서버가 처리한 뒤 앱에 늦게 도착하게 붙잡는다 (hold() 로 다음 요청 하나를 잡고, 반환값으로 놓아준다) */
|
||||
function holdMe() {
|
||||
const real = globalThis.fetch;
|
||||
let gate: { promise: Promise<void>; release: () => void } | null = null;
|
||||
globalThis.fetch = (async (input: any, init?: any) => {
|
||||
const r = await real(input, init);
|
||||
if (gate && String(input).endsWith('/app/me')) {
|
||||
const g = gate;
|
||||
gate = null;
|
||||
await g.promise;
|
||||
}
|
||||
return r;
|
||||
}) as typeof fetch;
|
||||
return {
|
||||
hold: () => {
|
||||
let release!: () => void;
|
||||
const promise = new Promise<void>((r) => (release = r));
|
||||
gate = { promise, release };
|
||||
return release;
|
||||
},
|
||||
restore: () => (globalThis.fetch = real),
|
||||
};
|
||||
}
|
||||
|
||||
test('늦은 확인 응답: 등록 해제로 잠긴 뒤 이전 확인의 200 이 와도 다시 열리지 않는다', async () => {
|
||||
const s = await stack();
|
||||
const h = holdMe();
|
||||
try {
|
||||
const admin = new AppAuth(s.settingsFor(), { version: 't', openUrl: s.browser(SUPER), pollMs: 20 });
|
||||
await admin.login();
|
||||
await admin.adminAddUser(FRIEND, 'user');
|
||||
const st = s.settingsFor();
|
||||
const fr = new AppAuth(st, { version: 't', openUrl: s.browser(FRIEND), pollMs: 20 });
|
||||
assert.equal((await fr.login()).status, 'ok');
|
||||
|
||||
// A: 서버는 200 을 줬지만 응답이 늦게 온다
|
||||
const release = h.hold();
|
||||
const a = fr.check();
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
// 그 사이 등록 해제 → B: 403 → 잠김
|
||||
await admin.adminRemoveUser(FRIEND);
|
||||
assert.equal((await fr.check()).status, 'not_registered');
|
||||
// A 의 늦은 200 도착
|
||||
release();
|
||||
await a;
|
||||
assert.equal(fr.state.status, 'not_registered', '늦은 200 이 잠금을 풀면 안 된다');
|
||||
assert.equal(st.hasSecret('appToken'), false, '지운 앱 토큰이 되살아나면 안 된다');
|
||||
assert.equal(st.hasSecret('auth'), false);
|
||||
} finally {
|
||||
h.restore();
|
||||
await s.close();
|
||||
}
|
||||
});
|
||||
|
||||
test('늦은 확인 응답: 로그아웃 뒤 이전 확인의 200 이 와도 다시 열리지 않는다', async () => {
|
||||
const s = await stack();
|
||||
const h = holdMe();
|
||||
try {
|
||||
const st = s.settingsFor();
|
||||
const auth = new AppAuth(st, { version: 't', openUrl: s.browser(SUPER), pollMs: 20 });
|
||||
assert.equal((await auth.login()).status, 'ok');
|
||||
const release = h.hold();
|
||||
const a = auth.check();
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
await auth.logout();
|
||||
assert.equal(auth.state.status, 'signed_out');
|
||||
release();
|
||||
await a;
|
||||
assert.equal(auth.state.status, 'signed_out', '늦은 200 이 로그아웃을 되돌리면 안 된다');
|
||||
assert.equal(st.hasSecret('appToken'), false);
|
||||
assert.equal(st.hasSecret('auth'), false);
|
||||
} finally {
|
||||
h.restore();
|
||||
await s.close();
|
||||
}
|
||||
});
|
||||
|
||||
test('겹친 확인: 등록 해제 뒤 확인 두 개가 겹쳐도 "로그인 만료"가 아니라 "등록되지 않은 아이디"로 잠긴다', async () => {
|
||||
// 봇 중계가 끊기며 바로 확인하는 사이 10분 확인 · 다시 확인 버튼이 겹치는 경우. 서버는 첫 403 에서 세션을 지워 뒤 확인은 401 을 받는다
|
||||
const s = await stack();
|
||||
try {
|
||||
const admin = new AppAuth(s.settingsFor(), { version: 't', openUrl: s.browser(SUPER), pollMs: 20 });
|
||||
await admin.login();
|
||||
await admin.adminAddUser(FRIEND, 'user');
|
||||
const fr = new AppAuth(s.settingsFor(), { version: 't', openUrl: s.browser(FRIEND), pollMs: 20 });
|
||||
assert.equal((await fr.login()).status, 'ok');
|
||||
await admin.adminRemoveUser(FRIEND);
|
||||
await Promise.all([fr.check(), fr.check()]);
|
||||
assert.equal(fr.state.status, 'not_registered');
|
||||
assert.equal(fr.state.user?.id, FRIEND);
|
||||
} finally {
|
||||
await s.close();
|
||||
}
|
||||
});
|
||||
407
app/test/bot-gateway.test.ts
Normal file
@@ -0,0 +1,407 @@
|
||||
// 겜녹이 봇 중계: 앱 RemoteGateway ↔ 실제 사이트 서버 코드(BotBroker). 디스코드 게이트웨이만 가짜(FakeSource).
|
||||
// 핵심: 봇 토큰은 서버 밖으로 나가지 않고, 앱은 지켜보는 서버의 음성 참여 · 나가기만 요청할 수 있다
|
||||
import { test } from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import { EventEmitter } from 'node:events';
|
||||
import fs from 'node:fs';
|
||||
import http from 'node:http';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import type { BotGwChannel, BotGwGuild, BotGwMember } from '@gvr/shared';
|
||||
import { buildServer } from '../../site/server/src/app.ts';
|
||||
import type { BotCommand, BotSource } from '../../site/server/src/bot-broker.ts';
|
||||
import { AppAuth } from '../src/core/auth.ts';
|
||||
import { RemoteGateway } from '../src/core/discord/gateway.ts';
|
||||
import { SettingsStore } from '../src/core/settings.ts';
|
||||
|
||||
const SUPER = '1352267557213573160';
|
||||
const FRIEND = '111111111111111111';
|
||||
const BOT = 'MTExMTExMTExMTExMTExMTEx.FAKE00.server-only-bot-token-xxxxxxxxx';
|
||||
const G = '900000000000000001';
|
||||
const OTHER_G = '900000000000000002';
|
||||
const VC1 = '910000000000000001';
|
||||
const VC2 = '910000000000000002';
|
||||
const TEXT = '910000000000000009';
|
||||
/** 최고 관리자만 볼 수 있는 비공개 음성채널 */
|
||||
const PRIV = '910000000000000003';
|
||||
/** 모두 볼 수 있지만 최고 관리자만 들어갈 수 있는 음성채널 */
|
||||
const LOCKED = '910000000000000004';
|
||||
const OTHER_VC = '920000000000000001';
|
||||
const tmp = () => fs.mkdtempSync(path.join(process.env.TMPDIR || os.tmpdir(), 'gvr-botgw-'));
|
||||
delete process.env.GVR_BOT_TOKEN;
|
||||
|
||||
const m = (id: string, name: string, bot = false): BotGwMember => ({ id, name, avatar: null, bot });
|
||||
const ME = m('800000000000000001', '겜녹이', true);
|
||||
|
||||
class FakeSource extends EventEmitter implements BotSource {
|
||||
sent: { guildId: string; payload: any }[] = [];
|
||||
handlers = new Map<string, { server: (d: any) => void; state: (d: any) => void }>();
|
||||
commands: string[] = [];
|
||||
wants?: (guildId: string) => boolean;
|
||||
me() {
|
||||
return ME;
|
||||
}
|
||||
private all: BotGwGuild[] = [
|
||||
{ id: G, name: 'M&L', icon: null },
|
||||
{ id: OTHER_G, name: '다른 서버', icon: null },
|
||||
];
|
||||
/** 서버별 멤버: 친구는 M&L 에만 가입 */
|
||||
private memberOf: Record<string, string[]> = { [G]: [SUPER, FRIEND], [OTHER_G]: [SUPER] };
|
||||
private channels: Record<string, { id: string; name: string; voice: boolean; view: string[]; connect: string[] }[]> = {
|
||||
[G]: [
|
||||
{ id: VC1, name: '일반', voice: true, view: [SUPER, FRIEND], connect: [SUPER, FRIEND] },
|
||||
{ id: VC2, name: '게임', voice: true, view: [SUPER, FRIEND], connect: [SUPER, FRIEND] },
|
||||
{ id: PRIV, name: '운영진', voice: true, view: [SUPER], connect: [SUPER] },
|
||||
{ id: LOCKED, name: '방송', voice: true, view: [SUPER, FRIEND], connect: [SUPER] },
|
||||
{ id: TEXT, name: '채팅', voice: false, view: [SUPER, FRIEND], connect: [] },
|
||||
],
|
||||
[OTHER_G]: [{ id: OTHER_VC, name: '다른 음성', voice: true, view: [SUPER], connect: [SUPER] }],
|
||||
};
|
||||
/** 지금 음성채널에 있는 사람 */
|
||||
voice: { member: BotGwMember; channelId: string; guildId: string }[] = [
|
||||
{ member: m(SUPER, '관리자'), channelId: VC1, guildId: G },
|
||||
{ member: m('300000000000000001', '운영진'), channelId: PRIV, guildId: G },
|
||||
];
|
||||
private ch(g: string, c: string) {
|
||||
return this.channels[g]?.find((x) => x.id === c);
|
||||
}
|
||||
async guildsFor(userId: string) {
|
||||
return this.all.filter((g) => this.memberOf[g.id]?.includes(userId));
|
||||
}
|
||||
async snapshot(guildId: string, userId: string) {
|
||||
const g = this.all.find((x) => x.id === guildId);
|
||||
if (!g || !this.memberOf[guildId]?.includes(userId)) return null;
|
||||
const channels: BotGwChannel[] = this.channels[guildId]!.filter((c) => c.voice && c.view.includes(userId)).map((c) => ({ id: c.id, name: c.name }));
|
||||
return { guild: g, channels, voice: this.voice.filter((v) => v.guildId === guildId && channels.some((c) => c.id === v.channelId)).map(({ member, channelId }) => ({ member, channelId })) };
|
||||
}
|
||||
canView(guildId: string, userId: string, channelId: string) {
|
||||
return !!this.ch(guildId, channelId)?.view.includes(userId);
|
||||
}
|
||||
canConnect(guildId: string, userId: string, channelId: string) {
|
||||
const c = this.ch(guildId, channelId);
|
||||
return !!c?.voice && c.view.includes(userId) && c.connect.includes(userId);
|
||||
}
|
||||
async members(guildId: string, userId: string) {
|
||||
if (!this.memberOf[guildId]?.includes(userId)) throw new Error('forbidden');
|
||||
return [m(SUPER, '관리자'), m(FRIEND, '친구'), m('700000000000000001', '음악봇', true)];
|
||||
}
|
||||
async registerCommands(guildId: string) {
|
||||
this.commands.push(guildId);
|
||||
}
|
||||
voiceAdapter(guildId: string, handlers: { server: (d: any) => void; state: (d: any) => void }) {
|
||||
this.handlers.set(guildId, handlers);
|
||||
return {
|
||||
send: (payload: any) => {
|
||||
this.sent.push({ guildId, payload });
|
||||
return true;
|
||||
},
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
async function fakeDiscord() {
|
||||
const names: Record<string, string> = { [SUPER]: '관리자', [FRIEND]: '친구' };
|
||||
const srv = http.createServer((req, res) => {
|
||||
const u = new URL(req.url!, 'http://x');
|
||||
res.setHeader('content-type', 'application/json');
|
||||
if (u.pathname === '/oauth2/token') {
|
||||
let b = '';
|
||||
req.on('data', (c) => (b += c));
|
||||
req.on('end', () => res.end(JSON.stringify({ access_token: new URLSearchParams(b).get('code') })));
|
||||
return;
|
||||
}
|
||||
if (u.pathname === '/users/@me') {
|
||||
const id = String(req.headers.authorization).replace('Bearer ', '');
|
||||
return res.end(JSON.stringify({ id, username: names[id], global_name: names[id], avatar: null }));
|
||||
}
|
||||
const mm = /^\/users\/(\d+)$/.exec(u.pathname);
|
||||
if (mm && names[mm[1]!]) return res.end(JSON.stringify({ id: mm[1], username: names[mm[1]!], global_name: names[mm[1]!], avatar: null }));
|
||||
res.statusCode = 404;
|
||||
res.end('{}');
|
||||
});
|
||||
await new Promise<void>((r) => srv.listen(0, '127.0.0.1', () => r()));
|
||||
return { url: `http://127.0.0.1:${(srv.address() as any).port}`, close: () => srv.close() };
|
||||
}
|
||||
|
||||
async function stack() {
|
||||
const dc = await fakeDiscord();
|
||||
const source = new FakeSource();
|
||||
const { app } = await buildServer(
|
||||
{
|
||||
port: 0, host: '127.0.0.1', publicUrl: 'http://placeholder', clientId: 'cid', clientSecret: 's', botToken: BOT,
|
||||
allowedGuilds: [], owners: [SUPER], superAdmins: [SUPER], sessionSecret: 'x'.repeat(32), dataDir: tmp(), webDir: '/nonexistent',
|
||||
version: 'test', discordApi: dc.url, assetUpstream: {},
|
||||
},
|
||||
{ botSource: source },
|
||||
);
|
||||
await app.listen({ host: '127.0.0.1', port: 0 });
|
||||
const base = `http://127.0.0.1:${(app.server.address() as any).port}`;
|
||||
const browser = (who: string) => async (url: string) => {
|
||||
const start = await fetch(url.replace('http://placeholder', base), { redirect: 'manual' });
|
||||
const state = new URL(start.headers.get('location')!).searchParams.get('state')!;
|
||||
const cookie = start.headers.getSetCookie()[0]!.split(';')[0]!;
|
||||
await fetch(`${base}/auth/discord/callback?code=${who}&state=${encodeURIComponent(state)}`, { headers: { cookie }, redirect: 'manual' });
|
||||
};
|
||||
/** 로그인한 앱 하나 (설정 · 로그인 · 봇 중계) */
|
||||
const pc = async (who: string) => {
|
||||
const st = new SettingsStore(tmp());
|
||||
st.update({ site: { serverUrl: base } });
|
||||
const auth = new AppAuth(st, { version: 't', openUrl: browser(who), pollMs: 20 });
|
||||
assert.equal((await auth.login()).status, 'ok');
|
||||
const gw = new RemoteGateway({ serverUrl: () => base, appToken: () => st.getSecret('appToken') ?? null, version: 't' });
|
||||
// 서버가 앱에 보낸 모든 메시지 (봇 토큰이 섞여 있지 않은지 본다)
|
||||
const seen: string[] = [];
|
||||
const orig = (gw as any).onMessage.bind(gw);
|
||||
(gw as any).onMessage = (msg: any) => (seen.push(JSON.stringify(msg)), orig(msg));
|
||||
return { st, auth, gw, seen };
|
||||
};
|
||||
return { base, source, pc, close: async () => (await app.close(), dc.close()) };
|
||||
}
|
||||
|
||||
const until = async (cond: () => boolean, ms = 3000) => {
|
||||
const end = Date.now() + ms;
|
||||
while (!cond()) {
|
||||
if (Date.now() > end) throw new Error('시간 초과');
|
||||
await new Promise((r) => setTimeout(r, 10));
|
||||
}
|
||||
};
|
||||
const op4 = (guildId: string, channelId: string | null) => ({ op: 4, d: { guild_id: guildId, channel_id: channelId, self_mute: false, self_deaf: false } });
|
||||
|
||||
test('봇 중계: 로그인 안 한 연결은 막히고, 로그인한 앱은 봇 토큰 없이 서버 정보 · 음성 상태를 받는다', async () => {
|
||||
const s = await stack();
|
||||
const a = await s.pc(SUPER);
|
||||
try {
|
||||
// 앱 토큰이 틀리면 401 → unauthorized
|
||||
const bad = new RemoteGateway({ serverUrl: () => s.base, appToken: () => 'wrong-token', version: 't' });
|
||||
await assert.rejects(bad.start(), /로그인/);
|
||||
await bad.stop();
|
||||
|
||||
await a.gw.start();
|
||||
assert.deepEqual(a.gw.me(), ME);
|
||||
assert.deepEqual(a.gw.guilds().map((g) => g.id), [G, OTHER_G]);
|
||||
const g = await a.gw.watch(G, { commands: true });
|
||||
assert.equal(g?.name, 'M&L');
|
||||
await until(() => s.source.commands.includes(G));
|
||||
assert.deepEqual(a.gw.voiceChannelOf(G, SUPER), { id: VC1, name: '일반' });
|
||||
assert.deepEqual(a.gw.channelMembers(G, VC1).map((x) => x.id), [SUPER]);
|
||||
|
||||
// 음성 상태 변화가 넘어온다
|
||||
const evs: any[] = [];
|
||||
a.gw.on('voiceState', (e) => evs.push(e));
|
||||
s.source.emit('voiceState', { guildId: G, member: m(FRIEND, '친구'), oldChannelId: null, newChannelId: VC2, channel: { id: VC2, name: '게임' } });
|
||||
s.source.emit('voiceState', { guildId: OTHER_G, member: m(FRIEND, '친구'), oldChannelId: null, newChannelId: '1', channel: null }); // 지켜보지 않는 서버
|
||||
await until(() => evs.length === 1);
|
||||
assert.deepEqual(a.gw.voiceChannelOf(G, FRIEND), { id: VC2, name: '게임' });
|
||||
|
||||
// 멤버 목록 (봇 판별)
|
||||
const ms = await a.gw.members(G);
|
||||
assert.equal(ms.length, 3);
|
||||
assert.equal(a.gw.isBot('700000000000000001'), true);
|
||||
assert.equal(a.gw.isBot(FRIEND), false);
|
||||
|
||||
assert.ok(a.seen.length > 3);
|
||||
assert.ok(!a.seen.some((x) => x.includes(BOT)), '봇 토큰이 앱으로 가면 안 된다');
|
||||
} finally {
|
||||
await a.gw.stop();
|
||||
await s.close();
|
||||
}
|
||||
});
|
||||
|
||||
test('봇 중계: 음성 참여는 서버가 대신 보내고 일회용 음성 접속 정보만 그 앱에 넘긴다', async () => {
|
||||
const s = await stack();
|
||||
const a = await s.pc(SUPER);
|
||||
try {
|
||||
await a.gw.start();
|
||||
await a.gw.watch(G, { commands: false });
|
||||
const got: any[] = [];
|
||||
const adapter = a.gw.adapterCreator(G)({
|
||||
onVoiceServerUpdate: (d) => got.push(['server', d]),
|
||||
onVoiceStateUpdate: (d) => got.push(['state', d]),
|
||||
destroy: () => got.push(['destroy']),
|
||||
});
|
||||
// 지켜보지 않는 서버 · 음성채널이 아닌 곳 · op 4 가 아닌 것은 서버가 버린다
|
||||
a.gw.adapterCreator(OTHER_G)({ onVoiceServerUpdate: () => undefined, onVoiceStateUpdate: () => undefined, destroy: () => undefined }).sendPayload(op4(OTHER_G, '1'));
|
||||
adapter.sendPayload(op4(G, TEXT));
|
||||
adapter.sendPayload({ op: 2, d: { token: 'x' } });
|
||||
adapter.sendPayload({ op: 4, d: { guild_id: OTHER_G, channel_id: VC1 } });
|
||||
// 정상 참여
|
||||
assert.equal(adapter.sendPayload({ op: 4, d: { guild_id: G, channel_id: VC1, self_mute: false, self_deaf: false, extra: 'x' } }), true);
|
||||
await until(() => s.source.sent.length === 1);
|
||||
assert.deepEqual(s.source.sent[0], { guildId: G, payload: op4(G, VC1) }, '검사한 필드만 다시 만들어 보낸다');
|
||||
|
||||
// 디스코드가 준 음성 접속 정보 → 앱의 @discordjs/voice 로
|
||||
s.source.handlers.get(G)!.state({ guild_id: G, user_id: ME.id, session_id: 'sess-1', channel_id: VC1 });
|
||||
s.source.handlers.get(G)!.server({ guild_id: G, token: 'one-time-voice-token', endpoint: 'voice.example:443' });
|
||||
await until(() => got.length === 2);
|
||||
assert.equal(got[0][0], 'state');
|
||||
assert.equal(got[0][1].session_id, 'sess-1');
|
||||
assert.equal(got[1][1].token, 'one-time-voice-token');
|
||||
|
||||
// 나가기
|
||||
adapter.sendPayload(op4(G, null));
|
||||
await until(() => s.source.sent.length === 2);
|
||||
assert.equal(s.source.sent[1]!.payload.d.channel_id, null);
|
||||
assert.ok(!a.seen.some((x) => x.includes(BOT)));
|
||||
} finally {
|
||||
await a.gw.stop();
|
||||
await s.close();
|
||||
}
|
||||
});
|
||||
|
||||
test('봇 중계: 다른 PC 가 봇을 데려가면 이전 PC 는 taken 을 받고, 이전 PC 가 봇을 빼거나 음성 정보를 받지 못한다', async () => {
|
||||
const s = await stack();
|
||||
const a = await s.pc(SUPER);
|
||||
const admin = new AppAuth(a.st, { version: 't', openUrl: () => undefined });
|
||||
await admin.adminAddUser(FRIEND, 'user');
|
||||
const b = await s.pc(FRIEND);
|
||||
try {
|
||||
await a.gw.start();
|
||||
await b.gw.start();
|
||||
await a.gw.watch(G, { commands: false });
|
||||
await b.gw.watch(G, { commands: false });
|
||||
const aGot: any[] = [];
|
||||
const bGot: any[] = [];
|
||||
const aAd = a.gw.adapterCreator(G)({ onVoiceServerUpdate: (d) => aGot.push(d), onVoiceStateUpdate: (d) => aGot.push(d), destroy: () => undefined });
|
||||
const bAd = b.gw.adapterCreator(G)({ onVoiceServerUpdate: (d) => bGot.push(d), onVoiceStateUpdate: (d) => bGot.push(d), destroy: () => undefined });
|
||||
const taken: string[] = [];
|
||||
a.gw.on('taken', (g) => taken.push(g));
|
||||
|
||||
aAd.sendPayload(op4(G, VC1));
|
||||
await until(() => s.source.sent.length === 1);
|
||||
bAd.sendPayload(op4(G, VC2));
|
||||
await until(() => taken.length === 1 && s.source.sent.length === 2);
|
||||
assert.equal(taken[0], G);
|
||||
|
||||
// 이제 음성 접속 정보는 B 에게만
|
||||
s.source.handlers.get(G)!.server({ guild_id: G, token: 'for-b' });
|
||||
await until(() => bGot.length === 1);
|
||||
assert.equal(aGot.length, 0);
|
||||
|
||||
// A 가 늦게 나가기를 보내도 B 의 봇을 빼지 않는다
|
||||
aAd.sendPayload(op4(G, null));
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
assert.equal(s.source.sent.length, 2);
|
||||
|
||||
// B 앱이 꺼지면 서버가 봇을 음성채널에서 뺀다
|
||||
await b.gw.stop();
|
||||
await until(() => s.source.sent.length === 3);
|
||||
assert.equal(s.source.sent[2]!.payload.d.channel_id, null);
|
||||
} finally {
|
||||
await a.gw.stop();
|
||||
await b.gw.stop();
|
||||
await s.close();
|
||||
}
|
||||
});
|
||||
|
||||
test('봇 중계: 슬래시 명령은 그 서버를 지켜보는 앱으로 가고 앱의 답이 돌아간다. 등록 해제하면 바로 끊긴다', async () => {
|
||||
const s = await stack();
|
||||
const a = await s.pc(SUPER);
|
||||
const admin = new AppAuth(a.st, { version: 't', openUrl: () => undefined });
|
||||
await admin.adminAddUser(FRIEND, 'user');
|
||||
const b = await s.pc(FRIEND);
|
||||
const cmd = (name: string, user: string) =>
|
||||
new Promise<string>((resolve) => s.source.emit('command', { name, guildId: G, user: m(user, user), voiceChannel: { id: VC1, name: '일반' } } satisfies BotCommand, resolve));
|
||||
try {
|
||||
assert.equal(await cmd('녹음시작', SUPER), '지금 이 서버에서 켜져 있는 겜녹이 앱이 없습니다.');
|
||||
// 지켜보는 앱이 없는 서버의 명령은 서버가 받지 않는다 (봇 토큰을 직접 쓰는 v1.1.0 PC 가 응답하게)
|
||||
assert.equal(s.source.wants?.(G), false);
|
||||
await a.gw.start();
|
||||
await b.gw.start();
|
||||
await a.gw.watch(G, { commands: false });
|
||||
assert.equal(s.source.wants?.(G), true);
|
||||
assert.equal(s.source.wants?.(OTHER_G), false);
|
||||
await b.gw.watch(G, { commands: false });
|
||||
const seenBy: string[] = [];
|
||||
a.gw.on('command', (c, respond) => (seenBy.push(`a:${c.name}`), respond(`A 가 ${c.name}`)));
|
||||
b.gw.on('command', (c, respond) => (seenBy.push(`b:${c.name}`), respond(`B 가 ${c.name}`)));
|
||||
// 명령한 사람의 PC 로
|
||||
assert.equal(await cmd('녹음시작', FRIEND), 'B 가 녹음시작');
|
||||
assert.equal(await cmd('녹음시작', SUPER), 'A 가 녹음시작');
|
||||
// 녹음 중인 PC 가 없으면 종료할 것이 없다
|
||||
assert.equal(await cmd('녹음종료', SUPER), '지금은 녹음 중이 아닙니다.');
|
||||
// 녹음제외는 모든 PC 기록에 남긴다
|
||||
await cmd('녹음제외', FRIEND);
|
||||
await until(() => seenBy.includes('a:녹음제외') && seenBy.includes('b:녹음제외'));
|
||||
|
||||
// 등록 해제 → B 의 중계 연결이 바로 끊기고 unauthorized
|
||||
let unauth = false;
|
||||
b.gw.on('unauthorized', () => (unauth = true));
|
||||
await admin.adminRemoveUser(FRIEND);
|
||||
await until(() => unauth);
|
||||
assert.equal(b.gw.me(), null);
|
||||
// 로그아웃 → A 도 끊긴다
|
||||
let aUnauth = false;
|
||||
a.gw.on('unauthorized', () => (aUnauth = true));
|
||||
await a.auth.logout();
|
||||
await until(() => aUnauth);
|
||||
} finally {
|
||||
await a.gw.stop();
|
||||
await b.gw.stop();
|
||||
await s.close();
|
||||
}
|
||||
});
|
||||
|
||||
test('봇 중계 권한: 일반 유저는 가입한 서버 · 볼 수 있는 채널만 보이고, 들어갈 수 있는 음성채널에만 봇을 부른다', async () => {
|
||||
const s = await stack();
|
||||
const a = await s.pc(SUPER);
|
||||
const admin = new AppAuth(a.st, { version: 't', openUrl: () => undefined });
|
||||
await admin.adminAddUser(FRIEND, 'user');
|
||||
const b = await s.pc(FRIEND);
|
||||
try {
|
||||
await b.gw.start();
|
||||
// 서버 목록: 가입한 M&L 만
|
||||
assert.deepEqual(b.gw.guilds().map((g) => g.id), [G]);
|
||||
// 가입하지 않은 서버는 지켜볼 수 없다 (바로 거절)
|
||||
const t0 = Date.now();
|
||||
assert.equal(await b.gw.watch(OTHER_G, { commands: true }), null);
|
||||
assert.ok(Date.now() - t0 < 3000, '거절은 바로 온다');
|
||||
assert.ok(!s.source.commands.includes(OTHER_G), '가입하지 않은 서버에 명령을 등록하지 않는다');
|
||||
await assert.rejects(b.gw.members(OTHER_G), /forbidden/);
|
||||
|
||||
// M&L: 비공개 채널과 그 안의 사람은 안 보인다
|
||||
assert.ok(await b.gw.watch(G, { commands: false }));
|
||||
assert.deepEqual((b.gw as any).channels && [...(b.gw as any).channels.keys()].sort(), [VC1, VC2, LOCKED].sort());
|
||||
assert.equal(b.gw.voiceChannelOf(G, '300000000000000001'), null);
|
||||
assert.equal(b.gw.channel(G, PRIV), null);
|
||||
|
||||
// 비공개 채널 안의 움직임은 안 오고, 비공개 채널로 옮기면 "나감"으로만 보인다
|
||||
const evs: any[] = [];
|
||||
b.gw.on('voiceState', (e) => evs.push(e));
|
||||
s.source.emit('voiceState', { guildId: G, member: m('300000000000000002', '운영진2'), oldChannelId: null, newChannelId: PRIV, channel: { id: PRIV, name: '운영진' } });
|
||||
s.source.emit('voiceState', { guildId: G, member: m(SUPER, '관리자'), oldChannelId: VC1, newChannelId: PRIV, channel: { id: PRIV, name: '운영진' } });
|
||||
await until(() => evs.length === 1);
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
assert.equal(evs.length, 1);
|
||||
assert.deepEqual([evs[0].member.id, evs[0].oldChannelId, evs[0].newChannelId, evs[0].channel], [SUPER, VC1, null, null]);
|
||||
|
||||
// 음성 참여: 비공개 · 연결 권한 없는 채널 · 다른 서버는 거절, 들어갈 수 있는 채널만
|
||||
const ad = b.gw.adapterCreator(G)({ onVoiceServerUpdate: () => undefined, onVoiceStateUpdate: () => undefined, destroy: () => undefined });
|
||||
ad.sendPayload(op4(G, PRIV));
|
||||
ad.sendPayload(op4(G, LOCKED));
|
||||
ad.sendPayload(op4(G, OTHER_VC));
|
||||
ad.sendPayload(op4(G, VC2));
|
||||
await until(() => s.source.sent.length === 1);
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
assert.deepEqual(s.source.sent.map((x) => x.payload.d.channel_id), [VC2]);
|
||||
|
||||
// 슬래시 명령: 최고 관리자가 비공개 채널에서 /녹음시작 → 그 채널에 못 들어가는 친구 PC 로는 보내지 않는다
|
||||
const cmds: any[] = [];
|
||||
b.gw.on('command', (c, respond) => (cmds.push(c), respond('ok')));
|
||||
const cmd = (name: string) =>
|
||||
new Promise<string>((resolve) => s.source.emit('command', { name, guildId: G, user: m(SUPER, '관리자'), voiceChannel: { id: PRIV, name: '운영진' } } satisfies BotCommand, resolve));
|
||||
assert.equal(await cmd('녹음시작'), '이 음성채널에 들어갈 수 있는 겜녹이 앱이 없습니다.');
|
||||
// /녹음제외 는 친구 PC 기록에도 남기되 비공개 채널 이름은 보내지 않는다
|
||||
assert.equal(await cmd('녹음제외'), 'ok');
|
||||
assert.equal(cmds.length, 1);
|
||||
assert.equal(cmds[0].voiceChannel, null);
|
||||
|
||||
// 친구 PC 가 받은 메시지 어디에도 비공개 채널 · 그 안의 사람 정보가 없다
|
||||
const all = b.seen.join('\n');
|
||||
// (OTHER_G 는 친구가 직접 보낸 watch 의 거절 응답에만 나온다)
|
||||
for (const secret of [PRIV, '운영진', '300000000000000001', '300000000000000002', '다른 서버', OTHER_VC]) assert.ok(!all.includes(secret), secret);
|
||||
} finally {
|
||||
await a.gw.stop();
|
||||
await b.gw.stop();
|
||||
await s.close();
|
||||
}
|
||||
});
|
||||
84
app/test/bot-token.test.ts
Normal file
@@ -0,0 +1,84 @@
|
||||
import { test } from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import fs from 'node:fs';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import { SettingsStore } from '../src/core/settings.ts';
|
||||
|
||||
const tmp = () => fs.mkdtempSync(path.join(process.env.TMPDIR || os.tmpdir(), 'gvr-bot-'));
|
||||
const BUILTIN = 'MTExMTExMTExMTExMTExMTEx.FAKE00.builtin-token-for-tests-only-xxxxxxxx';
|
||||
const APP = 'app-login-token-for-tests';
|
||||
const OTHER = 'OTE4MTIzMzQ4NzIxMDA4NzAw.FAKE11.other-bot-token-for-tests-only-yyyy';
|
||||
delete process.env.GVR_BOT_TOKEN;
|
||||
|
||||
/** 로그인한 상태 (앱 토큰만 있다. 겜녹이 봇 토큰은 서버에만 있다) */
|
||||
const loggedIn = (dir = tmp()) => {
|
||||
const s = new SettingsStore(dir);
|
||||
s.setSecret('appToken', APP);
|
||||
return s;
|
||||
};
|
||||
|
||||
test('로그인 전: 겜녹이 봇 토큰이 없다 (exe 에 들어 있지 않다)', () => {
|
||||
const s = new SettingsStore(tmp());
|
||||
assert.equal(s.get().discord.botMode, 'builtin');
|
||||
assert.equal(s.hasBuiltinBot, false);
|
||||
assert.equal(s.activeBotToken(), null);
|
||||
});
|
||||
|
||||
test('로그인 후: 겜녹이 봇이 기본이고, 이 PC 가 직접 로그인할 봇 토큰은 없다 (서버 중계)', () => {
|
||||
const s = loggedIn();
|
||||
assert.equal(s.hasBuiltinBot, true);
|
||||
assert.equal(s.activeBotToken(), null);
|
||||
});
|
||||
|
||||
test('v1.2.0 이 받아 둔 겜녹이 봇 토큰은 시작할 때 지운다', () => {
|
||||
const dir = tmp();
|
||||
loggedIn(dir).setSecret('builtinBotToken', BUILTIN);
|
||||
const s = new SettingsStore(dir);
|
||||
assert.equal(s.hasSecret('builtinBotToken'), false);
|
||||
assert.ok(!fs.readFileSync(path.join(dir, 'secrets.bin'), 'utf8').includes(BUILTIN));
|
||||
assert.equal(s.activeBotToken(), null);
|
||||
});
|
||||
|
||||
test('다른 봇으로 진행하기: 넣은 토큰을 쓰고, 다시 겜녹이 봇으로 오가도 각자 유지된다', () => {
|
||||
const dir = tmp();
|
||||
const s = loggedIn(dir);
|
||||
s.update({ discord: { botMode: 'custom' } });
|
||||
assert.equal(s.activeBotToken(), null, '다른 봇인데 토큰이 아직 없으면 로그인하지 않는다');
|
||||
s.setSecret('botToken', OTHER);
|
||||
assert.equal(s.activeBotToken(), OTHER);
|
||||
|
||||
s.update({ discord: { botMode: 'builtin' } });
|
||||
assert.equal(s.activeBotToken(), null);
|
||||
s.update({ discord: { botMode: 'custom' } });
|
||||
assert.equal(s.activeBotToken(), OTHER, '저장한 다른 봇 토큰은 지워지지 않는다');
|
||||
|
||||
// 다시 켜도 모드·토큰이 남는다
|
||||
const again = new SettingsStore(dir);
|
||||
assert.equal(again.get().discord.botMode, 'custom');
|
||||
assert.equal(again.activeBotToken(), OTHER);
|
||||
// 평문 설정 파일(settings.json)에는 토큰이 들어가지 않는다
|
||||
assert.ok(!fs.readFileSync(path.join(dir, 'settings.json'), 'utf8').includes(OTHER));
|
||||
});
|
||||
|
||||
test('v1.0.0 에서 직접 토큰을 넣어 쓰던 설치는 다른 봇 모드로 이어진다', () => {
|
||||
const dir = tmp();
|
||||
const old = new SettingsStore(dir);
|
||||
old.setSecret('botToken', OTHER);
|
||||
const saved = JSON.parse(JSON.stringify(old.get()));
|
||||
delete saved.discord.botMode;
|
||||
fs.writeFileSync(path.join(dir, 'settings.json'), JSON.stringify(saved));
|
||||
|
||||
const s = new SettingsStore(dir);
|
||||
assert.equal(s.get().discord.botMode, 'custom');
|
||||
assert.equal(s.activeBotToken(), OTHER);
|
||||
});
|
||||
|
||||
test('개발용 GVR_BOT_TOKEN 은 모드와 상관없이 우선한다', () => {
|
||||
process.env.GVR_BOT_TOKEN = OTHER;
|
||||
try {
|
||||
assert.equal(loggedIn().activeBotToken(), OTHER);
|
||||
} finally {
|
||||
delete process.env.GVR_BOT_TOKEN;
|
||||
}
|
||||
});
|
||||
212
app/test/culprit.test.ts
Normal file
@@ -0,0 +1,212 @@
|
||||
import { test } from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import fs from 'node:fs';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import type { CulpritInput, CulpritMatchInfo, CulpritMatchItem } from '@gvr/shared';
|
||||
import { SettingsStore, DEFAULT_TTS_TEXT } from '../src/core/settings.ts';
|
||||
import { kastRound } from '../src/core/games/valorant.ts';
|
||||
import { makeDemoLol } from './fixtures/demo-matches.ts';
|
||||
import { culpritApi, MIN, seedValorant, setup } from './fixtures/culprit-seed.ts';
|
||||
|
||||
test('범인찾기: 발로란트 추가 지표 저장 (피해량 · 첫킬 · 설치 · 역할 · 라운드별 장비)', () => {
|
||||
const ctx = setup();
|
||||
const { id } = seedValorant(ctx);
|
||||
const det = JSON.parse(ctx.store.getMatch(id)!.detail!);
|
||||
const jett = det.players.find((p: any) => p.puuid === 'p-sh');
|
||||
assert.equal(jett.stats.role, '타격대');
|
||||
assert.ok(jett.stats.damage > 0, '피해량');
|
||||
assert.equal(typeof jett.stats.firstKills, 'number');
|
||||
assert.ok(det.players.reduce((n: number, p: any) => n + p.stats.firstKills, 0) > 0, '첫킬 합 > 0');
|
||||
const plants = det.players.reduce((n: number, p: any) => n + p.stats.plants, 0);
|
||||
assert.ok(plants > 0, '설치 기록');
|
||||
const r = det.roundsDetail[1];
|
||||
assert.equal(typeof r.allyAttack, 'boolean');
|
||||
assert.ok(r.players['p-sh'] !== undefined, '라운드별 선수 지표');
|
||||
assert.ok(Object.values<any>(r.economy).every((e) => typeof e.loadout === 'number'), '라운드 장비 값');
|
||||
// 전반(1~12)과 후반(13~)은 공수가 바뀐다
|
||||
assert.notEqual(det.roundsDetail[0].allyAttack, det.roundsDetail[12].allyAttack);
|
||||
// KAST · 받은 피해 (OP.GG 발로란트 OP스코어 입력)
|
||||
assert.ok(det.players.every((p: any) => p.stats.kastRounds >= 0 && p.stats.kastRounds <= det.roundsDetail.length && p.stats.damageTaken > 0));
|
||||
});
|
||||
|
||||
test('범인찾기: KAST 라운드 판정 (킬 · 어시 · 생존 · 5초 안 트레이드)', () => {
|
||||
const players = { a1: { teamId: 'Red' }, a2: { teamId: 'Red' }, a3: { teamId: 'Red' }, b1: { teamId: 'Blue' }, b2: { teamId: 'Blue' } };
|
||||
const r = { playerStats: Object.keys(players).map((subject) => ({ subject })) };
|
||||
const kills = [
|
||||
{ killer: 'b1', victim: 'a1', gameTime: 10000, assistants: [] }, // a1 죽음 → 3초 뒤 a2 가 b1 을 잡아 트레이드
|
||||
{ killer: 'a2', victim: 'b1', gameTime: 13000, assistants: ['a3'] },
|
||||
{ killer: 'b2', victim: 'a2', gameTime: 20000, assistants: [] }, // a2 는 킬이 있어 KAST
|
||||
{ killer: 'b2', victim: 'a3', gameTime: 30000, assistants: [] }, // a3 는 어시가 있어 KAST
|
||||
];
|
||||
assert.deepEqual(kastRound(r, kills, players).sort(), ['a1', 'a2', 'a3', 'b1', 'b2']); // b1 은 킬이 있다
|
||||
// 트레이드가 5초를 넘기면 KAST 아님
|
||||
const late = [{ ...kills[0] }, { ...kills[1], gameTime: 16000 }];
|
||||
assert.ok(!kastRound(r, late, players).includes('a1'));
|
||||
});
|
||||
|
||||
test('범인찾기: 분석 가능 판정과 AI 자료', () => {
|
||||
const ctx = setup();
|
||||
const { id } = seedValorant(ctx);
|
||||
const m = ctx.store.getMatch(id)!;
|
||||
assert.deepEqual(ctx.culprit.eligibility(m), { state: 'ready', reasons: [] });
|
||||
const input = ctx.culprit.buildInput(m);
|
||||
const lines = input.text.split('\n');
|
||||
assert.match(lines[0], /^# 경기 발로란트 .* 13:9 \(우리 팀 승리\) · 22라운드/);
|
||||
// 우리 팀이 P1~P5, 승한은 음성O, 디스코드 계정이 없는 상대는 음성X
|
||||
const p1 = lines.find((l) => l.startsWith('P1 '))!;
|
||||
assert.match(p1, /^P1 승한 우리 제트\(타격대\) \d+\/\d+\/\d+ ACS\d+ ADR\d+ KAST\d+% 피해격차[+-]\d+ 첫킬\d+\/첫데스\d+ HS\d+% 설치\d+\/해체\d+ .*음성O$/);
|
||||
// 기록 점수 (OP.GG OP스코어 방식): 10명 모두, 이긴 팀 1등 MVP · 진 팀 1등 ACE
|
||||
const head = lines.findIndex((l) => l.startsWith('# 기록 점수 (0~10, OP.GG OP스코어 방식'));
|
||||
assert.ok(head > 0, '기록 점수 칸');
|
||||
const rl = lines.slice(head + 1, head + 11);
|
||||
assert.ok(rl.every((l, i) => new RegExp(`^P${i + 1} \\d+\\.\\d점 \\d+위/팀\\d위`).test(l)), rl.join('\n'));
|
||||
assert.equal(rl.filter((l) => / MVP( |$)/.test(l)).length, 1);
|
||||
assert.equal(rl.filter((l) => / ACE( |$)/.test(l)).length, 1);
|
||||
assert.ok(rl.slice(0, 5).some((l) => / MVP( |$)/.test(l)), 'MVP 는 이긴 우리 팀');
|
||||
const rp = input.players.map((p) => p.rating!);
|
||||
assert.ok(rp.every((r) => r && r.score >= 0 && r.score <= 10 && !r.basic));
|
||||
assert.deepEqual(rp.map((r) => r.rank).sort((a, b) => a - b), [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);
|
||||
assert.equal(rp.find((r) => r.rank === 1)!.score, Math.max(...rp.map((r) => r.score)));
|
||||
assert.equal(input.lookup?.riotMatchId, 'demo');
|
||||
assert.match(lines.find((l) => l.startsWith('P6 '))!, /상대 .*음성X$/);
|
||||
assert.equal(input.players.find((p) => p.id === 'P2')!.voice, true, '민수는 대화가 있다');
|
||||
assert.equal(input.players.find((p) => p.id === 'P3')!.voice, false);
|
||||
// 게임 계정이 없는 화자는 디스코드 이름으로
|
||||
assert.ok(lines.some((l) => l.includes('도윤(게임 계정 모름)')));
|
||||
// 근거 번호: 대화 · 이벤트 · 라운드 · 스탯
|
||||
const u1 = lines.find((l) => l.startsWith('[u1] '))!;
|
||||
assert.match(u1, /^\[u1\] R3 0:05 P1: 현우야 같이 가 기다려 둘 있어$/);
|
||||
assert.equal(input.refs.u1.kind, 'utterance');
|
||||
assert.ok(lines.some((l) => /^\[e\d+\] R\d+ \d+:\d+ 킬 P\d+ → P\d+/.test(l)), '킬 줄');
|
||||
assert.ok(lines.some((l) => /^\[r1\] R1 우리 (공격|수비) 라운드 끝 · (승리|패배)\(.+\) \d+:\d+ · 평균 장비 우리 [\d,]+ \/ 상대 [\d,]+ · 선수 장비\/피해: P1 /.test(l)), '라운드 줄');
|
||||
assert.deepEqual(input.refs['s:P4'], { kind: 'stat', pid: 'P4' });
|
||||
assert.equal(input.stats.utterances, 4);
|
||||
assert.equal(input.stats.basic, false);
|
||||
// 줄은 시간 순서
|
||||
const u2Index = lines.findIndex((l) => l.startsWith('[u2] '));
|
||||
assert.ok(lines.findIndex((l) => l.startsWith('[r2] ')) < lines.findIndex((l) => l.startsWith('[u1] ')));
|
||||
assert.ok(u2Index > lines.findIndex((l) => l.startsWith('[u1] ')));
|
||||
});
|
||||
|
||||
test('범인찾기: 녹음이 늦게 시작 · 음성 변환 중 · 녹음 제외', () => {
|
||||
const late = setup();
|
||||
const a = seedValorant(late, { sessionStartOffsetMs: 17 * MIN });
|
||||
const e = late.culprit.eligibility(late.store.getMatch(a.id)!);
|
||||
assert.equal(e.state, 'blocked');
|
||||
assert.deepEqual(e.reasons, ['녹음이 경기 시작 12분 뒤에 시작됐습니다']);
|
||||
|
||||
const pend = setup();
|
||||
const b = seedValorant(pend, { pending: true });
|
||||
assert.deepEqual(pend.culprit.eligibility(pend.store.getMatch(b.id)!), { state: 'pending', reasons: ['음성 변환 중 (1문장 남음)'] });
|
||||
|
||||
// 녹음 제외한 사람의 대화는 보내지 않는다
|
||||
const ex = setup();
|
||||
const c = seedValorant(ex);
|
||||
ex.store.setExcluded('u2', true);
|
||||
const input = ex.culprit.buildInput(ex.store.getMatch(c.id)!);
|
||||
assert.ok(!input.text.includes('내가 뚫을게'));
|
||||
assert.equal(input.players.find((p) => p.id === 'P2')!.voice, false);
|
||||
|
||||
// 경기 결과를 못 받은 경기
|
||||
const nd = setup();
|
||||
nd.store.upsertMatch({ id: 'val-x', game: 'valorant', started_at: Date.now() - 50 * MIN, ended_at: Date.now() - 10 * MIN, status: 'complete', detail: JSON.stringify({ live: true }) });
|
||||
nd.store.startSession('s', 'g', 'c', null, Date.now() - 60 * MIN);
|
||||
assert.deepEqual(nd.culprit.eligibility(nd.store.getMatch('val-x')!), { state: 'blocked', reasons: ['경기 결과를 받지 못했습니다'] });
|
||||
});
|
||||
|
||||
test('범인찾기: 롤 포지션 · 시야 · 10/15분 지표와 골드 차', () => {
|
||||
const ctx = setup();
|
||||
const LS = Date.now() - 80 * MIN;
|
||||
const lol = makeDemoLol();
|
||||
ctx.store.setMeta('riot_self_puuid', 'l-sh');
|
||||
ctx.store.startSession('s', 'g', 'c', null, LS - MIN);
|
||||
ctx.store.endSession('s', LS + lol.durationMs + MIN);
|
||||
ctx.games.matchStarted({ id: 'lol-1', game: 'lol', startedAt: LS, map: 'Map11', mode: 'CLASSIC', queue: '420', detail: { live: true } });
|
||||
ctx.games.matchEnded('lol-1', LS + lol.durationMs);
|
||||
(ctx.games.adapters[1] as any).applyHistory('lol-1', lol.game, lol.timeline, LS);
|
||||
const m = ctx.store.getMatch('lol-1')!;
|
||||
const det = JSON.parse(m.detail!);
|
||||
assert.deepEqual(
|
||||
det.players.map((p: any) => p.stats.role),
|
||||
['미드', '정글', '탑', '원딜', '서폿', '미드', '정글', '탑', '원딜', '서폿'],
|
||||
);
|
||||
assert.deepEqual(det.players[1].stats.at10, { cs: 60, gold: det.players[1].stats.at10.gold, xp: 4220 });
|
||||
assert.equal(ctx.culprit.eligibility(m).state, 'ready');
|
||||
const input = ctx.culprit.buildInput(m);
|
||||
assert.match(input.text, /\nP5 Duck 우리 [^ ]+\(서폿\) \d+\/\d+\/\d+ CS\d+ 골드\d+ 딜17500 받은\d+ 시야62 와드48\/4\/9 10분\d+·\d+ 15분\d+·\d+ 음성X\n/);
|
||||
assert.match(input.text, /\n# 골드 차\(우리-상대\): 5분 [+-][\d,]+ · 10분/);
|
||||
assert.match(input.text, /\n\[e\d+\] \d+:\d+ 킬 P\d+ → P\d+/);
|
||||
assert.match(input.text, /\n\[e\d+\] \d+:\d+ 내셔 남작 처치 우리 팀 · P2\n/);
|
||||
// 기록 점수 + LOL.PS 방식 라인전 (15분 맞라인 상대와 차)
|
||||
assert.match(input.text, /\n# 기록 점수 \(0~10, OP\.GG OP스코어 방식/);
|
||||
assert.match(input.text, /\nP1 \d+\.\d점 \d+위\/팀\d위.* · 라인전\(15분 vs P6\) CS[+-][\d,]+ 골드[+-][\d,]+ 경험치[+-][\d,]+\n/);
|
||||
const p1 = input.players.find((p) => p.id === 'P1')!;
|
||||
const p6 = input.players.find((p) => p.id === 'P6')!;
|
||||
assert.equal(p1.rating!.lane!.cs, -p6.rating!.lane!.cs, '맞라인 차는 서로 반대');
|
||||
assert.equal(input.players.filter((p) => p.rating?.badge).length, 2);
|
||||
assert.equal(p1.tag !== undefined, true);
|
||||
});
|
||||
|
||||
test('범인찾기 API: 목록 · 상세 · 내부 전용 경로', async () => {
|
||||
const ctx = setup();
|
||||
const { id } = seedValorant(ctx);
|
||||
const api = await culpritApi(ctx);
|
||||
const list = (await api.inject({ url: '/api/culprit/matches' })).json() as CulpritMatchItem[];
|
||||
assert.equal(list.length, 1);
|
||||
assert.equal(list[0].eligibility.state, 'ready');
|
||||
// 브라우저(사이트 중계)는 내부 경로를 쓸 수 없다
|
||||
assert.equal((await api.inject({ url: `/api/culprit/internal/${id}/input` })).statusCode, 403);
|
||||
assert.equal((await api.inject({ method: 'PUT', url: `/api/culprit/internal/${id}/result`, payload: {} })).statusCode, 403);
|
||||
const r = await api.inject({ url: `/api/culprit/internal/${id}/input`, headers: { 'x-gvr-internal': '1' } });
|
||||
assert.equal(r.statusCode, 200);
|
||||
const input = r.json().input as CulpritInput;
|
||||
assert.ok(input.text.length > 1000);
|
||||
const result = {
|
||||
summary: '요약',
|
||||
confidence: 'high',
|
||||
confidence_note: '',
|
||||
teams: [
|
||||
{ team: 'ally', culprit: 'P2', reason: '이유', evidence: [{ ref: 'u2', note: '"아 그냥 간다"', target: input.refs.u2 }] },
|
||||
{ team: 'enemy', culprit: 'P8', reason: '이유', evidence: [] },
|
||||
],
|
||||
players: input.players.map((p) => ({ id: p.id, score: p.id === 'P2' || p.id === 'P8' ? 3 : 7, tag: p.id === 'P2' || p.id === 'P8' ? '범인' : '무난', comment: '평', evidence: [] })),
|
||||
};
|
||||
const put = await api.inject({
|
||||
method: 'PUT',
|
||||
url: `/api/culprit/internal/${id}/result`,
|
||||
headers: { 'x-gvr-internal': '1' },
|
||||
payload: { result, players: input.players, model: 'claude-opus-5-5', createdBy: { id: 'u1', name: '승한' }, meta: { costUsd: 0.41 } },
|
||||
});
|
||||
assert.equal(put.statusCode, 200);
|
||||
const info = (await api.inject({ url: `/api/culprit/matches/${id}` })).json() as CulpritMatchInfo;
|
||||
assert.equal(info.eligibility.state, 'done');
|
||||
assert.equal(info.analysis!.result.teams[0].culprit, 'P2');
|
||||
assert.equal(info.analysis!.meta.costUsd, 0.41);
|
||||
assert.equal(info.history.length, 1);
|
||||
assert.equal(info.sources.utterances, 4);
|
||||
const list2 = (await api.inject({ url: '/api/culprit/matches' })).json() as CulpritMatchItem[];
|
||||
assert.deepEqual(
|
||||
list2[0].culprits.map((c) => [c.team, c.name]),
|
||||
[
|
||||
['ally', '민수'],
|
||||
['enemy', 'Kiwi'],
|
||||
],
|
||||
);
|
||||
// 다시 분석하면 이전 결과는 기록으로 남는다
|
||||
await api.inject({ method: 'PUT', url: `/api/culprit/internal/${id}/result`, headers: { 'x-gvr-internal': '1' }, payload: { result, players: input.players, model: 'm2', createdBy: { id: 'u1', name: '승한' }, meta: {} } });
|
||||
const info2 = (await api.inject({ url: `/api/culprit/matches/${id}` })).json() as CulpritMatchInfo;
|
||||
assert.equal(info2.history.length, 2);
|
||||
assert.equal(info2.analysis!.model, 'm2');
|
||||
assert.equal(info2.history.filter((h) => h.current).length, 1);
|
||||
await api.close();
|
||||
});
|
||||
|
||||
test('녹음 안내 문구: 예전 기본 문구는 AI 분석 안내가 들어간 새 기본 문구로, 직접 고친 문구는 그대로', () => {
|
||||
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'gvr-tts-'));
|
||||
fs.writeFileSync(path.join(dir, 'settings.json'), JSON.stringify({ discord: { ttsText: '겜녹이가 이 음성채널을 녹음합니다. 녹음을 원하지 않으시면 녹음제외 명령을 입력해 주세요.' } }));
|
||||
assert.equal(new SettingsStore(dir).get().discord.ttsText, DEFAULT_TTS_TEXT);
|
||||
assert.match(DEFAULT_TTS_TEXT, /AI 경기 분석에 쓰일 수 있어요/);
|
||||
fs.writeFileSync(path.join(dir, 'settings.json'), JSON.stringify({ discord: { ttsText: '녹음 중입니다' } }));
|
||||
assert.equal(new SettingsStore(dir).get().discord.ttsText, '녹음 중입니다');
|
||||
});
|
||||
92
app/test/fixtures/culprit-seed.ts
vendored
Normal file
@@ -0,0 +1,92 @@
|
||||
// 범인찾기 테스트용: 앱 코어 일부(기록 DB · 타임라인 · 게임 관리 · 범인찾기)와 시연 경기 (앱 · 사이트 서버 테스트가 같이 쓴다)
|
||||
import fs from 'node:fs';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import { Store } from '../../src/core/db/db.ts';
|
||||
import { Timeline } from '../../src/core/timeline.ts';
|
||||
import { GameAssets } from '../../src/core/games/assets.ts';
|
||||
import { GameManager } from '../../src/core/games/manager.ts';
|
||||
import { Culprit } from '../../src/core/culprit.ts';
|
||||
import { buildApi } from '../../src/core/api/server.ts';
|
||||
import { Bus } from '../../src/core/util/events.ts';
|
||||
import { makeDemoValorant, AGENT } from './demo-matches.ts';
|
||||
|
||||
export const MIN = 60000;
|
||||
|
||||
export function setup() {
|
||||
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'gvr-culprit-'));
|
||||
const store = new Store(path.join(dir, 'db.sqlite'));
|
||||
const timeline = new Timeline(store);
|
||||
const assets = new GameAssets(path.join(dir, 'cache'));
|
||||
// 네트워크 없이: 요원 이름 · 역할만 넣어 둔다
|
||||
assets.val = {
|
||||
at: Date.now(),
|
||||
agents: {
|
||||
[AGENT.jett]: { name: '제트', icon: '', role: '타격대', abilities: {} },
|
||||
[AGENT.sage]: { name: '세이지', icon: '', role: '감시자', abilities: {} },
|
||||
},
|
||||
maps: {},
|
||||
weapons: {},
|
||||
tiers: {},
|
||||
modes: {},
|
||||
clientVersion: null,
|
||||
} as any;
|
||||
const bus = new Bus();
|
||||
const stt: any = { onMatchStart: async () => undefined, onMatchEnd: async () => undefined };
|
||||
const worker: any = { on: () => undefined, off: () => undefined };
|
||||
const games = new GameManager(store, assets, worker, stt, timeline, bus, () => ({}) as any, () => null);
|
||||
const culprit = new Culprit(store, timeline, games);
|
||||
return { dir, store, timeline, assets, bus, games, culprit };
|
||||
}
|
||||
|
||||
/** 발로란트 시연 경기 + 녹음 세션 + 대화 4문장 */
|
||||
export function seedValorant(ctx: ReturnType<typeof setup>, opts: { sessionStartOffsetMs?: number; pending?: boolean } = {}) {
|
||||
const { store, games } = ctx;
|
||||
const VS = Date.now() - 3 * 3600_000;
|
||||
const md = makeDemoValorant(VS);
|
||||
const id = 'val-demo';
|
||||
const users = [
|
||||
{ id: 'u1', name: '승한', puuid: 'p-sh' },
|
||||
{ id: 'u2', name: '민수', puuid: 'p-ms' },
|
||||
{ id: 'u9', name: '도윤', puuid: null },
|
||||
];
|
||||
for (const u of users) {
|
||||
store.upsertUser({ id: u.id, name: u.name, avatar: null });
|
||||
if (u.puuid) store.setAccounts(u.id, [{ puuid: u.puuid, riotId: `${u.name}#X` }]);
|
||||
}
|
||||
store.startSession('s1', 'g', 'c', '음성', VS - 5 * MIN + (opts.sessionStartOffsetMs ?? 0));
|
||||
games.matchStarted({ id, game: 'valorant', startedAt: VS, map: md.matchInfo.mapId, mode: 'competitive', queue: 'competitive', detail: { live: true } });
|
||||
games.matchEnded(id, VS + md.matchInfo.gameLengthMillis);
|
||||
(games.adapters[0] as any).applyDetails(id, md, 'p-sh', VS);
|
||||
const rounds = store.rounds(id);
|
||||
const say = (uid: string, round: number, sec: number, text: string, status = 'realtime') => {
|
||||
const ts = rounds[round - 1].combat_at + sec * 1000;
|
||||
const uid2 = `${uid}-${round}-${sec}`;
|
||||
store.insertUtterance({ id: uid2, session_id: 's1', user_id: uid, started_at: ts, ended_at: ts + 1500, audio_path: null, match_id: id });
|
||||
if (status !== 'pending')
|
||||
store.updateUtteranceResult(uid2, { text, raw_text: text, words: [], noise: false, noise_reason: null, confidence: 0.9, lufs: -20, gain_db: 0, model: 'small', status: status as any });
|
||||
};
|
||||
say('u1', 3, 5, '현우야 같이 가 기다려 둘 있어');
|
||||
say('u2', 3, 9, '아 그냥 간다 내가 뚫을게');
|
||||
say('u9', 5, 2, '나 돈 없어 세이브할게');
|
||||
say('u1', 7, 4, '스파이크 설치됐어 해체 들어가', opts.pending ? 'pending' : 'realtime');
|
||||
store.endSession('s1', VS + md.matchInfo.gameLengthMillis + 5 * MIN);
|
||||
return { id, VS, md };
|
||||
}
|
||||
|
||||
|
||||
/** 앱 로컬 API (사이트 서버가 중계로 부르는 것과 같은 Fastify) */
|
||||
export function culpritApi(ctx: ReturnType<typeof setup>) {
|
||||
return buildApi({
|
||||
store: ctx.store,
|
||||
timeline: ctx.timeline,
|
||||
games: ctx.games,
|
||||
dict: {} as any,
|
||||
culprit: ctx.culprit,
|
||||
bus: ctx.bus,
|
||||
settings: () => ({}) as any,
|
||||
trainingDir: () => ctx.dir,
|
||||
overviewExtra: () => ({ guild: null, recording: { active: false, channel: null, since: null, participants: [] } }),
|
||||
version: 'test',
|
||||
});
|
||||
}
|
||||
46
app/test/fixtures/demo-matches.ts
vendored
@@ -100,6 +100,11 @@ export function makeDemoValorant(gameStart: number) {
|
||||
score: kills.filter((k) => k.killer === p.subject).length * 200 + range(0, 150),
|
||||
economy: { spent: pistol ? 800 : range(1500, 4700), remaining: range(0, 3000), loadoutValue: 0, weapon: pistol ? WEAPON.classic : pick([WEAPON.vandal, WEAPON.phantom]), armor: '' },
|
||||
}));
|
||||
// 피해량 · 장비 값 (난수를 더 쓰지 않는다: 다른 시연 데이터가 바뀌지 않게)
|
||||
for (const ps of playerStats as any[]) {
|
||||
ps.damage = ps.kills.map((k: any) => ({ receiver: k.victim, damage: 140 + (k.gameTime % 61), headshots: k.gameTime % 3 === 0 ? 1 : 0, bodyshots: 2, legshots: k.gameTime % 5 === 0 ? 1 : 0 }));
|
||||
ps.economy.loadoutValue = pistol ? 800 : ps.economy.spent + 900;
|
||||
}
|
||||
for (const ps of playerStats) stats[ps.subject].score += ps.score;
|
||||
roundResults.push({
|
||||
roundNum: i,
|
||||
@@ -138,6 +143,13 @@ const LOL = [
|
||||
{ pid: 9, champ: 222, team: 200, puuid: 'r-4', name: 'Nox', tag: '0420' }, // 징크스
|
||||
{ pid: 10, champ: 89, team: 200, puuid: 'r-5', name: 'Mint', tag: '7777' }, // 레오나
|
||||
];
|
||||
const LANE = [
|
||||
{ lane: 'MIDDLE', role: 'SOLO' },
|
||||
{ lane: 'JUNGLE', role: 'NONE' },
|
||||
{ lane: 'TOP', role: 'SOLO' },
|
||||
{ lane: 'BOTTOM', role: 'DUO_CARRY' },
|
||||
{ lane: 'BOTTOM', role: 'DUO_SUPPORT' },
|
||||
];
|
||||
export function makeDemoLol() {
|
||||
seed = 23;
|
||||
const dur = 28 * 60;
|
||||
@@ -173,7 +185,13 @@ export function makeDemoLol() {
|
||||
if ([13, 19].includes(m)) events.push({ type: 'BUILDING_KILL', timestamp: m * 60000 + 15000, killerId: 8, teamId: 100, buildingType: 'TOWER_BUILDING', position: { x: 5846, y: 6396 } });
|
||||
events.sort((a, b) => a.timestamp - b.timestamp);
|
||||
const pf: Record<string, any> = {};
|
||||
for (const p of LOL) pf[String(p.pid)] = { totalGold: Math.round((p.team === 100 ? ga : gr) / 5) };
|
||||
for (const p of LOL)
|
||||
pf[String(p.pid)] = {
|
||||
totalGold: Math.round((p.team === 100 ? ga : gr) / 5),
|
||||
minionsKilled: (p.pid - 1) % 5 === 4 || (p.pid - 1) % 5 === 1 ? m : m * (6 + (p.pid % 3)),
|
||||
jungleMinionsKilled: (p.pid - 1) % 5 === 1 ? m * 5 : 0,
|
||||
xp: m * 420 + p.pid * 10,
|
||||
};
|
||||
frames.push({ timestamp: m * 60000, participantFrames: pf, events });
|
||||
}
|
||||
const items = [3031, 3089, 3157, 3020, 6655, 3135];
|
||||
@@ -186,7 +204,31 @@ export function makeDemoLol() {
|
||||
participantId: p.pid,
|
||||
championId: p.champ,
|
||||
teamId: p.team,
|
||||
stats: { ...st[p.pid], totalMinionsKilled: range(30, 230), neutralMinionsKilled: p.pid === 2 || p.pid === 7 ? range(120, 180) : range(0, 15), goldEarned: Math.round((p.team === 100 ? ga : gr) / 5) + range(-800, 800), item0: pick(items), item1: pick(items), item2: pick(items), champLevel: range(13, 18), win: p.team === 100 },
|
||||
spell1Id: p.pid === 2 || p.pid === 7 ? 11 : 4,
|
||||
spell2Id: 14,
|
||||
// 라인 · 역할 (LCU 경기 기록 형식)
|
||||
timeline: LANE[(p.pid - 1) % 5],
|
||||
stats: {
|
||||
...st[p.pid],
|
||||
totalMinionsKilled: range(30, 230),
|
||||
neutralMinionsKilled: p.pid === 2 || p.pid === 7 ? range(120, 180) : range(0, 15),
|
||||
goldEarned: Math.round((p.team === 100 ? ga : gr) / 5) + range(-800, 800),
|
||||
item0: pick(items),
|
||||
item1: pick(items),
|
||||
item2: pick(items),
|
||||
champLevel: range(13, 18),
|
||||
win: p.team === 100,
|
||||
// 범인찾기용 추가 지표 (난수를 더 쓰지 않는다: 다른 시연 데이터가 바뀌지 않게)
|
||||
totalDamageDealtToChampions: 9000 + p.pid * 1700,
|
||||
totalDamageTaken: 15000 + ((p.pid * 3700) % 11000),
|
||||
visionScore: (p.pid - 1) % 5 === 4 ? 62 : 14 + p.pid * 2,
|
||||
wardsPlaced: (p.pid - 1) % 5 === 4 ? 48 : 9 + p.pid,
|
||||
wardsKilled: 3 + (p.pid % 4),
|
||||
visionWardsBoughtInGame: (p.pid - 1) % 5 === 4 ? 9 : 2,
|
||||
damageDealtToObjectives: 4000 + p.pid * 900,
|
||||
damageDealtToTurrets: 1200 + p.pid * 400,
|
||||
timeCCingOthers: 10 + p.pid * 3,
|
||||
},
|
||||
})),
|
||||
participantIdentities: LOL.map((p) => ({ participantId: p.pid, player: { puuid: p.puuid, gameName: p.name, tagLine: p.tag } })),
|
||||
teams: [
|
||||
|
||||
1
app/test/fixtures/opgg-sample.json
vendored
Normal file
57
app/test/rating.test.ts
Normal file
@@ -0,0 +1,57 @@
|
||||
import { test } from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import fs from 'node:fs';
|
||||
import { rateLol, rateValorant, type MatchPlayer, type MatchRound } from '@gvr/shared';
|
||||
|
||||
/** OP.GG 공식 MCP 에서 받은 실제 경기 (tools/opscore-fit/make_fixture.py). 우리 계산이 실제 OP.GG 점수와 가까운지 본다 */
|
||||
const sample = JSON.parse(fs.readFileSync(new URL('./fixtures/opgg-sample.json', import.meta.url), 'utf8'));
|
||||
|
||||
test('기록 점수 (롤): 실제 OP.GG OP스코어와 평균 오차 · 팀 최하위 일치', () => {
|
||||
let err = 0;
|
||||
let n = 0;
|
||||
let teams = 0;
|
||||
let lowestHit = 0;
|
||||
for (const g of sample.lol) {
|
||||
const players = g.players as (MatchPlayer & { opgg: number })[];
|
||||
const r = rateLol(players, g.minutes, g.allyWin);
|
||||
for (const p of players) {
|
||||
err += Math.abs(r.get(p.puuid)!.score - p.opgg);
|
||||
n++;
|
||||
}
|
||||
for (const team of ['BLUE', 'RED']) {
|
||||
const ps = players.filter((p) => p.team === team);
|
||||
teams++;
|
||||
const ours = ps.reduce((a, b) => (r.get(a.puuid)!.score <= r.get(b.puuid)!.score ? a : b));
|
||||
const theirs = ps.reduce((a, b) => (a.opgg <= b.opgg ? a : b));
|
||||
if (ours === theirs) lowestHit++;
|
||||
}
|
||||
// 이긴 팀 1등 MVP, 진 팀 1등 ACE
|
||||
const badges = [...r.values()].map((x) => x.badge).filter(Boolean).sort();
|
||||
assert.deepEqual(badges, ['ACE', 'MVP']);
|
||||
}
|
||||
const mae = err / n;
|
||||
assert.ok(mae < 0.75, `평균 오차 ${mae.toFixed(2)}`);
|
||||
assert.ok(lowestHit / teams >= 0.75, `팀 최하위 일치 ${lowestHit}/${teams}`);
|
||||
});
|
||||
|
||||
test('기록 점수 (발로란트): 실제 OP.GG OP스코어와 평균 오차', () => {
|
||||
let err = 0;
|
||||
for (const v of sample.valorant) {
|
||||
const rounds = Array.from({ length: v.rounds }, (_, i) => ({ win: i < v.wonRounds }) as MatchRound);
|
||||
const r = rateValorant([v.player], rounds).get('v')!;
|
||||
assert.equal(r.basic, false);
|
||||
err += Math.abs(r.score - v.opgg);
|
||||
}
|
||||
const mae = err / sample.valorant.length;
|
||||
assert.ok(mae < 0.7, `평균 오차 ${mae.toFixed(2)}`);
|
||||
});
|
||||
|
||||
test('기록 점수: 추가 지표가 없는 예전 경기는 기본 기록 모델, 설명은 상식 방향만', () => {
|
||||
const g = sample.lol[0];
|
||||
const bare = g.players.map(({ stats: _s, ...p }: any) => p);
|
||||
const r = rateLol(bare, g.minutes, g.allyWin);
|
||||
assert.ok([...r.values()].every((x) => x.basic && x.score >= 0 && x.score <= 10));
|
||||
// 데스가 가장 많은 사람에게 "데스" 가 강점으로 붙지 않는다
|
||||
const full = rateLol(g.players, g.minutes, g.allyWin);
|
||||
for (const x of full.values()) for (const part of x.parts) if (/데스/.test(part.text)) assert.equal(part.good, false, part.text);
|
||||
});
|
||||
121
app/test/security.test.ts
Normal file
@@ -0,0 +1,121 @@
|
||||
// 앱 통신 보안: 사이트 서버 주소는 https 만 (로그인 토큰 · 기기 키 · 기록), 인증서 검증을 끄는 건 이 PC 안 주소뿐
|
||||
import { test } from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import fs from 'node:fs';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import { AppAuth } from '../src/core/auth.ts';
|
||||
import { RemoteGateway } from '../src/core/discord/gateway.ts';
|
||||
import { request } from '../src/core/games/riot.ts';
|
||||
import { registerDevice } from '../src/core/relay/client.ts';
|
||||
import { SettingsStore } from '../src/core/settings.ts';
|
||||
import { secureServerUrl } from '../src/core/util/secure-url.ts';
|
||||
|
||||
const tmp = () => fs.mkdtempSync(path.join(process.env.TMPDIR || os.tmpdir(), 'gvr-sec-'));
|
||||
|
||||
test('사이트 서버 주소: https 와 이 PC 안 http 만 허용', () => {
|
||||
assert.equal(secureServerUrl('https://gvr.tkrmagid.kr/'), 'https://gvr.tkrmagid.kr');
|
||||
assert.equal(secureServerUrl(' https://gvr.tkrmagid.kr '), 'https://gvr.tkrmagid.kr');
|
||||
assert.equal(secureServerUrl('http://127.0.0.1:8080'), 'http://127.0.0.1:8080');
|
||||
assert.equal(secureServerUrl('http://localhost:8080/'), 'http://localhost:8080');
|
||||
for (const bad of ['http://gvr.tkrmagid.kr', 'http://192.168.10.5:2972', 'ws://gvr.tkrmagid.kr', 'ftp://x', 'https://user:pw@gvr.tkrmagid.kr', 'gvr.tkrmagid.kr', 'http://127.0.0.1.evil.example'])
|
||||
assert.throws(() => secureServerUrl(bad), /https|올바르지|아이디/, bad);
|
||||
});
|
||||
|
||||
test('암호화되지 않은 주소로는 로그인 토큰 · 기기 등록 코드를 보내지 않는다', async () => {
|
||||
const real = globalThis.fetch;
|
||||
const sent: string[] = [];
|
||||
globalThis.fetch = (async (u: any, init?: any) => (sent.push(String(u)), real(u, init))) as typeof fetch;
|
||||
try {
|
||||
const st = new SettingsStore(tmp());
|
||||
st.update({ site: { serverUrl: 'http://gvr.tkrmagid.kr' } });
|
||||
st.setSecret('appToken', 'secret-app-token');
|
||||
const auth = new AppAuth(st, { version: 't', openUrl: () => undefined });
|
||||
await auth.check();
|
||||
await auth.login();
|
||||
await assert.rejects(registerDevice('http://gvr.tkrmagid.kr', 'ABCD-EFGH', 'pc'), /https/);
|
||||
const gw = new RemoteGateway({ serverUrl: () => 'http://gvr.tkrmagid.kr', appToken: () => 'secret-app-token', version: 't' });
|
||||
await assert.rejects(gw.start(), /https/);
|
||||
await gw.stop();
|
||||
assert.deepEqual(sent, [], '아무 요청도 나가면 안 된다');
|
||||
} finally {
|
||||
globalThis.fetch = real;
|
||||
}
|
||||
});
|
||||
|
||||
test('게임 연동: 인증서 검증을 끄는 건 이 PC 안 주소뿐 (local 을 잘못 넘겨도 바깥 주소는 거절)', async () => {
|
||||
await assert.rejects(request('https://pd.ap.a.pvp.net/x', { local: true }), /로컬 API 가 아닌 주소/);
|
||||
});
|
||||
|
||||
test('인증서: NODE_TLS_REJECT_UNAUTHORIZED=0 이어도 믿을 수 없는 인증서의 서버로는 토큰 · 기기 키를 보내지 않는다 (https · wss)', async () => {
|
||||
const { execFileSync } = await import('node:child_process');
|
||||
const https = await import('node:https');
|
||||
const { WebSocketServer } = await import('ws');
|
||||
const { RelayClient } = await import('../src/core/relay/client.ts');
|
||||
const { Bus } = await import('../src/core/util/events.ts');
|
||||
// 가짜 서버 (자체 서명 인증서): 받은 요청의 인증 헤더를 모두 기록한다
|
||||
const dir = tmp();
|
||||
execFileSync('openssl', ['req', '-x509', '-newkey', 'rsa:2048', '-nodes', '-subj', '/CN=127.0.0.1', '-addext', 'subjectAltName=IP:127.0.0.1', '-days', '1', '-keyout', path.join(dir, 'k.pem'), '-out', path.join(dir, 'c.pem')], { stdio: 'ignore' });
|
||||
const got: string[] = [];
|
||||
const srv = https.createServer({ key: fs.readFileSync(path.join(dir, 'k.pem')), cert: fs.readFileSync(path.join(dir, 'c.pem')) }, (req, res) => {
|
||||
got.push(`${req.url} ${req.headers.authorization ?? ''}`);
|
||||
res.setHeader('content-type', 'application/json');
|
||||
res.end('{"state":"pending","user":{"id":"1","name":"x","avatar":null},"role":"user","serverTime":0}');
|
||||
});
|
||||
const wss = new WebSocketServer({ noServer: true });
|
||||
srv.on('upgrade', (req, socket, head) => {
|
||||
got.push(`WS ${req.url} ${req.headers.authorization ?? ''}`);
|
||||
wss.handleUpgrade(req, socket, head, (ws) => ws.close());
|
||||
});
|
||||
await new Promise<void>((r) => srv.listen(0, '127.0.0.1', () => r()));
|
||||
const base = `https://127.0.0.1:${(srv.address() as any).port}`;
|
||||
const prev = process.env.NODE_TLS_REJECT_UNAUTHORIZED;
|
||||
process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
|
||||
const origWarn = process.emitWarning;
|
||||
process.emitWarning = () => undefined;
|
||||
try {
|
||||
// 대조군: 기본 fetch 는 이 변수 때문에 실제로 토큰을 보낸다 (테스트가 우회를 잡아낼 수 있는지 확인)
|
||||
await fetch(`${base}/control`, { headers: { authorization: 'Bearer control' } });
|
||||
assert.deepEqual(got, ['/control Bearer control']);
|
||||
got.length = 0;
|
||||
|
||||
const st = new SettingsStore(tmp());
|
||||
st.update({ site: { serverUrl: base, deviceId: 'dev1' } });
|
||||
st.setSecret('appToken', 'secret-app-token');
|
||||
st.setSecret('deviceKey', 'secret-device-key');
|
||||
// 로그인 확인 (https)
|
||||
const auth = new AppAuth(st, { version: 't', openUrl: () => undefined });
|
||||
const a = await auth.check();
|
||||
assert.notEqual(a.status, 'ok');
|
||||
assert.match(a.error ?? '', /연결할 수 없습니다/);
|
||||
// 기기 등록 (https)
|
||||
await assert.rejects(registerDevice(base, 'ABCD-EFGH', 'pc'));
|
||||
// 겜녹이 봇 중계 (wss)
|
||||
const gw = new RemoteGateway({ serverUrl: () => base, appToken: () => 'secret-app-token', version: 't' });
|
||||
const started = gw.start().then(() => 'ready', () => 'failed');
|
||||
await new Promise((r) => setTimeout(r, 1500));
|
||||
await gw.stop();
|
||||
assert.equal(await Promise.race([started, new Promise((r) => setTimeout(() => r('pending'), 100))]) === 'ready', false);
|
||||
// 사이트 기기 중계 (wss)
|
||||
const relay = new RelayClient({} as any, new Bus(), () => ({ serverUrl: base, deviceId: 'dev1', deviceKey: 'secret-device-key', name: 'pc', version: 't', guildId: null }));
|
||||
relay.start();
|
||||
await new Promise((r) => setTimeout(r, 1500));
|
||||
assert.notEqual(relay.status.state, 'online');
|
||||
relay.stop();
|
||||
|
||||
assert.deepEqual(got, [], '믿을 수 없는 인증서의 서버에 요청 · 토큰이 가면 안 된다');
|
||||
|
||||
// 앱 시작 때 이 변수를 지우면 (main.ts · startCore) 사이트 밖 통신(일반 fetch: 다른 봇 · Riot 원격 API 등)도 다시 검증한다
|
||||
const { hardenTlsEnv } = await import('../src/core/util/secure-http.ts');
|
||||
hardenTlsEnv();
|
||||
assert.equal(process.env.NODE_TLS_REJECT_UNAUTHORIZED, undefined);
|
||||
await assert.rejects(fetch(`${base}/after-harden`, { headers: { authorization: 'Bearer x' } }));
|
||||
assert.deepEqual(got, []);
|
||||
} finally {
|
||||
if (prev === undefined) delete process.env.NODE_TLS_REJECT_UNAUTHORIZED;
|
||||
else process.env.NODE_TLS_REJECT_UNAUTHORIZED = prev;
|
||||
process.emitWarning = origWarn;
|
||||
srv.closeAllConnections();
|
||||
srv.close();
|
||||
}
|
||||
});
|
||||
@@ -18,6 +18,8 @@ COPY site/server/package.json site/server/package-lock.json ./
|
||||
RUN npm ci --omit=dev --no-audit --no-fund && npm cache clean --force
|
||||
COPY --from=build /src/site/server/dist ./dist
|
||||
COPY --from=build /src/site/web/dist ./web
|
||||
# 범인찾기 지시문 · 지식 묶음 (dist/main.js 가 ../prompt 에서 읽는다)
|
||||
COPY site/server/prompt ./prompt
|
||||
VOLUME /data
|
||||
EXPOSE 8080
|
||||
HEALTHCHECK --interval=30s --timeout=5s CMD wget -qO- http://127.0.0.1:8080/healthz || exit 1
|
||||
|
||||
@@ -13,5 +13,7 @@ print(f"DISCORD_BOT_TOKEN={c['token']}")
|
||||
print(f"SESSION_SECRET={secrets.token_urlsafe(48)}")
|
||||
print("ALLOWED_GUILD_IDS=457514742940958731")
|
||||
print("OWNER_DISCORD_IDS=293719842274541579")
|
||||
a = json.load(open('/home/claude/.config/ejclaw/secrets.json'))['credentials'].get('anthropic.api/game-voice-recorder')
|
||||
if a: print(f"ANTHROPIC_API_KEY={a['token']}")
|
||||
PY
|
||||
echo ".env 작성 완료"
|
||||
|
||||
11
deploy/site/set-anthropic-key.sh
Executable file
@@ -0,0 +1,11 @@
|
||||
#!/usr/bin/env bash
|
||||
# 범인찾기 Claude API 키를 .5 의 사이트 서버 .env 에 넣거나 바꾼다 (다른 값 · 로그인 세션은 그대로).
|
||||
# 키는 secrets.json 에서 읽어 원격에 바로 쓰고, 로컬 파일 · 명령줄에 남기지 않는다. 적용: deploy/site/deploy.sh
|
||||
set -euo pipefail
|
||||
HOST=root@192.168.10.5
|
||||
DIR=/root/other/game-voice-recorder
|
||||
python3 - <<'PY' | ssh -o BatchMode=yes $HOST "cd $DIR && test -f .env && umask 077 && grep -v '^ANTHROPIC_API_KEY=' .env > .env.new; cat >> .env.new && mv .env.new .env && chmod 600 .env"
|
||||
import json
|
||||
print(f"ANTHROPIC_API_KEY={json.load(open('/home/claude/.config/ejclaw/secrets.json'))['credentials']['anthropic.api/game-voice-recorder']['token']}")
|
||||
PY
|
||||
echo "ANTHROPIC_API_KEY 설정 완료"
|
||||
BIN
docs/culprit-finder-plan.pdf
Normal file
@@ -94,6 +94,7 @@ tools/ 사전 생성기, 테스트 도구(목 Riot 서버, 음성
|
||||
GVR-Data/
|
||||
settings.json 일반 설정 (평문)
|
||||
secrets.bin 비밀값 (Windows: Electron safeStorage = DPAPI, 헤드리스: 0600 평문 JSON)
|
||||
앱 로그인 토큰 · 마지막 로그인 확인(오프라인 3일 유예용) 포함. 겜녹이 봇 토큰은 없다 (8장)
|
||||
gvr.sqlite 기록 DB
|
||||
audio/YYYY-MM-DD/<utteranceId>.ogg
|
||||
training/<sampleId>.ogg 교정한 문장의 음성 조각 (자동 삭제 제외, A3)
|
||||
@@ -208,4 +209,33 @@ type TimelineItem =
|
||||
| `/api/*` | 로그인 + 기기 온라인이면 앱으로 중계, 오프라인이면 `503 {error:'device_offline'}` |
|
||||
| `WS /ws` | 브라우저용. `{type:'status',data}` + 5장 이벤트 |
|
||||
| `POST /admin/registration-code` | 관리자 전용 → `{code, expiresAt}` |
|
||||
| `POST /auth/app/begin` | 앱 로그인 시작 → `{id, secret, url, expiresAt}` (url 을 브라우저로 연다, 10분 유효) |
|
||||
| `GET /auth/app/start/:id` | 브라우저: state 쿠키(`app.<id>.<nonce>`) → 디스코드 OAuth → 같은 `/auth/discord/callback` |
|
||||
| `POST /auth/app/poll` | `{id, secret}` → `{state:'pending'}` · `{state:'ok', token, user, role}` · `{state:'not_registered', user}` (결과는 한 번만) |
|
||||
| `GET /app/me` | `Authorization: Bearer <앱 토큰>` → `{user, role, serverTime}`. 미등록 403 `not_registered`, 토큰 무효 401 |
|
||||
| `WS /app/bot/ws` | `Authorization: Bearer <앱 토큰>`. 겜녹이 봇 중계 (8장). 토큰 무효 · 미등록 401, 연결 중 등록 해제 · 로그아웃되면 4401 로 끊는다 |
|
||||
| `POST /auth/app/logout` | 앱 토큰 무효화 |
|
||||
| `GET /app/admin/users` | 관리자 이상 → `{users: AppUserRow[]}` (최고 관리자 고정 행 포함) |
|
||||
| `POST /app/admin/users` · `PATCH`/`DELETE /app/admin/users/:id` | 최고 관리자만: 등록(`{id, role:'admin'|'user'}`, 디스코드에서 계정 확인) · 역할 변경 · 등록 해제 |
|
||||
| `GET /game-assets/<source>/<path>` | valorant-api.com · ddragon · cdragon 이미지 캐시 프록시 |
|
||||
|
||||
## 8. 겜녹이 봇 중계 (v1.2.1~)
|
||||
|
||||
겜녹이 봇 토큰은 사이트 서버에만 있다 (앱에 보내지 않는다). 서버가 discord.js 로 디스코드 게이트웨이에 한 번 붙고
|
||||
(`site/server/src/discord-source.ts`), 로그인한 앱은 `WS /app/bot/ws` 로 필요한 정보만 받는다 (`site/server/src/bot-broker.ts`,
|
||||
앱 쪽 `app/src/core/discord/gateway.ts` 의 `RemoteGateway`. 다른 봇 모드는 `LocalGateway` 로 PC 가 직접 연결). 형식은 `packages/shared` 의 `BotGw*`.
|
||||
|
||||
- 서버 → 앱: `ready{me, guilds}` · `guilds` · `guild{guild, channels, voice}`(watch 응답) · `voiceState`(지켜보는 서버만) · `cmd`(슬래시 명령) ·
|
||||
`vserver`/`vstate`(봇 자신의 VOICE_SERVER/STATE_UPDATE 원문 = 일회용 음성 접속 정보) · `taken` · `res`
|
||||
- 앱 → 서버: `watch{guildId, commands}` · `voice{guildId, payload}`(@discordjs/voice 어댑터의 op 4) · `cmd_res{id, content}` · `req{op:'members'}`
|
||||
- 권한 (앱 유저의 디스코드 아이디 기준): 서버 목록 · watch 는 그 유저가 가입한 서버만 (아니면 `watch_denied`), 채널 · 음성 상태는 그 유저가 볼 수 있는(ViewChannel) 채널만
|
||||
(볼 수 없는 채널로 옮기면 "나감"으로 가린다), 음성 참여는 그 유저가 들어갈 수 있는(ViewChannel + Connect) 음성채널만. 슬래시 명령 /녹음시작 도 그 채널에 들어갈 수 있는 유저의 PC 로만 보낸다
|
||||
- 권한 회수: 연결한 뒤에도 탈퇴 · 추방 · 역할 · 채널 권한 변경 이벤트(`access`), 음성 접속 정보를 넘기기 직전, 30초 주기로 다시 확인한다.
|
||||
봇이 있는 채널에 그 유저가 더는 들어갈 수 없으면 음성 접속 정보 전달을 멈추고 봇을 빼고(op 4 null) 앱에 `taken` 을 보낸다. 서버 멤버가 아니게 되면 `watch_denied`
|
||||
- 음성채널 참여: 앱의 @discordjs/voice 가 어댑터로 op 4 를 보내면 서버가 검사(지켜보는 서버 · 들어갈 수 있는 음성채널 · op 4 만, 필드를 다시 만들어)한 뒤 대신 보내고,
|
||||
디스코드가 준 session_id · 음성 서버 token · endpoint 를 그 앱에만 넘긴다. 음성(UDP · DAVE)은 앱 ↔ 디스코드 음성 서버로 바로 간다 (Lavalink 와 같은 방식)
|
||||
- 한 서버에서 봇은 음성채널 하나에만 있을 수 있다: 마지막으로 참여를 요청한 앱이 가져가고 이전 앱은 `taken` 을 받는다. 이전 앱의 늦은 나가기는 무시한다.
|
||||
음성을 가진 앱이 끊기면 서버가 봇을 음성채널에서 뺀다
|
||||
- 슬래시 명령: 서버가 받아 바로 defer 하고, 그 서버를 지켜보는 앱에 보낸다 (녹음시작: 명령한 사람의 PC → 녹음 중인 PC → 가장 최근 PC, 녹음종료: 녹음 중인 PC, 녹음제외 · 참여: 모든 PC). 첫 응답을 답장으로 쓴다
|
||||
- 사이트 서버에 못 붙으면 겜녹이 봇은 쓸 수 없다 (다른 봇 모드는 상관없음)
|
||||
|
||||
|
||||
@@ -128,3 +128,17 @@ VOICE E2E PASS
|
||||
원인: `<|notimestamps|>` 라벨로만 학습 → 앱(faster-whisper)이 쓰는 타임스탬프 모드에서 끝맺음을 잊음. 검증도 notimestamps 로 해서 못 걸렀음.
|
||||
→ 절반은 `<|0.00|> 문장 <|말끝|>` 라벨로 학습, 검증도 타임스탬프 모드로 → 위 표처럼 사전 없이도 개선
|
||||
- 한계: 합성 음성과 시연 대화가 같은 TTS 엔진이라 실제 목소리에서는 개선 폭이 작을 수 있다. 실사용 교정 데이터가 2주쯤 쌓이면 게임 PC(RTX 5070 Ti)에서 다시 학습해 비교한다
|
||||
|
||||
## 범인찾기 v1.3.0 실제 E2E (2026-10-15)
|
||||
|
||||
`node --import tsx app/scripts/culprit-real-e2e.mts` — 실제 앱 코어 → 실제 사이트 서버(중계) → **실제 Claude API (claude-opus-5-5, 생각 high, 구조화 출력)** · **실제 OP.GG MCP** → 근거 확인 → 게임 PC 에 저장 → 헤드리스 브라우저로 결과 화면
|
||||
|
||||
| 경기 | OP.GG | 걸린 시간 | 토큰 (입력 / 캐시 쓰기 / 출력) | 비용 | 범인 |
|
||||
|---|---|---|---|---|---|
|
||||
| 발로란트 시연 경기 (22라운드 · 킬 156 · 대화 4문장) | 없음 (시연 경기) → 기록 점수로 | 42초 | 10,579 / 7,486 / 3,320 | $0.146 | 우리 P5 (기록 점수 공동 최하위 5.0, 이유에 동점자 P4 와 비교) · 상대 P7 (기록 1.9 경기 최하위) |
|
||||
| 롤 실제 솔로 랭크 (OP.GG 에서 받은 10명 실제 스탯 + 우리 팀 2명 시험용 대화 9문장) | **10명 찾음** (실제 OP스코어와 같음) | 36초 | 1,884 / 9,041 / 2,825 | $0.109 | 우리 P5 (OP.GG 3.0 · 기록 2.1 팀 최하위) · 상대 P8 (OP.GG 4.9 · 기록 5.1 팀 최하위) |
|
||||
|
||||
- 진행 단계: `OP.GG 점수 찾는 중 → AI 가 읽는 중 → 근거 확인 → 완료`, 화면 오류 · CSP 위반 없음
|
||||
- AI 평점은 전적 사이트 점수에서 출발해 승부처 · 대화로 조정됨 (롤 10명 AI 평점과 OP.GG 점수 차 평균 0.2점, 최대 0.5점). 범인 이유에 "OP.GG 점수 3.0으로 경기 최하위", "기록 점수는 현우와 5.0점 공동 최하위 … 그래서 Duck" 처럼 점수와 근거를 같이 씀
|
||||
- 이 롤 경기에서 기록 점수와 실제 OP.GG 점수 차: 평균 0.5점, 팀 최하위 2팀 모두 일치
|
||||
- 단위 · 통합 테스트: 앱 40개 · 사이트 서버 18개 통과 (`rating.test.ts`: 실제 OP.GG 표본 20경기 · 발로란트 40명으로 평균 오차와 팀 최하위 일치 확인)
|
||||
|
||||
463
docs/report/culprit/build.py
Normal file
@@ -0,0 +1,463 @@
|
||||
"""계획서 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('<style>') + 7: src.index('</style>')]
|
||||
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('../../../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}"
|
||||
|
||||
# ── 그래프 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'<svg viewBox="0 0 {W} {H}" width="100%" xmlns="http://www.w3.org/2000/svg" font-family="Noto Sans CJK KR" font-size="10">']
|
||||
for gy in range(0, int(mx) + 1, 1000):
|
||||
out.append(f'<line x1="{L}" x2="{W-10}" y1="{y(gy):.1f}" y2="{y(gy):.1f}" stroke="#e6e9ee" stroke-width="1"/>')
|
||||
out.append(f'<text x="{L-6}" y="{y(gy)+3:.1f}" text-anchor="end" fill="#7a8492">{gy/d["hist_n"]*100:.0f}%</text>')
|
||||
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'<path d="M{x0:.1f},{T+ph:.1f} V{y0+r:.1f} Q{x0:.1f},{y0:.1f} {x0+r:.1f},{y0:.1f} H{x0+w-r:.1f} Q{x0+w:.1f},{y0:.1f} {x0+w:.1f},{y0+r:.1f} V{T+ph:.1f} Z" fill="#2a78d6"/>')
|
||||
out.append(f'<line x1="{L}" x2="{W-10}" y1="{T+ph}" y2="{T+ph}" stroke="#9aa6b5"/>')
|
||||
for v in [0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8]:
|
||||
out.append(f'<text x="{x(v):.1f}" y="{H-12}" text-anchor="middle" fill="#5d6675">${v:.1f}</text>')
|
||||
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'<line x1="{x(v):.1f}" x2="{x(v):.1f}" y1="{T}" y2="{T+ph}" stroke="#1b1f27" stroke-dasharray="3 3"/>')
|
||||
out.append(f'<text x="{x(v)+5:.1f}" y="{T+10}" fill="#1b1f27" font-weight="700">{lab}</text>')
|
||||
out.append(f'<text x="{W-10}" y="{H-1}" text-anchor="end" fill="#7a8492">경기당 비용 (Claude Opus 5.5, 실패·재분석 여유 빼고)</text>')
|
||||
out.append('</svg>')
|
||||
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'<div class="vbar"><div class="lab">{lab}</div><div class="track"><div class="seg" style="width:{v/mx*100:.1f}%;background:{col};border-radius:0 4px 4px 0"></div></div><div class="tot" style="width:62px"><b style="color:#1b1f27">{v:,}</b>경기</div></div>')
|
||||
return ''.join(h)
|
||||
|
||||
opus = PM['opus-5.5']
|
||||
days = 31
|
||||
per_day = opus['p50'] / days
|
||||
|
||||
HTML = f'''<!doctype html><html lang="ko"><head><meta charset="utf-8"><title>겜녹이 범인찾기 · 리플레이 동기화 계획서 v1.2</title>
|
||||
<style>{STYLE}
|
||||
.cover .wave span:nth-child(3n) {{ opacity:.55 }}
|
||||
pre.box {{ background:#0f1923; color:#d7dee6; border-radius:8px; padding:9px 12px; font-size:8.2pt; line-height:1.55; white-space:pre-wrap; break-inside:avoid; font-family:"D2Coding ligature","DejaVu Sans Mono",monospace; }}
|
||||
pre.box .c {{ color:#7f8b99 }} pre.box .h {{ color:#ffc86a }} pre.box .v {{ color:#4fd8cf }}
|
||||
pre.box.ap {{ font-size:7.3pt; line-height:1.45; break-inside:auto; }}
|
||||
.cover h1 {{ font-size:25pt; }}
|
||||
.big-num {{ font-family:"NanumSquare Neo",sans-serif; font-weight:800; }}
|
||||
td.num, th.num {{ text-align:right; white-space:nowrap; }}
|
||||
tr.hl td {{ background:#fff3f4 !important; font-weight:700; }}
|
||||
.done {{ color:#0f8a5f; font-weight:700; white-space:nowrap; }} .todo {{ color:#8a6a10; font-weight:700; white-space:nowrap; }}
|
||||
.mob {{ display:grid; grid-template-columns: 0.62fr 1.38fr; gap:12px; align-items:start; }}
|
||||
</style></head><body>
|
||||
|
||||
<section class="cover">
|
||||
<div class="bar"></div>
|
||||
<h1>범인찾기 · 리플레이 동기화 계획서</h1>
|
||||
<div class="sub">AI가 경기 기록을 읽고 10명 평가 · 팀별 범인을 찾습니다.<br>리플레이를 보면 그때 한 말을 시간에 맞춰 보여 줍니다.</div>
|
||||
<table class="meta">
|
||||
<tr><td>프로젝트</td><td>겜녹이 (Game Voice Recorder) · v1.2.2 다음 기능</td></tr>
|
||||
<tr><td>문서</td><td>계획서 v1.2 · 정해 주신 8가지 반영 (v1.1 + 결정 사항 · 실제 화면 · 토큰 실측)</td></tr>
|
||||
<tr><td>진행</td><td>범인찾기 C1~C3(앱 · 사이트 서버 · 화면) 구현 완료, 배포 전 · 리플레이 동기화는 API 확인 뒤 결정</td></tr>
|
||||
<tr><td>작성일</td><td>2026-10-15</td></tr>
|
||||
<tr><td>AI</td><td>Claude API (Anthropic) · 기본 모델 Claude Opus 5.5</td></tr>
|
||||
<tr><td>예산</td><td>API 크레딧 $100 (2026-11-15 만료)</td></tr>
|
||||
</table>
|
||||
<div class="hero"><img src="img/real-result.png" alt=""></div>
|
||||
<div class="foot">gvr.tkrmagid.kr · 표지 화면은 실제 구현 화면(시연 데이터 + 실제 Claude Opus 5.5 분석 결과)입니다</div>
|
||||
</section>
|
||||
|
||||
<section class="page">
|
||||
<h2><span class="num">1</span>한눈에 보기</h2>
|
||||
<div class="stats">
|
||||
<div class="stat"><div class="v">{opus['p50']}<small>경기</small></div><div class="l">$100로 분석할 수 있는 경기 수<br>(Opus 5.5 · 가정한 조건에서<br>10번 중 9번 {opus['p5']}~{opus['p95']})</div></div>
|
||||
<div class="stat"><div class="v">{usd(B['cost']['mean'])}</div><div class="l">경기당 평균 비용<br>(10판 중 8판은 {usd(B['cost']['p10'])}~{usd(B['cost']['p90'])})</div></div>
|
||||
<div class="stat"><div class="v">1~2<small>분</small></div><div class="l">버튼을 누르고 결과가 나올 때까지</div></div>
|
||||
<div class="stat"><div class="v">{per_day:.0f}<small>판/일</small></div><div class="l">크레딧 만료(11/15)까지 다 쓰려면<br>하루에 분석해야 하는 경기 수</div></div>
|
||||
</div>
|
||||
<ul>
|
||||
<li><b>무엇을 하나</b>: 사이트에 <b>🔍 범인찾기</b> 탭을 새로 만듭니다. 끝난 경기를 고르고 <b>범인 분석</b>을 누르면, AI가 그 경기의 음성 대화 · 킬 · 라운드/오브젝트 · 경제 · 채팅 · 10명 스탯을 모두 읽고 아래를 만들어 줍니다.
|
||||
<ul><li>10명 전부 평점(10점 만점), 별명 태그(캐리 · 숨은 MVP · 무난 · 범인), 한 줄 평</li>
|
||||
<li>팀별 범인 1명씩(우리 팀 · 상대 팀), 왜 범인인지 설명, 근거 3~4개</li>
|
||||
<li>근거마다 실제 순간(대화 · 킬 · 라운드)이 연결돼 누르면 타임라인에서 바로 듣고 볼 수 있음</li></ul></li>
|
||||
<li><b>대상 경기</b>: 끝났고 기록이 모두 남아 있는 경기만 고를 수 있습니다. 녹음이 중간에 시작됐거나, 경기 결과를 못 받았거나, 음성 변환이 덜 끝난 경기는 이유를 보여 주고 막습니다 (4장).</li>
|
||||
<li><b>범인</b>: 팀마다 1명. <b>가장 못한 사람 + 가장 발목을 잡은 사람 + 결과(패배)의 원인</b>을 모두 합쳐 종합으로 고릅니다 (3장).</li>
|
||||
<li><b>AI는 사이트 서버가 부릅니다</b>. Claude Opus 5.5 · 말투 중간맛. API 키는 받아서 서버 비밀 저장소에만 두었고, 배포 때 사이트 서버 환경 변수로만 넣습니다. exe에는 넣지 않습니다 (5장).</li>
|
||||
<li><b>분석 버튼</b>은 등록된 앱 유저 이상만 누를 수 있습니다(다시 분석은 관리자). 결과는 로그인한 멤버 모두가 봅니다.</li>
|
||||
<li><b>비용</b>: 경기 길이와 말하는 양을 무작위로 바꿔 가며 2만 경기를 계산했습니다. Opus 5.5로 <b>$100이면 약 {opus['p50']}경기</b>입니다(지시문 · 지식 묶음 토큰을 실제로 재서 다시 계산, v1.1의 248경기에서 조정). 방이 조용하면 약 {SC['quiet/mix']['per100']}경기, 말이 많으면 약 {SC['loud/mix']['per100']}경기입니다 (7장).</li>
|
||||
<li><b>예산 보호</b>: 월 $100 상한, 하루 횟수 제한, 경기당 최대 약 $1 상한, 한 경기는 한 번만 분석(다시 분석은 관리자만)을 둡니다.</li>
|
||||
<li><b>프롬프트 · 지식 묶음은 미리 써 두었습니다</b>: 지시문, 발로란트 · 롤 지식 묶음(규칙 · 경제 · 역할 기준 · 은어 · 음성 인식 오류 · 최신 요원 · 챔피언 목록), 출력 형식. 매 분석마다 같이 보내 AI가 “배운 상태”로 분석합니다 (6장 · 부록).</li>
|
||||
<li><b>멤버 공지</b>: 녹음 안내(TTS) 문구에 “녹음된 대화는 AI 경기 분석에 쓰일 수 있어요”를 넣었습니다. 기본 문구를 쓰던 PC는 새 문구로 자동으로 바뀝니다.</li>
|
||||
<li><b>리플레이 동기화</b>: 게임 안 리플레이를 보면 exe가 알아채고 “리플레이와 동기화하시겠습니까?”를 묻는 기능입니다. <b>게임이 API(공식 · 비공식)로 리플레이 시간을 알려 줄 때만 넣습니다.</b> 화면 글자 인식(OCR)이나 게임 설정 파일 고치기는 하지 않습니다. 그래서 먼저 Windows PC에서 롤 · 발로란트가 어떤 API를 주는지 확인(R0)하고, 되는 게임만 만듭니다 (8장). AI를 쓰지 않아 비용이 없습니다.</li>
|
||||
</ul>
|
||||
<div class="callout info"><b class="t">정한 것 (2026-10-15 답변 · 자세한 내용은 10장)</b>
|
||||
① 범인 = 가장 못함 + 가장 발목 + 패배 원인 종합 ② 분석 버튼 = 등록된 앱 유저 이상 ③ 모델 = Opus 5.5 ④ API 키 = 받음(서버에만) ⑤ 말투 = 중간맛 ⑥ 공지 = 녹음 안내(TTS) 문구에 추가 ⑦ 발로란트 리플레이 = API에 없으면 넣지 않음(OCR 안 함) ⑧ 롤 리플레이 = API에 없으면 넣지 않음(설정 파일 안 고침)</div>
|
||||
|
||||
<h3>목차</h3>
|
||||
<ol class="toc">
|
||||
<li>한눈에 보기</li><li>쓰는 흐름 · 화면 예시</li><li>범인을 고르는 기준</li><li>분석에 쓰는 기록 · 분석할 수 있는 경기</li>
|
||||
<li>구조 · 보안 · 개인정보</li><li>범인찾기 프롬프트 · 지식 묶음</li><li>비용 예상: $100로 몇 경기?</li><li>리플레이 동기화</li><li>만드는 순서 · 확인 방법</li><li>정한 것 · 남은 일</li><li>부록: 프롬프트 · 지식 묶음 · 출력 형식 원문</li></ol>
|
||||
</section>
|
||||
|
||||
<section class="page">
|
||||
<h2><span class="num">2</span>쓰는 흐름 · 화면 예시</h2>
|
||||
<div class="flow">
|
||||
<div class="s"><div class="ic">🎮</div><div class="t">경기 끝</div><div class="d">결과 · 10명 스탯 받음<br>음성 변환 끝</div></div>
|
||||
<div class="s"><div class="ic">🔍</div><div class="t">범인찾기 탭</div><div class="d">분석 가능한 경기만<br>고를 수 있음</div></div>
|
||||
<div class="s"><div class="ic">💰</div><div class="t">범인 분석</div><div class="d">예상 비용 · 남은 예산<br>확인 후 시작</div></div>
|
||||
<div class="s"><div class="ic">🧠</div><div class="t">AI 분석</div><div class="d">1~2분<br>진행 단계 표시</div></div>
|
||||
<div class="s"><div class="ic">🚨</div><div class="t">결과</div><div class="d">팀별 범인 · 10명 평가<br>모두가 같이 봄</div></div>
|
||||
</div>
|
||||
<figure><img class="shot" src="img/real-list.png" alt=""><figcaption><b>화면 1 · 범인찾기 탭 (경기 고르기)</b> 왼쪽은 끝난 경기 목록입니다. 경기마다 <b>분석 가능 · 분석 완료 · 준비 중 · 기록 부족</b>을 표시하고, 기록이 부족하면 이유(“녹음이 12분 뒤에 시작됨” 등)를 보여 줍니다. 오른쪽은 고른 경기에서 분석에 쓰는 기록과 참가자 10명(음성이 있는 사람 표시), 예상 비용 · 남은 예산 · 오늘 남은 횟수입니다. <span class="ex">실제 화면 · 시연 데이터</span></figcaption></figure>
|
||||
<figure><img class="shot" src="img/real-result.png" alt=""><figcaption><b>화면 2 · 분석 결과 (발로란트)</b> 맨 위는 한 줄 요약, 가운데는 팀별 범인 카드(이유 + 근거), 아래는 10명 평가입니다. 근거의 대화는 <b>▶ 듣기</b>로 그 문장 음성을 바로 재생하고(7일 보관 기간 안), 킬 · 라운드는 타임라인으로 이동합니다. 상대 팀처럼 음성이 없는 사람은 “게임 기록으로 판단”이라고 밝힙니다. 결과 글은 실제 Claude Opus 5.5가 쓴 것입니다. 시연 데이터의 앞뒤가 안 맞는 곳을 AI가 스스로 찾아 확신도를 “낮음”으로 적었습니다. <span class="ex">실제 화면 · 시연 데이터</span></figcaption></figure>
|
||||
</section>
|
||||
|
||||
<section class="page">
|
||||
<div class="mob">
|
||||
<figure style="margin-top:0"><img class="shot" src="img/real-mobile.png" alt=""><figcaption><b>화면 3 · 분석 결과 (휴대폰)</b> 이긴 경기에서도 팀마다 범인을 뽑습니다. 휴대폰에서는 요약, 범인 카드, 10명 평가를 차례로 보여 줍니다. <span class="ex">실제 화면 · 시연 데이터</span></figcaption></figure>
|
||||
<div>
|
||||
<h3 style="margin-top:0">결과 화면에 들어가는 것</h3>
|
||||
<table>
|
||||
<tr><th>칸</th><th>내용</th></tr>
|
||||
<tr><td>한 줄 요약</td><td>경기가 어떻게 흘러갔는지 1~2문장</td></tr>
|
||||
<tr><td>팀별 범인</td><td>팀마다 1명. 평점, 이유 2~3문장, 근거 3~4개(대화 · 킬 · 경제 · 스탯)</td></tr>
|
||||
<tr><td>10명 평가</td><td>평점(10점 만점, 0.5 단위), 태그, 한 줄 평. 음성 유무 표시</td></tr>
|
||||
<tr><td>분석 정보</td><td>분석 시각, 모델, 쓴 문장 · 이벤트 수, 실제 비용</td></tr>
|
||||
<tr><td>주의 문구</td><td>“재미로 보는 AI 분석입니다. 음성 인식 오류나 기록에 없는 상황 때문에 틀릴 수 있어요.”</td></tr>
|
||||
</table>
|
||||
<h3>분석하는 동안</h3>
|
||||
<p>버튼을 누르면 결과 자리에 진행 단계가 나옵니다: <b>기록 모으기 → AI가 읽는 중 → 근거 확인 → 완료</b>. 창을 닫아도 분석은 계속되고, 끝나면 사이트 실시간 알림으로 결과가 뜹니다. 같은 경기를 다른 사람이 동시에 눌러도 한 번만 돕니다.</p>
|
||||
<h3>결과를 보는 사람 · 다시 분석</h3>
|
||||
<ul>
|
||||
<li>결과는 사이트에 로그인한 서버 멤버 모두가 봅니다 (기존 기록과 같은 권한).</li>
|
||||
<li>한 경기는 한 번만 분석합니다. 다시 분석은 관리자만 할 수 있고, 이전 결과는 기록으로 남깁니다.</li>
|
||||
<li>사이트 <b>경기</b> 화면에도 “🔍 범인 보기” 버튼을 달아 바로 옮겨 갑니다.</li>
|
||||
</ul>
|
||||
</div></div>
|
||||
|
||||
<h2 style="margin-top:14px"><span class="num">3</span>범인을 고르는 기준</h2>
|
||||
<div class="callout"><b class="t">"범인"의 뜻 (정함 · ①)</b>
|
||||
<b>팀마다 1명</b>을 고르고, 아래 셋을 <b>모두 합쳐 종합으로</b> 판단합니다. 한 가지만 보지 않습니다.
|
||||
<ul style="margin:4px 0 0"><li><b>가장 못한 사람</b>: 자기 역할 · 포지션 기준으로 플레이가 가장 나빴다</li>
|
||||
<li><b>가장 발목을 잡은 사람</b>: 팀의 계획 · 경제 · 콜을 가장 많이 망쳤다</li>
|
||||
<li><b>결과의 원인</b>: 진 팀이면 패배에 가장 큰 책임, 이긴 팀이면 이기는 데 가장 방해가 된 사람</li></ul>
|
||||
그래서 이긴 경기에도 범인이 있습니다. 범인은 그 팀에서 평점이 가장 낮아야 합니다(서버가 확인).</div>
|
||||
<table>
|
||||
<tr><th style="width:18%">보는 것</th><th>발로란트</th><th>리그 오브 레전드</th></tr>
|
||||
<tr><td>플레이</td><td>첫 킬 · 첫 데스, 전투 점수(ACS), 라운드당 피해량, 클러치, 스파이크 설치 · 해체, 연속 데스</td><td>포지션별 기준: 라인 CS · 골드 차, 킬 관여율, 딜량 · 받은 피해, 데스 시점(오브젝트 직전 등)</td></tr>
|
||||
<tr><td>팀 운영</td><td>경제(혼자 장비 안 사기 · 세이브 무시), 요원 역할 수행(연막 · 정찰 · 부활)</td><td>드래곤 · 바론 · 전령 · 포탑 관여, 시야 점수, 한타 합류</td></tr>
|
||||
<tr><td>소통 (음성 · 채팅)</td><td colspan="2">정확한 콜, 콜 무시(“기다려” 뒤 혼자 진입 등), 남 탓 · 짜증, 포기 발언(“ff”), 팀 분위기를 살린 말</td></tr>
|
||||
</table>
|
||||
<h3>공정하게 보는 규칙 (AI 지시문에 넣음)</h3>
|
||||
<ul>
|
||||
<li><b>KDA만 보지 않습니다.</b> 역할을 따집니다. 세이지 · 쓰레쉬처럼 킬이 적은 역할은 그 역할로 평가합니다.</li>
|
||||
<li><b>음성이 없는 사람은 소통 항목을 빼고</b> 플레이와 채팅으로만 평가합니다. 말이 없다고 깎지도, 말실수가 안 잡혔다고 올리지도 않습니다. 결과에 “게임 기록으로 판단”이라고 적습니다.</li>
|
||||
<li><b>근거 없는 말 금지.</b> 근거마다 실제 기록 번호(문장 · 이벤트 · 라운드)를 달게 하고, 서버가 그 번호가 이 경기에 정말 있는지 확인한 뒤에만 보여 줍니다. 없는 근거가 나오면 그 근거를 빼고, 범인 근거가 하나도 안 남으면 다시 분석합니다.</li>
|
||||
<li><b>음성 인식 오류를 감안</b>합니다. 뜻이 애매한 문장 하나로 범인을 정하지 않습니다.</li>
|
||||
<li><b>재미용 말투</b>: 가볍게 놀리되 욕설 · 외모 · 인신공격은 쓰지 않습니다. 녹음 제외한 사람의 대화는 애초에 없습니다.</li>
|
||||
</ul>
|
||||
</section>
|
||||
|
||||
<section class="page">
|
||||
<h2><span class="num">4</span>분석에 쓰는 기록 · 분석할 수 있는 경기</h2>
|
||||
<table>
|
||||
<tr><th style="width:22%">기록</th><th style="width:36%">원래 저장하던 것</th><th>범인찾기를 위해 더 저장 (구현 완료)</th></tr>
|
||||
<tr><td>음성 대화</td><td>유저별 문장, 시각, 경기 · 라운드 연결 (텍스트는 계속 남음)</td><td>없음. 음성 파일은 7일 뒤 지워져도 분석은 텍스트로 함</td></tr>
|
||||
<tr><td>발로란트 경기</td><td>10명 KDA · 전투 점수 · 랭크, 라운드 결과, 라운드별 경제(쓴 돈 · 무기), 킬(무기 · 헤드샷 · 위치)</td><td>선수별 준 피해 · 헤드샷 비율 · 첫킬/첫데스 · 설치/해체 · 스킬 사용 · 요원 역할, 라운드별 공격/수비 · 장비 값 · 선수별 킬/피해</td></tr>
|
||||
<tr><td>롤 경기</td><td>10명 KDA · CS · 골드 · 아이템, 골드 차 그래프, 킬 · 오브젝트 이벤트</td><td>포지션(추정), 챔피언 피해 · 받은 피해, 시야 점수 · 와드 설치/제거/제어 와드, 오브젝트 · 포탑 피해, CC 시간, 10분 · 15분 CS · 골드</td></tr>
|
||||
<tr><td>채팅</td><td>팀 · 전체 채팅 (API · OCR)</td><td>없음</td></tr>
|
||||
<tr><td>디스코드 ↔ 게임 계정</td><td>Riot ID로 누가 누구인지 연결</td><td>연결 안 된 화자는 디스코드 이름으로 보내고 “게임 계정 모름”으로 표시</td></tr>
|
||||
</table>
|
||||
<p class="small">이미 저장된 예전 경기는 지금 있는 기록만으로 분석합니다(피해량 · 시야 같은 지표 없이). 결과에 “기본 기록으로 분석”이라고 표시합니다.</p>
|
||||
|
||||
<h3>"기록이 전부 남아 있는" 경기 = 아래를 모두 만족</h3>
|
||||
<div class="dtree">
|
||||
<div class="col"><div class="qq">경기가 끝났나?</div><div class="noise">아니면: 목록에 안 보임</div></div><div class="ar">→</div>
|
||||
<div class="col"><div class="qq">경기 결과 상세(10명)를 받았나?</div><div class="noise">“결과 못 받음”</div></div><div class="ar">→</div>
|
||||
<div class="col"><div class="qq">녹음이 경기 처음~끝을 덮나? (1분 넘게 빈 곳 없음)</div><div class="noise">“녹음이 12분 뒤에 시작됨”</div></div><div class="ar">→</div>
|
||||
<div class="col"><div class="qq">그 시간 문장이 모두 텍스트로 바뀌었나?</div><div class="noise">“음성 변환 중” (잠시 뒤 가능)</div></div><div class="ar">→</div>
|
||||
<div class="col"><div class="ok"><b>분석 가능</b><br>이미 했으면 “분석 완료”</div></div>
|
||||
</div>
|
||||
<div class="callout warn"><b class="t">한계</b>
|
||||
<ul style="margin:2px 0">
|
||||
<li>겜녹이 봇은 한 디스코드 서버에서 음성채널 하나에만 들어갑니다. 그래서 <b>음성은 봇이 있는 채널 사람만</b> 있습니다. 보통 상대 팀은 게임 기록과 채팅으로만 평가합니다.</li>
|
||||
<li>내전에서 두 팀이 다른 채널로 나뉘면 한 팀 음성만 남습니다. 두 팀 모두 녹음하려면 봇이 한 채널씩 따로 들어가야 해서, 이번 기능 범위 밖으로 둡니다(필요하면 따로 계획).</li>
|
||||
<li>경기 기록은 게임 PC에만 있으므로 <b>게임 PC가 켜져 있어야</b> 분석하고 결과를 볼 수 있습니다(지금 사이트와 같음).</li>
|
||||
</ul></div>
|
||||
</section>
|
||||
|
||||
<section class="page">
|
||||
<h2><span class="num">5</span>구조 · 보안 · 개인정보</h2>
|
||||
<div class="pipe">
|
||||
<div class="st"><span class="n">1</span><b>브라우저</b>범인 분석 누름 → 사이트 서버</div>
|
||||
<div class="st"><span class="n">2</span><b>사이트 서버</b>로그인 · 권한 · 예산 · 하루 횟수 확인, 이 경기 잠금</div>
|
||||
<div class="st"><span class="n">3</span><b>게임 PC (기존 중계)</b>분석 가능 확인 후 분석 자료(압축 텍스트) 만들어 보냄</div>
|
||||
<div class="st"><span class="n">4</span><b>Claude API</b>서버가 호출 (스트리밍) · 정해진 JSON 형식으로 받음</div>
|
||||
<div class="st"><span class="n">5</span><b>사이트 서버</b>10명 · 근거 번호 확인, 실제 비용 기록</div>
|
||||
<div class="st"><span class="n">6</span><b>게임 PC</b>결과 저장 → 사이트 실시간 알림</div>
|
||||
</div>
|
||||
<ul>
|
||||
<li><b>API 키는 사이트 서버에만</b> 둡니다(환경 변수 <code>ANTHROPIC_API_KEY</code>, root만 읽기). 봇 토큰과 같은 원칙으로, exe에도 브라우저에도 가지 않습니다. 게임 PC가 직접 부르게 하면 키가 PC에 남아 꺼낼 수 있어서 쓰지 않습니다.</li>
|
||||
<li><b>결과는 게임 PC 기록 DB에 저장</b>합니다(새 표 <code>culprit_analyses</code>). 기록은 게임 PC에만 둔다는 지금 원칙을 지킵니다. 서버에는 비용 장부만 남깁니다(경기 번호 · 누른 사람 · 토큰 수 · 비용 · 시각, 대화 내용 없음).</li>
|
||||
<li><b>예산 장부</b>: 서버가 매번 실제 사용량(응답의 토큰 수)으로 비용을 계산해 쌓습니다. 월 상한을 넘으면 버튼을 잠급니다. Claude Console에도 지출 한도를 걸어 두 번 막습니다.</li>
|
||||
<li><b>AI 설정</b>: 지시문 · 지식 묶음은 6장, Claude Opus 5.5, 생각 깊이 high, 말투 중간맛, 출력은 JSON 형식 고정(구조화 출력), 출력 상한 32k 토큰. AI가 응답을 거절하면 Anthropic 서버가 권장 모델로 한 번 자동 재시도합니다. 실패하면 비용이 든 만큼만 기록하고, 다시 누를 수 있게 잠금을 풉니다.</li>
|
||||
</ul>
|
||||
<h3>AI에 보내는 자료 모양 (예시)</h3>
|
||||
<pre class="box"><span class="h"># 경기 발로란트 경쟁전 · 어센트 · 13:9 (우리 팀 승리) · 22라운드 · 46분</span>
|
||||
<span class="h"># 참가자 (번호 이름 팀 요원(역할) K/D/A ACS 라운드당피해 첫킬/첫데스 헤드샷 설치/해체 스킬사용 음성)</span>
|
||||
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
|
||||
<span class="c">[e1] R1 0:08 킬 P2 → P6 (클래식)</span>
|
||||
<span class="v">[u1] R3 0:05 P1: 현우야 같이 가 기다려 둘 있어</span>
|
||||
<span class="v">[u2] R3 0:09 P2: 아 그냥 간다 내가 뚫을게</span>
|
||||
<span class="c">[r3] R3 우리 공격 라운드 끝 · 패배(전멸) 2:1 · 평균 장비 우리 3,714 / 상대 3,582 · 선수 장비/피해: P1 2.4k/185 P2 4.3k/0 …</span>
|
||||
<span class="v">[u3] R5 0:02 도윤(게임 계정 모름): 나 돈 없어 세이브할게</span></pre>
|
||||
<p class="small">앱이 실제로 만드는 모양입니다(시연 경기). [u…] = 대화 문장, [e…] = 게임 이벤트, [c…] = 채팅, [r…] = 라운드 요약, [s:P…] = 그 사람 경기 전체 스탯 번호. AI는 근거를 이 번호로 답하고, 서버가 번호를 확인합니다. 숫자 덩어리(JSON)가 아니라 이런 줄글로 보내 토큰을 아낍니다.</p>
|
||||
<h3>개인정보</h3>
|
||||
<ul>
|
||||
<li>분석하면 그 경기의 <b>대화 텍스트</b>와 게임 기록이 Anthropic(Claude API)으로 갑니다. 음성 파일은 보내지 않습니다.</li>
|
||||
<li>Claude API로 보낸 내용은 기본적으로 AI 학습에 쓰이지 않고, Anthropic 정책에 정해진 기간만 보관됩니다.</li>
|
||||
<li>녹음 제외(/녹음제외)한 사람의 대화는 원래 없으므로 보내지 않습니다. 서버 로그에는 대화 내용을 남기지 않습니다.</li>
|
||||
<li>멤버 공지(⑥): 녹음 시작 안내(TTS) 문구를 “겜녹이가 이 음성채널을 녹음합니다. <b>녹음된 대화는 AI 경기 분석에 쓰일 수 있어요.</b> 녹음을 원하지 않으시면 녹음제외 명령을 입력해 주세요.”로 바꾸고 기본 음성을 다시 합성했습니다. 관리자가 문구를 직접 고친 PC는 그 문구를 그대로 둡니다.</li>
|
||||
</ul>
|
||||
</section>
|
||||
|
||||
|
||||
<section class="page">
|
||||
<h2><span class="num">6</span>범인찾기 프롬프트 · 지식 묶음</h2>
|
||||
<div class="callout info"><b class="t">"미리 학습"은 이렇게 합니다</b>
|
||||
Claude API는 우리가 모델을 따로 학습(파인튜닝)시킬 수 없습니다. 대신 <b>분석할 때마다 지시문과 지식 묶음을 경기 자료 앞에 같이 보냅니다</b>. 그래서 AI는 매번 게임 규칙 · 역할 기준 · 은어 · 음성 인식 오류를 “배운 상태”로 분석합니다. 이 부분은 경기마다 똑같아 프롬프트 캐시를 쓰면 1시간 안의 다음 분석부터 이 부분 값이 약 5%로 줄어듭니다(비용 계산에는 캐시 없이 넣었습니다).</div>
|
||||
<table>
|
||||
<tr><th style="width:30%">파일</th><th>내용</th></tr>
|
||||
<tr><td><code>prompt/system.md</code> 지시문 v1.1</td><td>역할 · 할 일 · 범인 기준(종합 판단) · 판단 원칙 · 태그 · 말투(중간맛) · 자료 약어 설명 · 출력 규칙</td></tr>
|
||||
<tr><td><code>prompt/knowledge-valorant.md</code></td><td>규칙 · 경제 · 역할별 기준 · 지표 기준 · 콜아웃 · 은어 · 음성 인식 오류 + 자동 갱신(요원 29명 역할 · 맵 13개 · 무기 가격)</td></tr>
|
||||
<tr><td><code>prompt/knowledge-lol.md</code></td><td>기본 규칙 · 포지션별 기준 · 지표 기준 · 은어 · 음성 인식 오류 + 자동 갱신(챔피언 173명 분류)</td></tr>
|
||||
<tr><td><code>prompt/output-schema.json</code></td><td>결과 JSON 형식: 요약 · 확신도 · 팀별 범인 · 10명 평가 · 근거 번호</td></tr>
|
||||
</table>
|
||||
<p class="small">파일은 <code>site/server/prompt/</code>에 있고(사이트 서버가 그대로 읽음) 전문은 부록에 있습니다. 토큰 세기 API(claude-opus-5-5)로 잰 고정 부분(지시문 + 지식 묶음 + 출력 형식)은 <b>발로란트 {FIX['valorant']:,} · 롤 {FIX['lol']:,}토큰</b>입니다. v1.1에서 글자 수로 잡은 3,900 · 5,000보다 많아서 7장 비용을 다시 계산했습니다(경기당 약 +$0.017).</p>
|
||||
|
||||
<h3>지식 묶음 = 손으로 쓴 부분 + 패치마다 자동 갱신하는 부분</h3>
|
||||
<div class="grid2">
|
||||
<div class="card"><h4>손으로 쓴 부분 (사람이 고침)</h4><ul style="margin:0">
|
||||
<li>경기 규칙 · 경제(발로) / 포지션 · 오브젝트(롤)</li>
|
||||
<li>역할 · 포지션별 평가 기준: 무엇을 잘하면 잘한 것인지</li>
|
||||
<li>지표 기준값: 전투 점수 · 라운드당 피해량 · 분당 CS · 시야 점수</li>
|
||||
<li>판단 함정: 에코 킬, 막판 정리 킬, 팀 세이브, 탱커 · 서폿 KDA</li>
|
||||
<li>콜아웃 · 은어 뜻: 원탭, 로테, 리테이크, 갱, 다이브, 던졌다, 버스 등</li>
|
||||
<li>음성 인식이 자주 틀리는 말: 앱 교정 사전 28개와 같은 목록</li></ul></div>
|
||||
<div class="card"><h4>자동 갱신 부분 (패치마다 새로 만듦)</h4><ul style="margin:0">
|
||||
<li>발로란트: 요원 이름과 역할(타격대 · 척후대 · 전략가 · 감시자), 맵, 무기 가격 ← valorant-api.com 한국어</li>
|
||||
<li>롤: 챔피언 이름과 분류 ← Riot Data Dragon 한국어 (지금 16.20.1)</li>
|
||||
<li>사이트 서버가 공식 데이터에서 하루에 한 번 새로 만들고, 못 받으면 파일의 스냅샷을 씀</li>
|
||||
<li>AI가 원래 모를 수 있는 최신 요원 · 무기(믹스 · 비토 · 웨이레이 · 테호 · 워든 등)를 채워 줌</li></ul></div>
|
||||
</div>
|
||||
|
||||
<h3>지시문의 핵심 규칙 (발췌)</h3>
|
||||
<pre class="box"><span class="h">판단 원칙</span>
|
||||
- 숫자보다 결과에 준 영향을 본다. 승부처의 실수는 무겁게, 승부가 갈린 뒤의 스탯과 에코 라운드 킬은 가볍게.
|
||||
- 역할로 평가한다. 킬이 적은 역할이 킬이 적다고 범인이 되지 않는다.
|
||||
- 음성X 인 사람은 소통 항목 없이 평가한다. 음성O 인 사람을 범인으로 고를 때는 플레이 근거가 최소 1개 있어야 한다.
|
||||
- "콜 무시"는 콜이 있었고, 다르게 움직인 것이 이벤트로 확인될 때만 쓴다.
|
||||
- 음성 인식 오류를 감안한다. 뜻이 분명하지 않은 문장은 근거로 쓰지 않는다.
|
||||
- 자료에 없는 것을 지어내지 않는다. 근거는 자료의 번호로만, 인용은 원문 그대로.
|
||||
<span class="h">출력</span> 10명 모두 · 팀마다 "범인" 태그 정확히 1명 · 범인은 그 팀 최저점 · 판단이 약하면 confidence 를 낮춤</pre>
|
||||
|
||||
<h3>프롬프트가 제대로 도는지 확인하는 방법</h3>
|
||||
<table>
|
||||
<tr><th style="width:4%">#</th><th style="width:38%">시험 경기 (테스트 자료로 만듦)</th><th>기대하는 결과</th></tr>
|
||||
<tr><td>1</td><td>킬이 적은 세이지 · 쓰레쉬가 부활 · 시야로 기여</td><td>범인이 되지 않고, 한 줄 평에 기여가 나옴</td></tr>
|
||||
<tr><td>2</td><td>상대 에코 라운드에서만 킬을 몰아 딴 사람</td><td>전투 점수만큼 높게 평가하지 않음</td></tr>
|
||||
<tr><td>3</td><td>“기다려” 콜 뒤 혼자 진입해 첫 데스 3번 (음성O)</td><td>범인. 근거에 대화 + 킬 이벤트가 같이 나옴</td></tr>
|
||||
<tr><td>4</td><td>음성X 팀원이 스탯은 평균</td><td>소통으로 감점 · 가점하지 않음</td></tr>
|
||||
<tr><td>5</td><td>음성 인식이 깨진 문장이 섞인 경기</td><td>깨진 문장을 근거로 쓰지 않음</td></tr>
|
||||
<tr><td>6</td><td>크게 이긴 경기</td><td>이긴 팀에서도 범인 1명, 말투가 과하지 않음</td></tr>
|
||||
</table>
|
||||
<p class="small">지시문이나 지식 묶음을 고칠 때마다 6경기를 다시 돌립니다(한 번에 약 $2.5). 결과 화면 아래에 👍 / 👎(이유 한 줄)를 달아, 친구들이 납득하지 못한 판정을 모아 지식 묶음을 고치는 데 씁니다.</p>
|
||||
</section>
|
||||
<section class="page">
|
||||
<h2><span class="num">7</span>비용 예상: $100로 몇 경기?</h2>
|
||||
<h3>가격 (Anthropic API, 100만 토큰당)</h3>
|
||||
<table>
|
||||
<tr><th>모델</th><th class="num">입력</th><th class="num">출력(생각 포함)</th><th>특징</th></tr>
|
||||
<tr class="hl"><td>Claude Opus 5.5 (추천)</td><td class="num">$4</td><td class="num">$20</td><td>가장 꼼꼼함. 대화 · 기록을 엮어 판단하는 데 유리</td></tr>
|
||||
<tr><td>Claude Sonnet 5.5</td><td class="num">$2</td><td class="num">$10</td><td>절반 가격. 품질은 실측으로 비교 필요</td></tr>
|
||||
<tr><td>Claude Haiku 4.5</td><td class="num">$1</td><td class="num">$5</td><td>가장 쌈. 긴 대화에서 근거를 놓칠 수 있음</td></tr>
|
||||
</table>
|
||||
<p class="small">한국어는 영어보다 토큰을 많이 씁니다. 계산에서는 한글 1글자 ≈ 1토큰으로 넉넉하게 잡았습니다. 배치(최대 24시간 안에 결과)로 보내면 모든 토큰이 반값이지만, 버튼을 누르고 기다리는 기능이라 기본은 즉시 분석입니다.</p>
|
||||
|
||||
<h3>경기 길이는 무작위: 이렇게 계산했습니다</h3>
|
||||
<table>
|
||||
<tr><th style="width:20%">바뀌는 값</th><th>계산 방법</th><th style="width:28%">결과 (10판 중 8판 범위)</th></tr>
|
||||
<tr><td>발로란트 길이</td><td>경기마다 두 팀 실력 차를 뽑고 라운드를 하나씩 진행. 13승제, 12:12면 2점 차가 날 때까지 연장. 라운드 = 구매 30초 + 교전 15~145초 + 끝 7초</td><td>{B['rounds_val']['p10']}~{B['rounds_val']['p90']}라운드, {B['minutes_val']['p10']:.0f}~{B['minutes_val']['p90']:.0f}분 (중간 {B['minutes_val']['p50']:.0f}분)</td></tr>
|
||||
<tr><td>롤 길이</td><td>12%는 15~22분 조기 항복, 나머지는 평균 31분 ±7분 (18~60분)</td><td>{B['minutes_lol']['p10']:.0f}~{B['minutes_lol']['p90']:.0f}분 (중간 {B['minutes_lol']['p50']:.0f}분)</td></tr>
|
||||
<tr><td>말하는 양</td><td>음성채널 전체가 1분에 하는 문장 수. 경기마다 무작위(중간 18문장, 조용한 방 9 · 말 많은 방 32)</td><td>경기당 {B['lines']['p10']:.0f}~{B['lines']['p90']:.0f}문장</td></tr>
|
||||
<tr><td>AI 생각 길이</td><td>자료가 길수록 길게, 경기마다 무작위</td><td>출력 {k(B['out']['p10'])}~{k(B['out']['p90'])} 토큰</td></tr>
|
||||
<tr><td>게임 비율</td><td>발로란트 · 롤 반반</td><td>입력 {k(B['in']['p10'])}~{k(B['in']['p90'])} 토큰</td></tr>
|
||||
</table>
|
||||
<p class="small">이 값으로 2만 경기의 비용을 계산하고, $100을 다 쓸 때까지 분석하는 시행을 1,500번 돌렸습니다. 실패 · 다시 분석 여유로 5%를 더 잡았습니다. 계산 코드: <code>docs/report/culprit/cost_sim.py</code></p>
|
||||
|
||||
<div class="viz"><div class="vt">경기당 비용 분포 (Opus 5.5, 2만 경기)</div><div class="vs">길고 말 많은 경기일수록 오른쪽. {usd(B['cost']['p99'])}를 넘는 경기는 100판 중 1판입니다.</div>{hist_svg()}</div>
|
||||
</section>
|
||||
|
||||
<section class="page">
|
||||
<h3 style="margin-top:0">경기 하나에 드는 토큰 (Opus 5.5, 평균)</h3>
|
||||
<table>
|
||||
<tr><th>부분</th><th class="num">토큰</th><th class="num">비용</th><th>설명</th></tr>
|
||||
<tr><td>지시문 · 지식 묶음 · 출력 형식</td><td class="num">약 {(FIX['valorant']+FIX['lol'])//2:,}</td><td class="num">{usd((FIX['valorant']+FIX['lol'])/2*4/1e6,3)}</td><td>토큰 세기 API 실측. 발로 {FIX['valorant']:,} · 롤 {FIX['lol']:,}</td></tr>
|
||||
<tr><td>경기 기록 (10명 · 라운드 · 이벤트)</td><td class="num">약 6,100</td><td class="num">$0.025</td><td>가정: 발로 약 8,100 · 롤 약 4,200. 시연 경기 실측: 발로 22라운드 약 9,400 · 롤 28분 약 1,900</td></tr>
|
||||
<tr><td>음성 대화</td><td class="num">약 {B['lines']['mean']*24:,.0f}</td><td class="num">{usd(B['lines']['mean']*24*4/1e6,3)}</td><td>평균 {B['lines']['mean']:.0f}문장 × 24토큰. <b>가장 크게 흔들리는 값</b></td></tr>
|
||||
<tr><td>채팅</td><td class="num">약 250</td><td class="num">$0.001</td><td></td></tr>
|
||||
<tr><td>AI 답 (10명 평가 · 범인 · 근거)</td><td class="num">약 3,300</td><td class="num">$0.066</td><td>JSON</td></tr>
|
||||
<tr><td>AI 생각</td><td class="num">약 {B['out']['mean']-3280:,.0f}</td><td class="num">{usd((B['out']['mean']-3280)*20/1e6,3)}</td><td>출력 값으로 계산. <b>비용의 절반 이상</b></td></tr>
|
||||
<tr class="hl"><td>합계</td><td class="num">입력 {B['in']['mean']:,.0f} · 출력 {B['out']['mean']:,.0f}</td><td class="num">{usd(B['cost']['mean'],3)}</td><td>발로 {usd(B['cost_val']['mean'])} · 롤 {usd(B['cost_lol']['mean'])}</td></tr>
|
||||
</table>
|
||||
|
||||
<div class="viz"><div class="vt">$100로 분석할 수 있는 경기 수</div><div class="vs">발로 · 롤 반반, 실패 · 다시 분석 여유 5% 포함. 빨간 막대가 추천 설정입니다.</div>{bars_html()}</div>
|
||||
|
||||
<table>
|
||||
<tr><th>설정</th><th class="num">경기당 평균</th><th class="num">$100당 경기 수 (5~95%)</th><th class="num">배치(반값)라면</th></tr>
|
||||
<tr class="hl"><td>Opus 5.5 · 생각 high (추천)</td><td class="num">{usd(B['cost']['mean'])}</td><td class="num">{opus['p50']} ({opus['p5']}~{opus['p95']})</td><td class="num">약 {opus['batch_p50']}</td></tr>
|
||||
<tr><td>Opus 5.5 · 생각 medium</td><td class="num">{usd(100/MED['mean']/1.05)}</td><td class="num">{MED['p50']} ({MED['p5']}~{MED['p95']})</td><td class="num">약 {MED['p50']*2:,}</td></tr>
|
||||
<tr><td>Sonnet 5.5</td><td class="num">{usd(B['cost']['mean']/2)}</td><td class="num">{PM['sonnet-5.5']['p50']:,}</td><td class="num">약 {PM['sonnet-5.5']['batch_p50']:,}</td></tr>
|
||||
<tr><td>Haiku 4.5</td><td class="num">{usd(B['cost']['mean']/4)}</td><td class="num">{PM['haiku-4.5']['p50']:,}</td><td class="num">약 {PM['haiku-4.5']['batch_p50']:,}</td></tr>
|
||||
</table>
|
||||
<table>
|
||||
<tr><th>Opus 5.5 · 방 분위기별</th><th class="num">발로란트만</th><th class="num">롤만</th><th class="num">반반</th></tr>
|
||||
<tr><td>조용한 방 (1분 9문장)</td><td class="num">{SC['quiet/valorant']['per100']}경기</td><td class="num">{SC['quiet/lol']['per100']}경기</td><td class="num">{SC['quiet/mix']['per100']}경기</td></tr>
|
||||
<tr class="hl"><td>보통 (1분 18문장)</td><td class="num">{SC['normal/valorant']['per100']}경기</td><td class="num">{SC['normal/lol']['per100']}경기</td><td class="num">{SC['normal/mix']['per100']}경기</td></tr>
|
||||
<tr><td>말 많은 방 (1분 32문장)</td><td class="num">{SC['loud/valorant']['per100']}경기</td><td class="num">{SC['loud/lol']['per100']}경기</td><td class="num">{SC['loud/mix']['per100']}경기</td></tr>
|
||||
</table>
|
||||
<div class="callout info"><b class="t">결론</b>
|
||||
Opus 5.5로 <b>$100이면 약 {opus['p50']}경기</b>(방 분위기에 따라 약 {SC['loud/mix']['per100']}~{SC['quiet/mix']['per100']}경기)입니다. 경기 길이가 무작위여도 판 수가 많아 평균에 가까워지므로, 가정한 조건 안에서는 1,500번 시행 중 10번에 9번꼴로 {opus['p5']}~{opus['p95']}경기(5~95% 범위)가 나왔습니다. 이 범위는 계산에 넣은 가정 안의 결과이고, 실제 비용을 보장하는 범위는 아닙니다. 더 크게 흔들리는 것은 <b>방에서 말하는 양</b>과 <b>AI가 생각하는 길이</b>입니다.<br>
|
||||
크레딧은 <b>11월 15일에 만료</b>됩니다. {opus['p50']}경기를 다 쓰려면 하루 {per_day:.0f}판씩 분석해야 하므로, 크레딧을 아끼려고 더 싼 모델을 쓸 이유는 적습니다. 그래서 Opus 5.5를 추천합니다.</div>
|
||||
<p class="small">고정 프롬프트는 실측값이고, 경기 기록 · 대화 양 · AI 생각 길이는 아직 가정값입니다. 실제 경기 3~5판을 분석하면 사이트 서버 비용 장부에 실제 토큰 · 비용이 남으므로, 그 값으로 이 표를 다시 고칩니다.</p>
|
||||
</section>
|
||||
|
||||
<section class="page">
|
||||
<h3 style="margin-top:0">예산이 새지 않게 막는 장치</h3>
|
||||
<table>
|
||||
<tr><th style="width:26%">장치</th><th>내용</th></tr>
|
||||
<tr><td>월 상한</td><td>$100 (설정 가능). 넘으면 버튼 잠금, 남은 예산을 화면에 표시</td></tr>
|
||||
<tr><td>경기당 상한</td><td>출력 32k 토큰 상한 + 입력이 너무 길면(대화 2,500문장 넘음) 잡담 구간을 줄여서 보냄 → 경기 하나가 약 $1을 넘지 않음</td></tr>
|
||||
<tr><td>하루 횟수</td><td>사이트 전체 하루 20회 (설정 가능)</td></tr>
|
||||
<tr><td>중복 방지</td><td>한 경기 한 번. 동시에 눌러도 한 번만 실행. 다시 분석은 관리자만</td></tr>
|
||||
<tr><td>두 번째 방어선</td><td>Claude Console 조직 지출 한도를 $100로 설정</td></tr>
|
||||
</table>
|
||||
</section>
|
||||
|
||||
<section class="page">
|
||||
<h2><span class="num">8</span>리플레이 동기화</h2>
|
||||
<div class="flow">
|
||||
<div class="s"><div class="ic">🎬</div><div class="t">리플레이 재생</div><div class="d">롤 · 발로란트<br>게임 안 리플레이</div></div>
|
||||
<div class="s"><div class="ic">👀</div><div class="t">exe가 알아챔</div><div class="d">어느 경기인지 찾아<br>기록이 있는지 확인</div></div>
|
||||
<div class="s"><div class="ic">💬</div><div class="t">팝업으로 물음</div><div class="d">“리플레이와<br>동기화하시겠습니까?”</div></div>
|
||||
<div class="s"><div class="ic">🔗</div><div class="t">동기화</div><div class="d">리플레이 시간 따라<br>대화 · 이벤트 · 음성</div></div>
|
||||
<div class="s"><div class="ic">⏩</div><div class="t">계속 따라감</div><div class="d">멈춤 · 배속 · 되감기<br>모두 따라감</div></div>
|
||||
</div>
|
||||
<div class="callout"><b class="t">정한 원칙 (⑦ · ⑧): API로 될 때만 넣습니다</b>
|
||||
게임이 <b>공식 · 비공식 API로 리플레이 재생 시간을 알려 줄 때만</b> 그 게임의 동기화를 만듭니다. 화면 글자 인식(OCR)으로 시간을 읽거나, 앱이 게임 설정 파일(game.cfg)을 고치는 방법은 쓰지 않습니다. 그래서 먼저 Windows PC에서 어떤 API가 리플레이 중에 무엇을 알려 주는지 확인(R0)하고, 되는 게임만 R1~R3을 진행합니다. 둘 다 안 되면 리플레이 동기화는 넣지 않습니다.</div>
|
||||
<figure><img class="shot" src="img/replay-popup.png" alt=""><figcaption><b>화면 예시 4 · 동기화 묻기 (exe 팝업)</b> 리플레이를 틀면 exe가 그 경기의 기록을 찾아 오른쪽 위에 묻습니다. 남은 기록(대화 텍스트 · 음성 파일 · 이벤트 · 범인 분석)을 보여 주고, 음성 파일이 7일이 지나 지워졌으면 “글자만 동기화”로 바뀝니다. 뒤 배경은 자리 표시용입니다. <span class="ex">시안 · API 확인 뒤 만듦</span></figcaption></figure>
|
||||
<figure><img class="shot" src="img/replay-sync.png" alt=""><figcaption><b>화면 예시 5 · 동기화 창 (exe)</b> 리플레이 시간(오른쪽 위)에 맞춰 지금 말하는 문장을 단어 단위로 짚고 음성을 들려 줍니다. 지나간 줄은 흐리게, 다음 줄은 미리 보입니다. 아래 막대는 경기 전체의 대화 · 킬 · 오브젝트 · 범인 근거 위치입니다. 리플레이를 옮기는 API까지 있으면 줄을 눌러 리플레이를 그 시간으로 옮깁니다. <span class="ex">시안 · 이름과 기록은 예시</span></figcaption></figure>
|
||||
</section>
|
||||
|
||||
<section class="page">
|
||||
<h3 style="margin-top:0">R0에서 확인할 것 (Windows PC, 리플레이 1판씩)</h3>
|
||||
<table>
|
||||
<tr><th style="width:16%"></th><th style="width:42%">리그 오브 레전드</th><th>발로란트</th></tr>
|
||||
<tr><td>리플레이</td><td>클라이언트 “경기 기록”에서 내려받아 재생 (.rofl 파일, 같은 패치 안에서만)</td><td>패치 12.10부터 <b>경쟁전 · 일반전 · 신속플레이 · 프리미어 · 사용자 지정 게임</b>, 친구 경기도 경력 탭에서 볼 수 있음. <b>내전(사용자 지정)은 방장이 경기마다 시작 전에 녹화를 켜야</b> 리플레이가 남음</td></tr>
|
||||
<tr><td>확인할 API</td><td>① 롤 클라이언트 로컬 API(LCU, 비공식): 리플레이 보는 중인지, 어느 경기(경기 번호)인지<br>② 게임 로컬 API(이 PC 안 <code>127.0.0.1:2999</code>): 설정을 바꾸지 않은 상태에서 리플레이 중에 게임 시간이 나오는지<br>③ 공식 Replay API(<code>/replay/playback</code>): 재생 시간 · 멈춤 · 배속 · 옮기기. <b>game.cfg 에 한 줄을 넣어야 켜지므로 앱이 켜지 않음</b>. 이미 켜져 있는 PC에서만 씀</td><td>① Riot 클라이언트 로컬 API(비공식, 지금 경기 감지에 쓰는 상태 정보): 리플레이 보는 중인지, 어느 경기인지<br>② 같은 API에서 리플레이 재생 시간이나 라운드가 나오는지</td></tr>
|
||||
<tr><td>되면</td><td>시간을 0.25초마다 읽어 동기화(목표 오차 ±0.5초). ③이 켜져 있으면 줄을 눌러 리플레이도 옮김</td><td>시간을 읽어 동기화. 정확도는 API가 주는 값의 간격에 따라 R0에서 정함</td></tr>
|
||||
<tr><td>안 되면</td><td colspan="2"><b>그 게임은 리플레이 동기화를 넣지 않습니다.</b> 화면 글자 인식(OCR) · 수동 맞춤 · 설정 파일 고치기로 대신하지 않습니다.</td></tr>
|
||||
<tr><td>확인 방법</td><td colspan="2">새 exe에 “리플레이 API 확인” 기능을 넣어, 리플레이를 1판씩 틀고 버튼을 누르면 위 API들이 리플레이 중에 무엇을 주는지 기록 파일로 남깁니다. 그 기록으로 게임별로 만들지 정합니다.</td></tr>
|
||||
</table>
|
||||
|
||||
<h3>시간을 맞추는 원리</h3>
|
||||
<ul>
|
||||
<li>겜녹이는 경기마다 <b>게임 시간</b>(킬 · 라운드 이벤트)과 <b>실제 시각</b>(음성 문장)을 같이 저장하고, 둘의 차이를 이미 맞춰 둡니다(지금 사이트의 “R7 · 0:42” 표시가 이 값).</li>
|
||||
<li>롤: 리플레이 재생 시간 = 게임 시간 → 실제 시각 = 경기 시작 시각 + 재생 시간. 그 시각의 음성 문장과 이벤트를 띄웁니다.</li>
|
||||
<li>발로란트: API가 주는 리플레이 시간(또는 라운드 + 라운드 안 시간) → Riot 경기 결과에 있는 그 라운드 시작 게임 시간 → 실제 시각.</li>
|
||||
<li>조금 어긋나면 동기화 창의 <b>±0.5초</b> 버튼으로 맞추고, 그 경기에 저장합니다.</li>
|
||||
</ul>
|
||||
|
||||
<h3>팝업 · 음성 재생 규칙</h3>
|
||||
<ul>
|
||||
<li><b>묻는 조건</b>: 그 경기 기록(대화 텍스트나 이벤트)이 있을 때만 묻습니다. 어느 경기인지 하나로 정하지 못하면 후보 경기(맵 · 점수 · 날짜 · 길이)를 보여 주고 고르게 합니다. 기록이 없거나, 녹음 중이거나, “이 경기는 다시 묻지 않기”를 고른 경기는 묻지 않습니다.</li>
|
||||
<li><b>전체 화면 게임</b>: 게임이 “전체 화면” 모드면 다른 창이 위에 뜨지 못합니다. 그때는 알림 소리 + Windows 알림을 보내고, 게임 안에서 <b>Ctrl+Shift+G</b>(동기화) · <b>Ctrl+Shift+H</b>(무시)로 답할 수 있게 합니다. “테두리 없는 창 모드”를 권합니다.</li>
|
||||
<li><b>동기화 창</b>: exe의 새 창입니다. 두 번째 모니터에 두거나, 📌 항상 위 · 작게 보기로 게임 옆에 띄웁니다.</li>
|
||||
<li><b>음성</b>: 리플레이를 멈추면 같이 멈추고, 되감으면 그 지점부터 다시 들려 줍니다. 2배속까지는 같이 빨라지고, 더 빠르면 글자만 보여 줍니다. 여러 명이 동시에 말한 구간은 겹쳐서 재생합니다. 음성 파일이 지워진 경기는 글자만 보여 줍니다.</li>
|
||||
<li><b>범인 분석과 연결</b>: 분석 결과가 있으면 범인 근거 순간에 🔍 표시를 붙입니다.</li>
|
||||
<li><b>보안 · 비용</b>: 모두 이 PC 안(127.0.0.1)에서만 일어나고 사이트 서버 · 인터넷 · AI를 쓰지 않습니다. 비용 0. 게임 메모리를 읽거나 게임 파일 · 설정 파일을 고치지 않고, 화면을 읽지도 않습니다. Riot 로컬 API의 자체 서명 인증서는 지금처럼 이 PC 안 주소에만 예외를 둡니다.</li>
|
||||
</ul>
|
||||
</section>
|
||||
|
||||
<section class="page">
|
||||
|
||||
<h2 style="margin-top:0"><span class="num">9</span>만드는 순서 · 진행 상황</h2>
|
||||
<table>
|
||||
<tr><th style="width:15%">단계</th><th>할 일</th><th style="width:30%">확인 방법</th><th style="width:11%">상태</th></tr>
|
||||
<tr><td><b>C1</b> 기록 보강</td><td>경기 상세에서 추가 지표 저장(4장). “분석 가능” 판정(경기 결과 · 녹음 공백 1분 · 음성 변환). 근거 번호가 달린 분석 자료 만들기, 결과 저장. 녹음 안내 문구에 AI 분석 안내</td><td>시연 22라운드 · 롤 경기로 판정 · 자료 모양 자동 테스트. 녹음 늦게 시작 · 변환 대기 · 녹음 제외 경기가 막히는지</td><td class="done">완료</td></tr>
|
||||
<tr><td><b>C2</b> 서버 분석</td><td>Claude 호출(구조화 출력), 근거 번호 확인, 예산 장부 · 하루 횟수 · 중복 방지, 결과를 게임 PC에 저장</td><td>가짜 AI 응답 자동 테스트(없는 근거 · 빠진 사람 · 예산 초과 · 동시 클릭 · 거절). 실제 Claude 1회 호출 성공</td><td class="done">완료</td></tr>
|
||||
<tr><td><b>C3</b> 화면</td><td>범인찾기 탭, 진행 단계, 결과 화면(PC · 휴대폰), 근거 → 듣기 · 타임라인, 경기 화면 버튼</td><td>실제 앱 코어 + 사이트 서버 + 브라우저로 화면 캡처(2장), 보안 정책(CSP) 위반 · 오류 없음</td><td class="done">완료</td></tr>
|
||||
<tr><td><b>C5</b> 배포</td><td>사이트 서버 배포(API 키 넣기), 앱 새 버전(v1.3.0) exe 빌드 · 릴리스</td><td>배포 전 백업, 배포 뒤 상태 확인 · 실제 분석 1회</td><td class="todo">승인 대기</td></tr>
|
||||
<tr><td><b>C4</b> 실측 · 조정</td><td>새 exe로 실제 경기 3~5판 분석, 결과 품질과 실제 비용 확인, 지시문 · 지식 묶음 · 생각 깊이 조정, 7장 표 갱신</td><td>같이 결과 검토 (범인 판정이 납득되는지)</td><td class="todo">배포 뒤</td></tr>
|
||||
<tr><td><b>R0</b> 리플레이 API 확인</td><td>새 exe의 “리플레이 API 확인” 기능으로 롤 · 발로란트 리플레이 중 API가 주는 값 기록(8장)</td><td>롤 리플레이 1판, 발로란트 리플레이 1판</td><td class="todo">배포 뒤</td></tr>
|
||||
<tr><td><b>R1~R3</b> 리플레이 동기화</td><td>R0에서 API로 시간을 읽을 수 있는 게임만: 감지 · 팝업, 동기화 창(시간 따라가기 · 음성 · 범인 근거 표시)</td><td>가짜 API로 자동 테스트, 실제 리플레이로 멈춤 · 배속 · 되감기 따라가는지</td><td class="todo">R0 결과에 따라</td></tr>
|
||||
</table>
|
||||
<p class="small">예전 exe로도 사이트는 열리지만 범인찾기는 “게임 PC 앱을 업데이트해 주세요”로 막습니다. 코드: 앱 <code>app/src/core/culprit.ts</code>, 서버 <code>site/server/src/culprit.ts</code>, 화면 <code>site/web/src/pages/CulpritPage.tsx</code>.</p>
|
||||
|
||||
<h2 style="margin-top:14px"><span class="num">10</span>정한 것 · 남은 일</h2>
|
||||
<table>
|
||||
<tr><th style="width:24%">질문</th><th style="width:30%">답 (2026-10-15)</th><th>반영</th></tr>
|
||||
<tr><td>① "범인"의 뜻</td><td>가장 못했다 + 가장 발목을 잡았다 + 패배의 원인 등 모두 종합</td><td>지시문 v1.1에 세 기준을 종합하도록 넣음. 팀마다 1명, 팀 최저점(서버 확인)</td></tr>
|
||||
<tr><td>② 분석 버튼</td><td>(가) 등록된 앱 유저 이상</td><td>서버가 앱 유저 명단으로 확인. 다시 분석은 관리자 이상, 결과 보기는 모두</td></tr>
|
||||
<tr><td>③ 모델</td><td>Opus 5.5</td><td>Claude Opus 5.5 · 생각 깊이 high</td></tr>
|
||||
<tr><td>④ API 키</td><td>받음</td><td>동작 확인. 서버 비밀 저장소에만 보관, 배포 때 사이트 서버 환경 변수로만 넣음</td></tr>
|
||||
<tr><td>⑤ 말투</td><td>(나) 중간맛</td><td>기본 말투 medium</td></tr>
|
||||
<tr><td>⑥ 멤버 공지</td><td>TTS 문구에 추가</td><td>녹음 안내 문구 · 기본 음성 교체 (5장)</td></tr>
|
||||
<tr><td>⑦ 발로란트 리플레이</td><td>비공식 API에 없으면 추가하지 않기</td><td>OCR 안 함. R0에서 API 확인 뒤 결정 (8장)</td></tr>
|
||||
<tr><td>⑧ 롤 리플레이</td><td>비공식 API에 없으면 추가하지 않기</td><td>앱이 game.cfg 를 고치지 않음. R0에서 API 확인 뒤 결정 (8장)</td></tr>
|
||||
</table>
|
||||
<div class="q"><div class="qh"><span class="id">A</span>배포 승인</div>사이트 서버 배포(API 키 넣기)와 새 exe(v1.3.0) 릴리스를 진행해도 될지. <span class="rec">→ 승인하시면 배포하고, 새 exe로 실제 경기 3~5판을 분석해 같이 결과를 봅니다(C4).</span></div>
|
||||
<div class="q"><div class="qh"><span class="id">B</span>API 키 관리</div>키가 디스코드 채팅에 그대로 올라왔습니다. <span class="rec">→ 그 메시지를 지워 주시고, 오래 쓰실 거면 Console에서 키를 새로 만들어 주세요. Console 월 지출 한도 $100도 걸어 두시면 사이트 서버 한도와 함께 두 번 막힙니다.</span></div>
|
||||
<div class="q"><div class="qh"><span class="id">C</span>리플레이 API 확인 (R0)</div>새 exe에 “리플레이 API 확인” 기능을 같이 넣을지. <span class="rec">→ 넣으면 리플레이를 1판씩 틀고 버튼만 눌러 주시면 됩니다. 롤 Replay API를 이미 켜 둔 PC가 아니면, 롤은 클라이언트 API 결과로만 정합니다.</span></div>
|
||||
</section>
|
||||
|
||||
<section class="page">
|
||||
<h2><span class="num">부록</span>프롬프트 · 지식 묶음 · 출력 형식 원문</h2>
|
||||
<p class="small">사이트 서버가 실제로 쓰는 원문(<code>site/server/prompt/</code>, 지시문 v1.1). 실제 경기 분석(C4)과 시험 경기(6장)를 거치며 고칩니다. 지시문의 tone 자리는 말투 설정(중간맛)으로 바뀌고, 자동 갱신 칸은 사이트 서버가 하루에 한 번 공식 데이터로 다시 만듭니다.</p>
|
||||
<h3>A. 지시문 <code>prompt/system.md</code></h3>
|
||||
<pre class="box ap">{_load('system.md')}</pre>
|
||||
<h3>B. 발로란트 지식 묶음 <code>prompt/knowledge-valorant.md</code></h3>
|
||||
<pre class="box ap">{_load('knowledge-valorant.md')}</pre>
|
||||
<h3>C. 롤 지식 묶음 <code>prompt/knowledge-lol.md</code></h3>
|
||||
<pre class="box ap">{_load('knowledge-lol.md')}</pre>
|
||||
<h3>D. 출력 형식 <code>prompt/output-schema.json</code></h3>
|
||||
<pre class="box ap">{_load('output-schema.json')}</pre>
|
||||
</section>
|
||||
</body></html>'''
|
||||
open('plan.html', 'w').write(HTML)
|
||||
print('ok', len(HTML))
|
||||
141
docs/report/culprit/cost_sim.py
Normal file
@@ -0,0 +1,141 @@
|
||||
"""범인찾기 분석 비용 몬테카를로 추정 (계획서용).
|
||||
|
||||
경기 길이·말하는 양·모델 생각 길이를 무작위로 뽑아 경기당 토큰과 비용을 만들고,
|
||||
$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'},
|
||||
}
|
||||
|
||||
# ── 토큰 가정 ──
|
||||
# 지시문(prompt/system.md) + 게임별 지식 묶음(prompt/knowledge-*.md) + 출력 형식(prompt/output-schema.json).
|
||||
# 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)
|
||||
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[game] + 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))
|
||||
BIN
docs/report/culprit/img/culprit-list.png
Normal file
|
After Width: | Height: | Size: 633 KiB |
BIN
docs/report/culprit/img/culprit-mobile-lol.png
Normal file
|
After Width: | Height: | Size: 543 KiB |
BIN
docs/report/culprit/img/culprit-result.png
Normal file
|
After Width: | Height: | Size: 1.2 MiB |
BIN
docs/report/culprit/img/real-list.png
Normal file
|
After Width: | Height: | Size: 472 KiB |
BIN
docs/report/culprit/img/real-mobile.png
Normal file
|
After Width: | Height: | Size: 752 KiB |
BIN
docs/report/culprit/img/real-result.png
Normal file
|
After Width: | Height: | Size: 1.2 MiB |
BIN
docs/report/culprit/img/replay-popup.png
Normal file
|
After Width: | Height: | Size: 1.6 MiB |
BIN
docs/report/culprit/img/replay-sync.png
Normal file
|
After Width: | Height: | Size: 447 KiB |
18
docs/report/culprit/mock/common.css
Normal file
@@ -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)}
|
||||
84
docs/report/culprit/mock/culprit-list.html
Normal file
@@ -0,0 +1,84 @@
|
||||
<!doctype html><html lang="ko"><head><meta charset="utf-8"><link rel="stylesheet" href="common.css"><style>body{height:800px}</style>
|
||||
<style>
|
||||
main{flex:1;display:grid;grid-template-columns:520px 1fr;gap:18px;padding:20px 24px;min-height:0}
|
||||
.list{display:flex;flex-direction:column;gap:8px;overflow:hidden}
|
||||
.flt{display:flex;gap:8px;margin-bottom:6px}
|
||||
.m{display:flex;align-items:center;gap:12px;padding:11px 12px;border-radius:10px;background:var(--panel2);border:1px solid var(--line)}
|
||||
.m.sel{outline:2px solid var(--accent);background:linear-gradient(90deg,rgba(255,70,85,.13),var(--panel2))}
|
||||
.m.off{opacity:.55}
|
||||
.m .bar{width:4px;align-self:stretch;border-radius:2px}
|
||||
.m .t{flex:1}
|
||||
.m .t b{font-size:15px} .m .t .s{font-size:12px;color:var(--muted);margin-top:2px}
|
||||
.m .sc{font-weight:800;font-size:17px;width:62px;text-align:center}
|
||||
.right{display:flex;flex-direction:column;gap:14px;min-height:0}
|
||||
.hero{display:flex;align-items:center;gap:20px;background:linear-gradient(100deg,#13222f,#1a1420);border:1px solid var(--line);border-radius:14px;padding:18px 22px}
|
||||
.hero .big{font-size:30px;font-weight:800}
|
||||
.two{display:grid;grid-template-columns:1fr 1fr;gap:14px}
|
||||
.ck{display:flex;align-items:center;gap:10px;padding:7px 0;border-bottom:1px solid #1c2b39;font-size:14px}
|
||||
.ck i{font-style:normal;width:22px;height:22px;border-radius:50%;background:#0f2a22;color:#7fe0b8;display:flex;align-items:center;justify-content:center;font-size:12px;font-weight:900}
|
||||
.ck .v{margin-left:auto;color:var(--muted);font-size:13px}
|
||||
.pl{display:flex;align-items:center;gap:8px;padding:4px 0;font-size:13.5px}
|
||||
.pl .d{margin-left:auto;color:var(--muted);font-size:12px}
|
||||
.mic{font-size:11px;color:#7fe0b8}
|
||||
.go{display:flex;align-items:center;gap:18px;background:var(--panel);border:1px solid #5a2029;border-radius:14px;padding:16px 20px}
|
||||
.go .btn.primary{font-size:17px;padding:14px 26px;border-radius:10px;box-shadow:0 6px 24px rgba(255,70,85,.35)}
|
||||
.cost b{color:var(--ink)}
|
||||
</style></head><body>
|
||||
<header>
|
||||
<div class="brand"><img src="../../../../assets/app/icon.png" alt=""><div><div class="nm">겜녹이</div><div class="en">GAME VOICE RECORDER</div></div></div>
|
||||
<span class="chip">타임라인</span><span class="chip">경기</span><span class="chip">유저</span><span class="chip">단어사전</span><span class="chip on new">🔍 범인찾기</span>
|
||||
<div class="search">🔍 대화 내용 검색 (예: 스파이크)</div>
|
||||
<div class="conn">● 게임 PC 연결됨</div><div class="me"><span class="av" style="background:#5865f2;width:26px;height:26px">승</span>승한</div>
|
||||
</header>
|
||||
<main>
|
||||
<div class="panel list">
|
||||
<h4><span>끝난 경기 · 범인 분석할 경기를 고르세요</span><span>최근 7일</span></h4>
|
||||
<div class="flt"><span class="chip on">전체</span><span class="chip">발로란트</span><span class="chip lol">롤</span><span class="chip">분석 가능만</span></div>
|
||||
<div class="m sel"><span class="bar" style="background:#5a6675"></span><span class="tag val">VAL</span><div class="t"><b>어센트</b><div class="s">경쟁전 · 오늘 22:41 · 44분 · 24라운드</div></div><span class="sc"><span style="color:#c8d0d8">11 : 13</span></span><span class="tag ok">분석 가능</span></div>
|
||||
<div class="m"><span class="bar" style="background:var(--mint)"></span><span class="tag lol">LoL</span><div class="t"><b>소환사의 협곡</b><div class="s">내전 · 오늘 21:55 · 38분</div></div><span class="sc" style="color:var(--mint)">승</span><span class="tag done">분석 완료</span></div>
|
||||
<div class="m"><span class="bar" style="background:var(--mint)"></span><span class="tag val">VAL</span><div class="t"><b>바인드</b><div class="s">경쟁전 · 오늘 21:02 · 33분 · 19라운드</div></div><span class="sc"><span style="color:var(--mint)">13 : 6</span></span><span class="tag ok">분석 가능</span></div>
|
||||
<div class="m"><span class="bar" style="background:#5a6675"></span><span class="tag lol">LoL</span><div class="t"><b>소환사의 협곡</b><div class="s">솔로 랭크 · 오늘 20:11 · 19분 (항복)</div></div><span class="sc" style="color:#c8d0d8">패</span><span class="tag ok">분석 가능</span></div>
|
||||
<div class="m off"><span class="bar" style="background:var(--mint)"></span><span class="tag val">VAL</span><div class="t"><b>로터스</b><div class="s">경쟁전 · 어제 23:30 · 녹음이 12분 뒤에 시작됨</div></div><span class="sc"><span style="color:var(--mint)">13 : 10</span></span><span class="tag no">기록 부족</span></div>
|
||||
<div class="m off"><span class="bar" style="background:#5a6675"></span><span class="tag lol">LoL</span><div class="t"><b>소환사의 협곡</b><div class="s">솔로 랭크 · 어제 22:48 · 결과 못 받음</div></div><span class="sc" style="color:#c8d0d8">패</span><span class="tag no">기록 부족</span></div>
|
||||
<div class="m off"><span class="bar" style="background:#5a6675"></span><span class="tag val">VAL</span><div class="t"><b>헤이븐</b><div class="s">스파이크 러시 · 어제 22:10 · 음성 변환 중</div></div><span class="sc" style="color:#c8d0d8">2 : 4</span><span class="tag wait">준비 중</span></div>
|
||||
</div>
|
||||
<div class="right">
|
||||
<div class="hero">
|
||||
<img src="../../mock/assets/val/map-ascent.png" style="width:64px;height:64px;border-radius:10px;background:#16293a">
|
||||
<div><div class="h" style="font-size:12px;color:var(--accent);font-weight:800;letter-spacing:2px">VALORANT · 경쟁전</div>
|
||||
<div class="big h">어센트 <span style="color:#c8d0d8">11 : 13</span> <span class="tag no" style="font-size:13px;vertical-align:6px">패배</span></div></div>
|
||||
<div class="muted" style="font-size:13px;line-height:1.7;margin-left:12px">오늘 22:41 시작 · 44분 12초 · 24라운드<br>음성채널 #발로 음성방 · 4명 녹음</div>
|
||||
</div>
|
||||
<div class="two">
|
||||
<div class="panel">
|
||||
<h4><span>분석에 쓰는 기록</span><span class="tag ok">모두 있음</span></h4>
|
||||
<div class="ck"><i>✓</i>경기 결과 · 10명 스탯 · 라운드별 경제<span class="v">24라운드</span></div>
|
||||
<div class="ck"><i>✓</i>킬 · 스파이크 · 라운드 결과 이벤트<span class="v">211개</span></div>
|
||||
<div class="ck"><i>✓</i>음성 대화 (텍스트 변환 완료)<span class="v">742문장</span></div>
|
||||
<div class="ck"><i>✓</i>인게임 채팅 (팀 · 전체)<span class="v">18개</span></div>
|
||||
<div class="ck" style="border:none"><i>✓</i>녹음이 경기 시작부터 끝까지 이어짐<span class="v">100%</span></div>
|
||||
<div class="small dim" style="font-size:12px;margin-top:8px">음성 파일은 7일 뒤 지워져도 괜찮습니다. 분석은 텍스트로 합니다.</div>
|
||||
</div>
|
||||
<div class="panel">
|
||||
<h4><span>참가자 10명</span><span>음성 = 대화 기록 있음</span></h4>
|
||||
<div class="pl"><img class="ag" src="../../mock/assets/val/a-jett.png">승한 <span class="tag ok" style="font-size:10px;padding:0 5px">음성</span><span class="d">우리 팀 · 제트</span></div>
|
||||
<div class="pl"><img class="ag" src="../../mock/assets/val/a-sova.png">민수 <span class="tag ok" style="font-size:10px;padding:0 5px">음성</span><span class="d">우리 팀 · 소바</span></div>
|
||||
<div class="pl"><img class="ag" src="../../mock/assets/val/a-sage.png">지우 <span class="tag ok" style="font-size:10px;padding:0 5px">음성</span><span class="d">우리 팀 · 세이지</span></div>
|
||||
<div class="pl"><img class="ag" src="../../mock/assets/val/a-omen.png">현우 <span class="tag ok" style="font-size:10px;padding:0 5px">음성</span><span class="d">우리 팀 · 오멘</span></div>
|
||||
<div class="pl"><img class="ag" src="../../mock/assets/val/a-phoenix.png">Duck#KR3<span class="d">우리 팀 · 피닉스</span></div>
|
||||
<div class="pl dim" style="font-size:12.5px">상대 팀 5명: Lumi · Nox · Mint · Kiwi · Haru <span class="d">게임 기록 · 채팅만</span></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="go">
|
||||
<span class="btn primary">🔍 범인 분석</span>
|
||||
<div class="cost muted" style="font-size:13.5px;line-height:1.75">예상 비용 <b>약 $0.45</b> · 1~2분 걸림<br>이번 달 남은 분석 예산 <b>$81.30</b> / $100 · 오늘 남은 횟수 <b>17회</b></div>
|
||||
<div class="muted" style="margin-left:auto;font-size:12px;text-align:right;line-height:1.6">한 경기는 한 번만 분석하고<br>결과는 모두가 같이 봅니다</div>
|
||||
</div>
|
||||
<div class="panel" style="flex:1">
|
||||
<h4><span>최근 범인 판정</span><span>전체 보기 →</span></h4>
|
||||
<div class="ck"><span class="tag lol">LoL</span>내전 · 오늘 21:55 · 승<span class="v">우리 팀 <b style="color:var(--accent)">민수</b> (리 신) · 상대 팀 <b style="color:var(--accent)">Mint</b> (가렌)</span></div>
|
||||
<div class="ck"><span class="tag val">VAL</span>스플릿 · 어제 21:40 · 13:8 승<span class="v">우리 팀 <b style="color:var(--accent)">지우</b> (세이지) · 상대 팀 <b style="color:var(--accent)">Haru</b> (레이나)</span></div>
|
||||
<div class="ck" style="border:none"><span class="tag lol">LoL</span>솔로 랭크 · 어제 20:05 · 패<span class="v">우리 팀 <b style="color:var(--accent)">현우</b> (아리) · 상대 팀 <b style="color:var(--accent)">Nox</b> (쓰레쉬)</span></div>
|
||||
</div>
|
||||
</div>
|
||||
</main></body></html>
|
||||
59
docs/report/culprit/mock/culprit-mobile-lol.html
Normal file
@@ -0,0 +1,59 @@
|
||||
<!doctype html><html lang="ko"><head><meta charset="utf-8"><link rel="stylesheet" href="common.css">
|
||||
<style>
|
||||
body{width:430px;height:1190px;padding:0}
|
||||
.mh{height:54px;flex:none;display:flex;align-items:center;gap:10px;padding:0 14px;border-bottom:2px solid;border-image:linear-gradient(90deg,var(--accent),var(--lol) 60%,transparent) 1;background:#0f1b26}
|
||||
.mh .brand img{width:28px;height:28px} .mh .brand .nm{font-size:17px}
|
||||
main{padding:12px;display:flex;flex-direction:column;gap:10px}
|
||||
.hero{border-radius:12px;padding:12px 14px;background:linear-gradient(120deg,#1a1a12,#121e29);border:1px solid #4a3d22}
|
||||
.hero .big{font-size:20px;font-weight:800}
|
||||
.hero .s{font-size:13.5px;line-height:1.55;margin-top:6px}
|
||||
.cc{border-radius:12px;padding:12px 14px;background:linear-gradient(160deg,#2a1219,#141e29 60%);border:1px solid #6a2430}
|
||||
.cc .lab{font-size:11px;letter-spacing:2px;color:var(--accent);font-weight:800}
|
||||
.cc .who{display:flex;align-items:center;gap:10px;margin:6px 0}
|
||||
.cc .who img{width:46px;height:46px;border-radius:10px;border:2px solid var(--accent)}
|
||||
.cc .nm{font-size:19px;font-weight:800}
|
||||
.cc .nm small{font-size:12px;color:var(--muted);font-weight:500;margin-left:4px}
|
||||
.cc .why{font-size:13.5px;line-height:1.6}
|
||||
.ev{display:flex;gap:8px;padding:5px 8px;border-radius:7px;background:rgba(11,20,28,.55);margin-top:5px;font-size:12.5px}
|
||||
.ev .t{font-family:"D2Coding ligature",monospace;color:var(--mint);font-size:11.5px;flex:none;width:40px}
|
||||
.sec{font-size:12px;color:var(--muted);margin:4px 2px -2px}
|
||||
.p{display:flex;gap:10px;align-items:flex-start;padding:9px 10px;border-radius:10px;background:var(--panel);border:1px solid var(--line)}
|
||||
.p img{width:36px;height:36px;border-radius:8px;flex:none}
|
||||
.p .b{flex:1}
|
||||
.p .l1{display:flex;align-items:center;gap:6px;font-size:14px}
|
||||
.p .l1 .k{margin-left:auto;font-size:12px;color:var(--muted)}
|
||||
.p .c{font-size:12.5px;color:#c9d3dc;line-height:1.5;margin-top:2px}
|
||||
.p.bad{border-color:#6a2430;background:rgba(255,70,85,.08)}
|
||||
.sn{font-weight:800}
|
||||
</style></head><body>
|
||||
<div class="mh"><div class="brand"><img src="../../../../assets/app/icon.png"><div><div class="nm">겜녹이</div></div></div><span class="chip on new" style="margin-left:auto;font-size:12px;padding:4px 10px">🔍 범인찾기</span><span class="av" style="background:#5865f2;width:26px;height:26px">승</span></div>
|
||||
<main>
|
||||
<div class="hero">
|
||||
<div class="h" style="font-size:11px;color:var(--lol);font-weight:800;letter-spacing:2px">범인 분석 · LEAGUE OF LEGENDS</div>
|
||||
<div class="big h">소환사의 협곡 <span class="tag ok" style="vertical-align:3px">승리</span></div>
|
||||
<div class="muted" style="font-size:12px">내전 · 38분 · 킬 31 : 24 · 대화 655문장</div>
|
||||
<div class="s">초반 드래곤 세 개를 내줘 끌려갔지만, 32분 바론 앞 한타를 아리가 뒤집어 승리.</div>
|
||||
</div>
|
||||
<div class="cc">
|
||||
<div class="lab">우리 팀 범인</div>
|
||||
<div class="who"><img src="../../mock/assets/lol/c-LeeSin.png"><div><div class="nm">민수<small>리 신 · 정글 · 3/7/9</small></div><div class="muted" style="font-size:12px">평점 4.0 / 10</div></div></div>
|
||||
<div class="why">드래곤 네 번 중 세 번을 시야 없이 싸우다 내줬다. 8분에 "용 가자"는 콜을 듣고도 혼자 탑 갱을 갔다.</div>
|
||||
<div class="ev"><span class="t">8:12</span><span><b style="color:var(--u3)">지우</b> 민수야 용 같이 하자 바텀 밀었어</span></div>
|
||||
<div class="ev"><span class="t">8:20</span><span><b style="color:var(--u2)">민수</b> 아니 탑 갱 각이야 잠깐만</span></div>
|
||||
<div class="ev"><span class="t">9:02</span><span>상대 팀 <b>바다 드래곤</b> 처치 · 시야 점수 팀 최저 (19)</span></div>
|
||||
</div>
|
||||
<div class="cc">
|
||||
<div class="lab">상대 팀 범인</div>
|
||||
<div class="who"><img src="../../mock/assets/lol/c-Garen.png"><div><div class="nm">Mint#7777<small>가렌 · 탑 · 1/8/3</small></div><div class="muted" style="font-size:12px">평점 3.0 / 10 · 게임 기록으로 판단</div></div></div>
|
||||
<div class="why">라인전에서 다섯 번 죽어 탑 1차·2차 포탑을 15분 안에 내줬다. 바론 한타에 텔레포트 없이 늦게 합류.</div>
|
||||
</div>
|
||||
<div class="sec">우리 팀</div>
|
||||
<div class="p"><img src="../../mock/assets/lol/c-Ahri.png"><div class="b"><div class="l1"><b>승한</b><span class="muted" style="font-size:12px">아리</span><span class="tag done">캐리</span><span class="k"><span class="sn" style="color:var(--ink)">9.0</span> · 11/2/8</span></div><div class="c">바론 한타 매혹 세 명. 콜도 정확했다.</div></div></div>
|
||||
<div class="p"><img src="../../mock/assets/lol/c-Thresh.png"><div class="b"><div class="l1"><b>지우</b><span class="muted" style="font-size:12px">쓰레쉬</span><span class="tag ok">숨은 MVP</span><span class="k"><span class="sn" style="color:var(--ink)">7.5</span> · 1/5/19</span></div><div class="c">시야 점수 1위. 용 콜을 가장 먼저 했다.</div></div></div>
|
||||
<div class="p"><img src="../../mock/assets/lol/c-Ezreal.png"><div class="b"><div class="l1"><b>현우</b><span class="muted" style="font-size:12px">이즈리얼</span><span class="tag wait">무난</span><span class="k"><span class="sn" style="color:var(--ink)">7.0</span> · 8/4/9</span></div><div class="c">안정적. 딜량 팀 2위.</div></div></div>
|
||||
<div class="p"><img src="../../mock/assets/lol/c-Darius.png"><div class="b"><div class="l1"><b>준호</b><span class="muted" style="font-size:12px">다리우스</span><span class="tag wait">무난</span><span class="k"><span class="sn" style="color:var(--ink)">6.5</span> · 8/5/4</span></div><div class="c">라인전 압승, 한타 진입은 한 박자 빨랐다.</div></div></div>
|
||||
<div class="p bad"><img src="../../mock/assets/lol/c-LeeSin.png"><div class="b"><div class="l1"><b>민수</b><span class="muted" style="font-size:12px">리 신</span><span class="tag no">범인</span><span class="k"><span class="sn" style="color:var(--ink)">4.0</span> · 3/7/9</span></div><div class="c">드래곤 세 개 헌납. 콜 무시 2회.</div></div></div>
|
||||
<div class="sec">상대 팀 · 음성 없음</div>
|
||||
<div class="p"><img src="../../mock/assets/lol/c-Leblanc.png"><div class="b"><div class="l1"><b>Lumi</b><span class="muted" style="font-size:12px">르블랑</span><span class="tag done">캐리</span><span class="k"><span class="sn" style="color:var(--ink)">8.0</span> · 9/4/5</span></div></div></div>
|
||||
<div class="p" style="opacity:.75"><div class="b" style="font-size:12.5px;color:var(--muted)">… Kiwi 6.5 · Haru 6.0 · Nox 5.5 · <b style="color:var(--accent)">Mint 3.0 범인</b></div></div>
|
||||
</main></body></html>
|
||||
93
docs/report/culprit/mock/culprit-result.html
Normal file
@@ -0,0 +1,93 @@
|
||||
<!doctype html><html lang="ko"><head><meta charset="utf-8"><link rel="stylesheet" href="common.css">
|
||||
<style>
|
||||
body{height:1090px}
|
||||
main{flex:1;display:flex;flex-direction:column;gap:14px;padding:18px 24px;min-height:0}
|
||||
.hero{display:flex;align-items:center;gap:18px;background:linear-gradient(100deg,#13222f,#1a1420);border:1px solid var(--line);border-radius:14px;padding:14px 20px}
|
||||
.hero .big{font-size:26px;font-weight:800}
|
||||
.sum{flex:1;font-size:15px;line-height:1.6;padding-left:18px;border-left:1px solid var(--line)}
|
||||
.sum .k{color:var(--muted);font-size:12px}
|
||||
.meta{font-size:12px;color:var(--muted);text-align:right;line-height:1.7}
|
||||
.cul{display:grid;grid-template-columns:1fr 1fr;gap:14px}
|
||||
.cc{border-radius:14px;padding:16px 18px;background:linear-gradient(160deg,#2a1219,#141e29 55%);border:1px solid #6a2430;position:relative;overflow:hidden}
|
||||
.cc:before{content:"";position:absolute;right:-30px;top:-30px;width:160px;height:160px;border-radius:50%;background:radial-gradient(rgba(255,70,85,.25),transparent 70%)}
|
||||
.cc .lab{font-size:12px;letter-spacing:2px;color:var(--accent);font-weight:800}
|
||||
.cc .who{display:flex;align-items:center;gap:14px;margin:8px 0 10px}
|
||||
.cc .who img{width:62px;height:62px;border-radius:12px;border:2px solid var(--accent);background:#26384a}
|
||||
.cc .nm{font-size:26px;font-weight:800}
|
||||
.cc .nm small{font-size:14px;color:var(--muted);font-weight:500;margin-left:6px}
|
||||
.stamp{margin-left:auto;transform:rotate(-8deg);border:3px solid var(--accent);color:var(--accent);font-weight:900;font-size:20px;padding:4px 12px;border-radius:8px;letter-spacing:3px}
|
||||
.why{font-size:14.5px;line-height:1.65;margin-bottom:10px}
|
||||
.ev{display:flex;align-items:center;gap:10px;padding:6px 10px;border-radius:8px;background:rgba(11,20,28,.55);margin-bottom:5px;font-size:13.5px}
|
||||
.ev .t{font-family:"D2Coding ligature",monospace;color:var(--mint);font-size:12px;width:64px;flex:none}
|
||||
.ev .ty{font-size:11px;padding:1px 6px;border-radius:5px;flex:none}
|
||||
.ty.v{background:#1d2f45;color:#8cc4ff} .ty.k{background:#3a141a;color:#ff8a94} .ty.s{background:#2a2410;color:var(--gold)} .ty.c{background:#1b2e2a;color:#7fe0b8}
|
||||
.ev .pl{margin-left:auto;color:var(--muted);font-size:12px;flex:none}
|
||||
.teams{display:grid;grid-template-columns:1fr 1fr;gap:14px;flex:1;min-height:0}
|
||||
.row{display:grid;grid-template-columns:34px 150px 92px 1fr;gap:10px;align-items:center;padding:8px 6px;border-bottom:1px solid #1c2b39}
|
||||
.row:last-child{border:none}
|
||||
.row .n b{font-size:14.5px;display:block} .row .n span{font-size:12px;color:var(--muted)}
|
||||
.row .kda{font-size:12px;color:var(--muted);line-height:1.5}
|
||||
.row .kda b{color:var(--ink);font-size:13px}
|
||||
.sc{display:flex;align-items:center;gap:8px;margin-bottom:3px}
|
||||
.sc .bar{width:110px;height:7px;border-radius:4px;background:#22303e;overflow:hidden}
|
||||
.sc .bar i{display:block;height:100%;border-radius:4px;background:var(--mint)}
|
||||
.sc .num{font-weight:800;font-size:14px;width:30px}
|
||||
.cm{font-size:13px;line-height:1.5;color:#c9d3dc}
|
||||
.row.bad{background:rgba(255,70,85,.08);border-radius:8px}
|
||||
.row.bad .sc .bar i{background:var(--accent)}
|
||||
.foot{font-size:12px;color:var(--dim);display:flex;gap:16px}
|
||||
</style></head><body>
|
||||
<header>
|
||||
<div class="brand"><img src="../../../../assets/app/icon.png" alt=""><div><div class="nm">겜녹이</div><div class="en">GAME VOICE RECORDER</div></div></div>
|
||||
<span class="chip">타임라인</span><span class="chip">경기</span><span class="chip">유저</span><span class="chip">단어사전</span><span class="chip on new">🔍 범인찾기</span>
|
||||
<div class="search">🔍 대화 내용 검색 (예: 스파이크)</div>
|
||||
<div class="conn">● 게임 PC 연결됨</div><div class="me"><span class="av" style="background:#5865f2;width:26px;height:26px">승</span>승한</div>
|
||||
</header>
|
||||
<main>
|
||||
<div class="hero">
|
||||
<img src="../../mock/assets/val/map-ascent.png" style="width:52px;height:52px;border-radius:10px;background:#16293a">
|
||||
<div><div class="h" style="font-size:11px;color:var(--accent);font-weight:800;letter-spacing:2px">범인 분석 · VALORANT</div>
|
||||
<div class="big h">어센트 <span style="color:#c8d0d8">11 : 13</span> <span class="tag no" style="font-size:12px;vertical-align:5px">패배</span></div></div>
|
||||
<div class="sum"><div class="k">한 줄 요약</div>11:9 까지 앞섰지만 마지막 네 라운드를 내리 내줘 역전패. 그중 세 라운드가 B 메인 단독 진입으로 시작됐다. 상대는 레이즈 진입과 레이나 클러치로 버텼다.</div>
|
||||
<div class="meta">분석 오늘 23:31 · 742문장 · 이벤트 211개<br>Claude Opus 5.5 · 비용 $0.41<br><span class="btn" style="padding:4px 10px;font-size:12px;margin-top:4px">↻ 다시 분석 (관리자)</span></div>
|
||||
</div>
|
||||
<div class="cul">
|
||||
<div class="cc">
|
||||
<div class="lab">우리 팀 범인</div>
|
||||
<div class="who"><img src="../../mock/assets/val/a-omen.png"><div><div class="nm">현우<small>오멘 · 14 / 19 / 6 · ACS 171</small></div><div class="muted" style="font-size:13px">평점 3.5 / 10</div></div><div class="stamp">범인</div></div>
|
||||
<div class="why">마지막 네 라운드 중 세 번(R21·R23·R24)을 혼자 B 메인으로 먼저 들어가 첫 데스. 팀이 "기다려"라고 두 번 말했는데 그대로 진입했고, 첫 데스 7회로 팀에서 가장 많다. 스모크도 R22 리테이크에서 늦게 깔려 수적 우위를 잃었다.</div>
|
||||
<div class="ev"><span class="t">R21 0:22</span><span class="ty v">대화</span><b style="color:var(--u1)">승한</b> 현우야 같이 가 기다려 둘 있어<span class="pl">▶ 듣기</span></div>
|
||||
<div class="ev"><span class="t">R21 0:25</span><span class="ty v">대화</span><b style="color:var(--u4)">현우</b> 아 그냥 간다 내가 뚫을게<span class="pl">▶ 듣기</span></div>
|
||||
<div class="ev"><span class="t">R21 0:29</span><span class="ty k">킬</span>Nox (사이퍼) ▶ 현우 · 첫 데스, 덫에 걸림<span class="pl">타임라인 →</span></div>
|
||||
<div class="ev"><span class="t">경기 전체</span><span class="ty s">스탯</span>첫 데스 7회 (팀 1위) · 첫 킬 2회<span class="pl">스코어보드 →</span></div>
|
||||
</div>
|
||||
<div class="cc">
|
||||
<div class="lab">상대 팀 범인</div>
|
||||
<div class="who"><img src="../../mock/assets/val/a-skye.png"><div><div class="nm">Kiwi#KR9<small>스카이 · 9 / 18 / 7 · ACS 132</small></div><div class="muted" style="font-size:13px">평점 3.0 / 10 · 음성 없음, 게임 기록으로 판단</div></div><div class="stamp">범인</div></div>
|
||||
<div class="why">10명 중 ACS 가장 낮고, 상대가 이긴 13라운드 중 Kiwi 가 기여(킬·어시스트·생존)한 라운드는 5번뿐. R15 에 혼자 장비를 안 사서 4:5 로 싸웠고, 같은 라운드에 전체 채팅으로 "ff" 를 쳤다. 팀이 이긴 건 Lumi 와 Haru 덕분.</div>
|
||||
<div class="ev"><span class="t">R15 0:00</span><span class="ty s">경제</span>Kiwi 혼자 900 크레딧 사용 (팀 평균 4,200)<span class="pl">라운드 →</span></div>
|
||||
<div class="ev"><span class="t">R15 1:12</span><span class="ty c">채팅</span><span class="tag wait" style="font-size:10px">전체</span> <b>Kiwi</b> ff 그냥<span class="pl">타임라인 →</span></div>
|
||||
<div class="ev"><span class="t">R17 0:41</span><span class="ty k">킬</span>승한 (제트) ▶ Kiwi · 혼자 A 메인 정찰하다 잡힘<span class="pl">타임라인 →</span></div>
|
||||
<div class="ev"><span class="t">경기 전체</span><span class="ty s">스탯</span>ACS 132 (10명 중 10위) · 피해량 라운드당 88<span class="pl">스코어보드 →</span></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="teams">
|
||||
<div class="panel">
|
||||
<h4><span>우리 팀 5명 평가</span><span>평점 · 한 줄 평</span></h4>
|
||||
<div class="row"><img class="ag" src="../../mock/assets/val/a-jett.png"><div class="n"><b>승한</b><span>제트 · 음성 O</span></div><div class="kda"><b>24/15/5</b><br>ACS 272</div><div><div class="sc"><span class="num">8.5</span><span class="bar"><i style="width:85%"></i></span><span class="tag done">캐리</span></div><div class="cm">오퍼레이터 첫 킬 8회. 콜도 가장 많고 정확했다. 후반에 혼자 남아도 끝까지 침착.</div></div></div>
|
||||
<div class="row"><img class="ag" src="../../mock/assets/val/a-sage.png"><div class="n"><b>지우</b><span>세이지 · 음성 O</span></div><div class="kda"><b>12/16/13</b><br>ACS 168</div><div><div class="sc"><span class="num">7.5</span><span class="bar"><i style="width:75%"></i></span><span class="tag ok">숨은 MVP</span></div><div class="cm">부활 5번 중 3번이 라운드 승리로 이어짐. 킬은 적어도 벽 타이밍이 좋았다.</div></div></div>
|
||||
<div class="row"><img class="ag" src="../../mock/assets/val/a-sova.png"><div class="n"><b>민수</b><span>소바 · 음성 O</span></div><div class="kda"><b>16/17/9</b><br>ACS 204</div><div><div class="sc"><span class="num">7.0</span><span class="bar"><i style="width:70%"></i></span><span class="tag wait">무난</span></div><div class="cm">정찰 화살 정보 콜이 꾸준했다. R14 리테이크는 민수 드론 정보로 이김.</div></div></div>
|
||||
<div class="row"><img class="ag" src="../../mock/assets/val/a-phoenix.png"><div class="n"><b>Duck#KR3</b><span>피닉스 · 음성 X</span></div><div class="kda"><b>15/17/4</b><br>ACS 196</div><div><div class="sc"><span class="num">5.5</span><span class="bar"><i style="width:55%"></i></span><span class="tag wait">무난</span></div><div class="cm">음성채널에 없어 기록으로만 봄. 스탯은 평균, 세이브 라운드에 무기를 사서 경제가 두 번 꼬임.</div></div></div>
|
||||
<div class="row bad"><img class="ag" src="../../mock/assets/val/a-omen.png"><div class="n"><b>현우</b><span>오멘 · 음성 O</span></div><div class="kda"><b>14/19/6</b><br>ACS 171</div><div><div class="sc"><span class="num">3.5</span><span class="bar"><i style="width:35%"></i></span><span class="tag no">범인</span></div><div class="cm">막판 단독 진입 3번. 콜을 듣지 않은 게 결정적.</div></div></div>
|
||||
</div>
|
||||
<div class="panel">
|
||||
<h4><span>상대 팀 5명 평가</span><span>음성 없음 · 게임 기록 + 채팅</span></h4>
|
||||
<div class="row"><img class="ag" src="../../mock/assets/val/a-raze.png"><div class="n"><b>Lumi#KR1</b><span>레이즈</span></div><div class="kda"><b>22/16/5</b><br>ACS 261</div><div><div class="sc"><span class="num">8.5</span><span class="bar"><i style="width:85%"></i></span><span class="tag done">캐리</span></div><div class="cm">진입 첫 킬 7회. 마지막 네 라운드 모두 첫 교전에서 이김.</div></div></div>
|
||||
<div class="row"><img class="ag" src="../../mock/assets/val/a-reyna.png"><div class="n"><b>Haru#KR2</b><span>레이나</span></div><div class="kda"><b>19/15/3</b><br>ACS 238</div><div><div class="sc"><span class="num">8.0</span><span class="bar"><i style="width:80%"></i></span><span class="tag ok">클러치</span></div><div class="cm">1대2 클러치 2번 (R19·R24). 마지막 라운드를 끝낸 사람.</div></div></div>
|
||||
<div class="row"><img class="ag" src="../../mock/assets/val/a-cypher.png"><div class="n"><b>Nox#0420</b><span>사이퍼</span></div><div class="kda"><b>15/16/8</b><br>ACS 197</div><div><div class="sc"><span class="num">7.0</span><span class="bar"><i style="width:70%"></i></span><span class="tag wait">무난</span></div><div class="cm">B 메인 덫으로 현우 첫 데스를 세 번 만들어 냄.</div></div></div>
|
||||
<div class="row"><img class="ag" src="../../mock/assets/val/a-breach.png"><div class="n"><b>Mint#7777</b><span>브리치</span></div><div class="kda"><b>13/17/12</b><br>ACS 174</div><div><div class="sc"><span class="num">6.0</span><span class="bar"><i style="width:60%"></i></span><span class="tag wait">무난</span></div><div class="cm">어시스트 12로 팀 1위. 스킬로 진입을 도왔지만 킬 마무리가 약함.</div></div></div>
|
||||
<div class="row bad"><img class="ag" src="../../mock/assets/val/a-skye.png"><div class="n"><b>Kiwi#KR9</b><span>스카이</span></div><div class="kda"><b>9/18/7</b><br>ACS 132</div><div><div class="sc"><span class="num">3.0</span><span class="bar"><i style="width:30%"></i></span><span class="tag no">범인</span></div><div class="cm">ACS 꼴찌, 혼자 장비 안 사기, 전체 채팅 "ff". 팀이 업고 이김.</div></div></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="foot"><span>⚠ 재미로 보는 AI 분석입니다. 음성 인식 오류나 기록에 없는 상황 때문에 틀릴 수 있어요.</span><span style="margin-left:auto">근거를 누르면 그 순간의 대화·킬을 타임라인에서 바로 듣고 볼 수 있습니다</span></div>
|
||||
</main></body></html>
|
||||
6
docs/report/culprit/mock/header.inc
Normal file
@@ -0,0 +1,6 @@
|
||||
<header>
|
||||
<div class="brand"><img src="../../../../assets/app/icon.png" alt=""><div><div class="nm">겜녹이</div><div class="en">GAME VOICE RECORDER</div></div></div>
|
||||
<span class="chip">타임라인</span><span class="chip">경기</span><span class="chip">유저</span><span class="chip">단어사전</span><span class="chip on new">🔍 범인찾기</span>
|
||||
<div class="search">🔍 대화 내용 검색 (예: 스파이크)</div>
|
||||
<div class="conn">● 게임 PC 연결됨</div><div class="me"><span class="av" style="background:#5865f2;width:26px;height:26px">승</span>승한</div>
|
||||
</header>
|
||||
48
docs/report/culprit/mock/replay-popup.html
Normal file
@@ -0,0 +1,48 @@
|
||||
<!doctype html><html lang="ko"><head><meta charset="utf-8"><link rel="stylesheet" href="../../mock/base.css">
|
||||
<style>
|
||||
body{width:1440px;height:810px;overflow:hidden;position:relative;background:#05090d}
|
||||
.game{position:absolute;inset:0;background:url(../../mock/assets/lol/map11.png) center/cover no-repeat;filter:blur(6px) brightness(.45) saturate(.9)}
|
||||
.vig{position:absolute;inset:0;background:radial-gradient(ellipse at center,transparent 40%,rgba(0,0,0,.7))}
|
||||
.rbar{position:absolute;left:260px;right:260px;bottom:26px;height:54px;border-radius:10px;background:rgba(6,12,18,.82);border:1px solid #3a3222;display:flex;align-items:center;gap:16px;padding:0 18px;color:var(--lol2);font-size:14px}
|
||||
.rbar .tl{flex:1;height:6px;border-radius:3px;background:#2b2a24;position:relative}
|
||||
.rbar .tl i{position:absolute;left:0;top:0;bottom:0;width:22%;background:var(--lol);border-radius:3px}
|
||||
.rbar .tl b{position:absolute;left:22%;top:-5px;width:16px;height:16px;border-radius:50%;background:var(--lol2);margin-left:-8px}
|
||||
.tagr{position:absolute;left:24px;top:20px;color:var(--lol);font-size:13px;letter-spacing:2px;font-weight:800;background:rgba(6,12,18,.7);padding:6px 12px;border-radius:6px;border:1px solid #3a3222}
|
||||
.pop{position:absolute;right:28px;top:28px;width:440px;border-radius:14px;background:#0f1923;border:1px solid #3a4c5e;box-shadow:0 20px 60px rgba(0,0,0,.7),0 0 0 1px rgba(255,70,85,.25);overflow:hidden}
|
||||
.pop .tt{display:flex;align-items:center;gap:8px;padding:10px 14px;background:#0a1118;font-size:12px;color:var(--muted)}
|
||||
.pop .tt img{width:18px;height:18px;border-radius:4px}
|
||||
.pop .tt .x{margin-left:auto}
|
||||
.pop .bd{padding:16px 18px}
|
||||
.pop h3{font-size:19px;font-weight:800;margin-bottom:4px}
|
||||
.m{display:flex;gap:12px;align-items:center;background:var(--panel2);border:1px solid var(--line);border-radius:10px;padding:10px 12px;margin:12px 0}
|
||||
.m img{width:44px;height:44px;border-radius:8px}
|
||||
.ck{display:flex;align-items:center;gap:8px;font-size:13.5px;padding:4px 0}
|
||||
.ck i{font-style:normal;width:18px;height:18px;border-radius:50%;background:#0f2a22;color:#7fe0b8;display:inline-flex;align-items:center;justify-content:center;font-size:11px;font-weight:900}
|
||||
.ck i.w{background:#2a2410;color:var(--gold)}
|
||||
.ck .v{margin-left:auto;color:var(--muted);font-size:12.5px}
|
||||
.btns{display:flex;gap:8px;margin-top:14px}
|
||||
.btns .btn{flex:1;justify-content:center;font-size:14px;padding:11px}
|
||||
.foot{display:flex;align-items:center;gap:8px;margin-top:12px;font-size:12px;color:var(--muted)}
|
||||
.box{width:15px;height:15px;border-radius:4px;border:2px solid var(--line)}
|
||||
.keys{font-size:11.5px;color:var(--dim);margin-top:8px}
|
||||
.keys b{color:#b9c6d2;background:#1c2b39;border-radius:4px;padding:0 5px;font-weight:600}
|
||||
</style></head><body>
|
||||
<div class="game"></div><div class="vig"></div>
|
||||
<div class="tagr">LEAGUE OF LEGENDS · 리플레이 재생 중</div>
|
||||
<div class="rbar">⏸ <span class="mono">8:21</span><div class="tl"><i></i><b></b></div><span class="mono">38:10</span><span>1x</span></div>
|
||||
<div class="pop">
|
||||
<div class="tt"><img src="../../../../assets/app/icon.png">겜녹이<span class="x">✕</span></div>
|
||||
<div class="bd">
|
||||
<h3>이 리플레이의 녹음 기록이 있어요</h3>
|
||||
<div class="muted" style="font-size:13.5px">리플레이와 동기화하시겠습니까? 리플레이 시간에 맞춰 그때 한 말과 이벤트를 보여 주고 음성을 들려 줍니다.</div>
|
||||
<div class="m"><img src="../../mock/assets/lol/c-Ahri.png"><div><b style="font-size:15px">소환사의 협곡 · 내전</b> <span class="tag ok" style="background:#0f2a22;color:#7fe0b8;border:1px solid #1d5141;font-size:11px;padding:1px 7px;border-radius:6px;font-weight:700">승리</span><div class="muted" style="font-size:12.5px">10월 15일 21:55 · 38분 · 승한(아리) 외 4명 녹음</div></div></div>
|
||||
<div class="ck"><i>✓</i>음성 대화 텍스트<span class="v">655문장</span></div>
|
||||
<div class="ck"><i>✓</i>음성 파일<span class="v">남아 있음 · 10월 22일 삭제 예정</span></div>
|
||||
<div class="ck"><i>✓</i>킬 · 오브젝트 · 채팅<span class="v">112개</span></div>
|
||||
<div class="ck"><i>✓</i>범인 분석 결과<span class="v">있음 · 근거 7곳 표시</span></div>
|
||||
<div class="btns"><span class="btn primary">🔗 동기화</span><span class="btn">아니요</span></div>
|
||||
<div class="foot"><span class="box"></span>이 경기는 다시 묻지 않기</div>
|
||||
<div class="keys">게임 화면에서도 <b>Ctrl</b>+<b>Shift</b>+<b>G</b> 로 동기화 · <b>Ctrl</b>+<b>Shift</b>+<b>H</b> 로 무시</div>
|
||||
</div>
|
||||
</div>
|
||||
</body></html>
|
||||
88
docs/report/culprit/mock/replay-sync.html
Normal file
@@ -0,0 +1,88 @@
|
||||
<!doctype html><html lang="ko"><head><meta charset="utf-8"><link rel="stylesheet" href="../../mock/base.css">
|
||||
<style>
|
||||
body{width:1180px;height:800px;overflow:hidden;display:flex;flex-direction:column}
|
||||
.title{height:34px;flex:none;display:flex;align-items:center;gap:8px;padding:0 14px;background:#0a1118;font-size:12px;color:var(--muted)}
|
||||
.title img{width:16px;height:16px;border-radius:4px}.title .x{margin-left:auto;letter-spacing:12px}
|
||||
.top{display:flex;align-items:center;gap:16px;padding:14px 20px;border-bottom:1px solid var(--line);background:linear-gradient(100deg,#1a1a12,#121e29)}
|
||||
.sync{display:flex;align-items:center;gap:8px;background:#0f2a22;border:1px solid #1d5141;color:#7fe0b8;border-radius:999px;padding:6px 12px;font-size:13px;font-weight:700}
|
||||
.sync i{width:8px;height:8px;border-radius:50%;background:#45d39a;box-shadow:0 0 0 4px rgba(69,211,154,.2)}
|
||||
.clock{font-family:"D2Coding ligature",monospace;font-size:34px;font-weight:700;color:var(--lol2)}
|
||||
main{flex:1;display:grid;grid-template-columns:1fr 300px;min-height:0}
|
||||
.feed{padding:12px 20px;overflow:hidden;position:relative}
|
||||
.feed:before{content:"";position:absolute;left:0;right:0;top:0;height:60px;background:linear-gradient(#0b141c,transparent);z-index:1}
|
||||
.it{display:flex;gap:12px;align-items:flex-start;padding:8px 12px;border-radius:10px;margin:3px 0}
|
||||
.it .t{width:52px;flex:none;color:var(--mint);font-family:"D2Coding ligature",monospace;font-size:13px;padding-top:3px}
|
||||
.it.past{opacity:.42}
|
||||
.it .who{font-weight:700;font-size:13px}
|
||||
.it .tx{font-size:16px;line-height:1.5}
|
||||
.it.now{background:linear-gradient(90deg,rgba(255,70,85,.16),rgba(255,70,85,.03));outline:1px solid rgba(255,70,85,.6)}
|
||||
.w.done{color:#fff}.w.now{background:var(--accent);color:#fff;border-radius:3px;padding:0 4px}.w.next{color:#7f8b99}
|
||||
.ev{display:flex;align-items:center;gap:8px;font-size:14px;background:var(--panel2);border:1px solid var(--line);border-radius:8px;padding:6px 10px}
|
||||
.ev img{width:22px;height:22px;border-radius:5px}
|
||||
.nowline{display:flex;align-items:center;gap:10px;margin:6px 0;color:var(--accent);font-size:12px;font-weight:700}
|
||||
.nowline:after{content:"";flex:1;height:2px;background:var(--accent)}
|
||||
.side{border-left:1px solid var(--line);padding:16px;display:flex;flex-direction:column;gap:14px;background:#0e1822}
|
||||
.side h4{font-size:12px;color:var(--muted);letter-spacing:1px;margin-bottom:8px;font-weight:500}
|
||||
.sp{display:flex;align-items:center;gap:10px;padding:6px 0;font-size:14px}
|
||||
.sp img{width:30px;height:30px;border-radius:7px}
|
||||
.meter{flex:1;height:6px;border-radius:3px;background:#22303e;overflow:hidden}.meter i{display:block;height:100%;background:var(--mint)}
|
||||
.sp.talk img{outline:2px solid #45d39a;outline-offset:1px}
|
||||
.row{display:flex;align-items:center;gap:8px;font-size:13px;color:#c9d3dc}
|
||||
.bot{flex:none;border-top:1px solid var(--line);padding:12px 20px;background:#0e1822}
|
||||
.tl{height:34px;position:relative;border-radius:6px;background:#141f2a}
|
||||
.tl i{position:absolute;left:0;top:0;bottom:0;width:22%;background:linear-gradient(90deg,rgba(200,170,110,.25),rgba(200,170,110,.45));border-radius:6px 0 0 6px}
|
||||
.tl .cur{position:absolute;left:22%;top:-4px;bottom:-4px;width:3px;background:var(--lol2);border-radius:2px}
|
||||
.tl .k{position:absolute;bottom:4px;width:3px;height:10px;border-radius:2px;background:#ff8a94}
|
||||
.tl .o{position:absolute;top:4px;width:9px;height:9px;border-radius:50%;background:var(--gold);margin-left:-4px}
|
||||
.tl .c{position:absolute;top:3px;font-size:11px;margin-left:-6px}
|
||||
.tl .v{position:absolute;bottom:0;height:5px;background:#3987e5;opacity:.75}
|
||||
.lg{display:flex;gap:16px;font-size:11.5px;color:var(--muted);margin-top:8px}
|
||||
.lg span:before{content:"";display:inline-block;width:9px;height:9px;border-radius:2px;margin-right:5px;vertical-align:-1px;background:var(--c)}
|
||||
</style></head><body>
|
||||
<div class="title"><img src="../../../../assets/app/icon.png">겜녹이 · 리플레이 동기화<span class="x">📌 — ▢ ✕</span></div>
|
||||
<div class="top">
|
||||
<img src="../../mock/assets/lol/c-Ahri.png" style="width:42px;height:42px;border-radius:8px">
|
||||
<div><div class="h" style="font-size:11px;color:var(--lol);font-weight:800;letter-spacing:2px">LEAGUE OF LEGENDS · 리플레이</div><div class="h" style="font-size:19px;font-weight:800">소환사의 협곡 · 내전 <span class="muted" style="font-size:13px;font-weight:500">10월 15일 21:55 · 승리</span></div></div>
|
||||
<div class="sync" style="margin-left:auto"><i></i>동기화됨 · 리플레이를 따라감</div>
|
||||
<div style="text-align:right"><div class="clock">8:21</div><div class="muted" style="font-size:12px">재생 중 · 1x · 오차 ±0.3초</div></div>
|
||||
</div>
|
||||
<main>
|
||||
<div class="feed">
|
||||
<div class="it past"><span class="t">7:55</span><div><div class="who" style="color:var(--u3)">지우 <span class="dim" style="font-weight:400">쓰레쉬</span></div><div class="tx">용 쪽 시야 없어 와드 하나 박을게</div></div></div>
|
||||
<div class="it past"><span class="t">8:05</span><div><div class="who" style="color:var(--u1)">승한 <span class="dim" style="font-weight:400">아리</span></div><div class="tx">미드 밀고 갈게 민수야 용 앞으로 와</div></div></div>
|
||||
<div class="it past"><span class="t">8:12</span><div><div class="who" style="color:var(--u3)">지우 <span class="dim" style="font-weight:400">쓰레쉬</span> <span style="font-size:11px;color:#ff8a94;background:#3a141a;border-radius:5px;padding:1px 6px;margin-left:4px">🔍 범인 근거</span></div><div class="tx">민수야 용 같이 하자 바텀 밀었어</div></div></div>
|
||||
<div class="nowline">지금 8:21</div>
|
||||
<div class="it now"><span class="t">8:20</span><div><div class="who" style="color:var(--u2)">민수 <span class="dim" style="font-weight:400">리 신</span> <span style="font-size:11px;color:#ff8a94;background:#3a141a;border-radius:5px;padding:1px 6px;margin-left:4px">🔍 범인 근거</span></div><div class="tx"><span class="w done">아니</span> <span class="w done">탑</span> <span class="w now">갱</span> <span class="w next">각이야</span> <span class="w next">잠깐만</span></div></div><span style="margin-left:auto;color:var(--accent);font-size:13px">🔊 재생 중</span></div>
|
||||
<div class="it"><span class="t">8:41</span><div><div class="who" style="color:var(--u3)">지우 <span class="dim" style="font-weight:400">쓰레쉬</span></div><div class="tx">아 용 지금 하는데 상대 정글 보여</div></div></div>
|
||||
<div class="it"><span class="t">8:55</span><div class="ev"><img src="../../mock/assets/lol/c-Sejuani.png"><b>Kiwi</b> ▶ <img src="../../mock/assets/lol/c-Thresh.png"><b>지우</b><span class="dim">· 어시 Lumi</span></div></div>
|
||||
<div class="it"><span class="t">9:02</span><div class="ev"><img src="../../mock/assets/lol/o-dragon_ocean.png">상대 팀 <b>바다 드래곤</b> 처치 · Kiwi</div></div>
|
||||
<div class="it"><span class="t">9:06</span><div><div class="who" style="color:var(--u1)">승한 <span class="dim" style="font-weight:400">아리</span></div><div class="tx">괜찮아 다음 용 준비하자</div></div></div>
|
||||
</div>
|
||||
<div class="side">
|
||||
<div><h4>지금 말하는 사람</h4>
|
||||
<div class="sp talk"><img src="../../mock/assets/lol/c-LeeSin.png">민수<div class="meter"><i style="width:78%"></i></div></div>
|
||||
<div class="sp"><img src="../../mock/assets/lol/c-Ahri.png">승한<div class="meter"><i style="width:0%"></i></div></div>
|
||||
<div class="sp"><img src="../../mock/assets/lol/c-Thresh.png">지우<div class="meter"><i style="width:12%"></i></div></div>
|
||||
<div class="sp"><img src="../../mock/assets/lol/c-Ezreal.png">현우<div class="meter"><i style="width:0%"></i></div></div>
|
||||
<div class="sp"><img src="../../mock/assets/lol/c-Darius.png">준호<div class="meter"><i style="width:0%"></i></div></div>
|
||||
</div>
|
||||
<div><h4>소리</h4>
|
||||
<div class="row">🔊 녹음 음성<span style="margin-left:auto" class="mono">80%</span></div>
|
||||
<div class="row muted" style="font-size:12px;margin-top:4px">리플레이를 멈추면 같이 멈추고, 2배속까지 같이 빨라집니다. 더 빠르면 글자만 보여 줍니다.</div>
|
||||
</div>
|
||||
<div><h4>시간 미세 조정</h4>
|
||||
<div class="row"><span class="btn" style="padding:5px 10px">−0.5초</span><span class="mono" style="flex:1;text-align:center">+0.0초</span><span class="btn" style="padding:5px 10px">+0.5초</span></div>
|
||||
</div>
|
||||
<div class="muted" style="font-size:12px;line-height:1.6;margin-top:auto">줄을 누르면 리플레이가 그 시간으로 이동합니다 (롤).<br>📌 항상 위에 · 작게 보기로 게임 옆에 띄워 둘 수 있습니다.</div>
|
||||
</div>
|
||||
</main>
|
||||
<div class="bot">
|
||||
<div class="tl"><i></i>
|
||||
<span class="v" style="left:3%;width:5%"></span><span class="v" style="left:11%;width:8%"></span><span class="v" style="left:22%;width:6%"></span><span class="v" style="left:31%;width:9%"></span><span class="v" style="left:44%;width:7%"></span><span class="v" style="left:55%;width:10%"></span><span class="v" style="left:70%;width:8%"></span><span class="v" style="left:83%;width:9%"></span>
|
||||
<span class="k" style="left:9%"></span><span class="k" style="left:18%"></span><span class="k" style="left:27%"></span><span class="k" style="left:40%"></span><span class="k" style="left:41%"></span><span class="k" style="left:58%"></span><span class="k" style="left:62%"></span><span class="k" style="left:84%"></span><span class="k" style="left:85%"></span><span class="k" style="left:86%"></span>
|
||||
<span class="o" style="left:15%"></span><span class="o" style="left:23.7%"></span><span class="o" style="left:63%"></span><span class="o" style="left:84%"></span>
|
||||
<span class="c" style="left:21.3%">🔍</span><span class="c" style="left:22.8%">🔍</span><span class="c" style="left:61%">🔍</span>
|
||||
<span class="cur"></span></div>
|
||||
<div class="lg"><span style="--c:#3987e5">대화</span><span style="--c:#ff8a94">킬</span><span style="--c:var(--gold)">오브젝트</span><span style="--c:transparent">🔍 범인 근거</span><span style="margin-left:auto" class="mono">0:00 ─ 38:10</span></div>
|
||||
</div>
|
||||
</body></html>
|
||||
715
docs/report/culprit/plan.html
Normal file
36
docs/report/culprit/prompt/knowledge-lol.md
Normal file
42
docs/report/culprit/prompt/knowledge-valorant.md
Normal file
@@ -0,0 +1,42 @@
|
||||
<!-- 발로란트 지식 묶음 v1 (초안, 2026-10-15). system 프롬프트 뒤에 <knowledge> 로 붙인다.
|
||||
"자동 갱신" 칸은 valorant-api.com(ko-KR)에서 패치마다 다시 만든다 (tools/gen-dictionary.mjs 와 같은 소스). 아래는 2026-10-15 스냅샷. -->
|
||||
<knowledge game="valorant">
|
||||
## 경기 규칙
|
||||
- 13라운드를 먼저 이기면 승리. 12:12 이면 연장(경쟁전은 2라운드 차가 날 때까지). 12라운드 뒤 공수 교대.
|
||||
- 1라운드와 13라운드는 권총 라운드. 라운드는 구매 시간 30초 + 교전 1분 40초. 스파이크 설치 뒤 45초면 폭발, 해체는 7초(절반 지점 저장).
|
||||
- 공격: 스파이크 설치나 전멸로 승리. 수비: 전멸, 해체, 시간 초과로 승리.
|
||||
|
||||
## 경제 (패치에 따라 조금 바뀔 수 있음)
|
||||
- 시작 800, 라운드 승리 3,000, 패배 1,900 → 연패마다 +500 (최대 2,900), 킬 200, 설치 300(공격팀 전원). 최대 9,000.
|
||||
- 풀바이 = 라이플(밴달·팬텀 2,900) 또는 오퍼레이터(4,700) + 실드 + 스킬, 대략 3,900 이상. 에코(세이브) = 거의 안 삼. 포스바이 = 돈이 모자라도 삼. 하프바이 = 중간.
|
||||
- 팀이 같이 세이브하는 건 정상 운영이다. 혼자만 사거나 혼자만 안 사서 팀 경제가 어긋나면 감점.
|
||||
- 상대가 에코인 라운드를 지는 것은 큰 손실. 에코 라운드에서 딴 킬은 가치가 낮다.
|
||||
|
||||
## 역할별 기준
|
||||
- 타격대(제트·레이즈·레이나 등): 진입해서 첫 교전을 열고 공간을 만든다. 첫 데스가 많아도 팀이 바로 복수(트레이드)하면 정상. 트레이드도 안 되는 혼자 진입이 반복되면 감점.
|
||||
- 척후대(소바·브리치·스카이 등): 정보와 진입 보조. 어시스트, 정찰 정보 콜이 중요.
|
||||
- 전략가(오멘·브림스톤·아스트라 등): 연막으로 시야를 끊어 진입·리테이크를 돕는다. 오래 살아남는 것이 중요. 킬이 적어도 정상.
|
||||
- 감시자(킬조이·사이퍼·세이지 등): 사이트 수비, 측면 차단, 리테이크. 전투 점수가 낮은 게 흔하다. 세이지 부활은 큰 기여.
|
||||
- 역할이 겹치면(타격대 3명 등) 판단을 팀 구성 탓으로 돌리지 말고 각자 맡은 일을 했는지 본다.
|
||||
|
||||
## 지표
|
||||
- 전투 점수(ACS): 라운드당 평균. 보통 200 안팎, 250 넘으면 높음, 150 아래면 낮음.
|
||||
- 라운드당 피해량: 보통 130~150. 첫 킬 · 첫 데스: 라운드 첫 교전 결과로 라운드 승률에 크게 영향.
|
||||
- 클러치: 혼자 남아 여러 명을 상대로 라운드를 이김. 멀티킬 · 에이스(5킬).
|
||||
- 막판 정리 킬(이미 진 라운드에서 도망가는 적을 잡음)은 숫자를 부풀린다.
|
||||
|
||||
## 콜아웃 · 은어 (음성·채팅에 나오는 말)
|
||||
- 장소: A/B/C 사이트, 메인, 롱, 숏(쇼트), 미드, 헤븐, 마켓, 로비, 링크, 백사이트, 개구멍, 문, 계단, 창문, 엘보, 지붕, 하수구, 텔레포터, 로프, 파이프, 정원, 트리, 박스, 기둥.
|
||||
- 전투: 원탭/투탭(머리 한두 발), 헤드, 퍼블·첫킬, 각(사격 위치), 피킹(엄폐물에서 나와 쏨), 프리파이어(미리 쏨), 트레이드(복수 킬), 리테이크(설치 뒤 사이트 탈환), 로테(다른 사이트로 이동), 스택(한 사이트에 몰림), 디폴트(흩어져 정보 수집), 러시·패스트(빠른 진입), 원웨이(한쪽만 보이는 연막), 몰리(화염), 플래시·섬광, 연막·스모크, 궁(궁극기), 오브.
|
||||
- 상태: "하나 남았어"(적 1명), "피 30"(체력 30), "깎였어"(맞음), "세이브해"(무기 아끼고 살아라), "에코/이코", "풀바이", "포스".
|
||||
- 태도: ㅈㅈ·ff(포기), "던졌네"(실수로 경기를 망침), "버스 탔다"(남이 이겨 줌).
|
||||
|
||||
## 음성 인식이 자주 틀리는 말
|
||||
레이저→레이즈, 비 싸이트→B 사이트, 에이 싸이트→A 사이트, 로태→로테, 오퍼래이터→오퍼레이터, 반달→밴달, 펜텀→팬텀, 쉐리프·세리프→셰리프, 디퓨저→디퓨즈, 킬 조이→킬조이, 브림 스톤→브림스톤, 아스트로→아스트라, 클로버→클로브.
|
||||
숫자·알파벳 콜아웃(A, B, 피 30)은 한글로 받아 적히거나("에이", "비") 빠지기 쉽다.
|
||||
|
||||
## 자동 갱신 (2026-10-15 스냅샷)
|
||||
- 요원 (역할): 척후대: 게코, 브리치, 소바, 스카이, 케이/오, 테호, 페이드 / 감시자: 데드록, 바이스, 비토, 사이퍼, 세이지, 체임버, 킬조이 / 타격대: 네온, 레이나, 레이즈, 아이소, 요루, 웨이레이, 제트, 피닉스 / 전략가: 믹스, 바이퍼, 브림스톤, 아스트라, 오멘, 클로브, 하버
|
||||
- 맵: 어센트, 스플릿, 프랙처, 바인드, 브리즈, 어비스, 로터스, 선셋, 펄, 서밋, 아이스박스, 코로드, 헤이븐
|
||||
- 무기 (가격): 오딘 3200, 아레스 1600, 밴달 2900, 워든 2900, 불독 2050, 팬텀 2900, 저지 1850, 버키 850, 프렌지 450, 클래식 0, 밴딧 600, 고스트 500, 셰리프 800, 쇼티 300, 오퍼레이터 4700, 가디언 2250, 아웃로 2400, 마샬 950, 스펙터 1600, 스팅어 1100
|
||||
</knowledge>
|
||||
52
docs/report/culprit/prompt/output-schema.json
Normal file
@@ -0,0 +1,52 @@
|
||||
{
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["summary", "confidence", "confidence_note", "teams", "players"],
|
||||
"properties": {
|
||||
"summary": { "type": "string", "description": "경기 한 줄 요약, 1~2문장" },
|
||||
"confidence": { "type": "string", "enum": ["high", "medium", "low"] },
|
||||
"confidence_note": { "type": "string", "description": "confidence 가 medium/low 인 이유. high 면 빈 문자열" },
|
||||
"teams": {
|
||||
"type": "array",
|
||||
"description": "우리 팀, 상대 팀 순서로 2개",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["team", "culprit", "reason", "evidence"],
|
||||
"properties": {
|
||||
"team": { "type": "string", "enum": ["ally", "enemy"] },
|
||||
"culprit": { "type": "string", "description": "P1~P10" },
|
||||
"reason": { "type": "string", "description": "2~3문장" },
|
||||
"evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } }
|
||||
}
|
||||
}
|
||||
},
|
||||
"players": {
|
||||
"type": "array",
|
||||
"description": "P1~P10 순서로 10명",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["id", "score", "tag", "comment", "evidence"],
|
||||
"properties": {
|
||||
"id": { "type": "string", "description": "P1~P10" },
|
||||
"score": { "type": "number", "description": "1.0~10.0, 0.5 단위" },
|
||||
"tag": { "type": "string", "enum": ["캐리", "숨은 MVP", "클러치", "무난", "아쉬움", "범인"] },
|
||||
"comment": { "type": "string", "description": "한 줄 평, 40자 안팎" },
|
||||
"evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } }
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"$defs": {
|
||||
"evidence": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["ref", "note"],
|
||||
"properties": {
|
||||
"ref": { "type": "string", "description": "자료의 근거 번호: e123 · u456 · c7 · r21 · s:P4" },
|
||||
"note": { "type": "string", "description": "이 근거가 뜻하는 것. 대화면 원문 인용" }
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
60
docs/report/culprit/prompt/system.md
Normal file
@@ -0,0 +1,60 @@
|
||||
<!-- 겜녹이 범인찾기 시스템 프롬프트 v1 (초안, 2026-10-15)
|
||||
서버가 이 파일 + 게임별 knowledge-*.md 를 system 에 넣고, 경기 자료는 user 메시지로 보낸다.
|
||||
{{tone}} 은 말투 설정(mild|medium|spicy)으로 바꾼다. 이 파일과 knowledge 는 경기마다 같아서 프롬프트 캐시 대상이다. -->
|
||||
너는 겜녹이의 경기 분석가다. 디스코드 친구들이 함께 한 발로란트 또는 리그 오브 레전드 경기 한 판의 기록을 읽고, 참가자 10명을 평가하고 팀마다 "범인"을 한 명씩 고른다. 결과는 친구들이 재미로 보는 사이트에 그대로 뜬다. 정확하고 공정해야 웃고 넘길 수 있다.
|
||||
|
||||
<input_format>
|
||||
user 메시지의 <match> 안에 경기 자료가 온다.
|
||||
- 경기: 게임, 모드, 맵, 최종 점수, 길이. "우리 팀" = 음성을 녹음한 쪽 팀, "상대 팀" = 다른 팀.
|
||||
- 참가자: P1~P10 번호, 이름, 팀, 요원·챔피언과 역할(포지션), 스탯, 음성 유무(음성O / 음성X).
|
||||
- 시간 순서의 줄. 줄 앞 번호가 근거 번호다.
|
||||
- [e번호] 게임 이벤트 (킬, 스파이크, 오브젝트, 라운드 결과 등)
|
||||
- [u번호] 음성 문장. 디스코드 음성채널에서 자동 음성 인식으로 받아 적은 것이라 글자가 틀릴 수 있다.
|
||||
- [c번호] 인게임 채팅 (팀 / 전체)
|
||||
- [r번호] 라운드 요약 (발로란트), [s:P번호] 그 사람의 경기 전체 스탯
|
||||
- 음성은 봇이 있던 음성채널 사람만 있다. 상대 팀은 보통 음성이 없다.
|
||||
</input_format>
|
||||
|
||||
<task>
|
||||
1. 경기 흐름을 먼저 파악한다. 어느 라운드·시간대에서 승부가 갈렸는지 찾는다.
|
||||
2. 10명 모두 평가한다: 평점(1.0~10.0, 0.5 단위), 태그 하나, 한 줄 평(40자 안팎).
|
||||
3. 팀마다 범인을 한 명씩 고른다.
|
||||
- 진 팀의 범인: 패배에 가장 큰 책임이 있는 사람.
|
||||
- 이긴 팀의 범인: 이기는 데 가장 발목을 잡은 사람.
|
||||
- 범인은 그 팀에서 평점이 가장 낮아야 한다. 동점이면 근거가 더 분명한 사람.
|
||||
4. 범인마다 이유(2~3문장)와 근거 3~4개, 나머지 사람은 근거 0~2개를 단다.
|
||||
5. 경기 전체 한 줄 요약(1~2문장)을 쓴다.
|
||||
</task>
|
||||
|
||||
<judging_rules>
|
||||
- 숫자보다 결과에 준 영향을 본다. KDA·전투 점수만으로 정하지 않는다.
|
||||
- 승부처(접전 라운드, 매치 포인트, 연장, 오브젝트 직전, 결정적 한타)의 실수는 무겁게 본다.
|
||||
- 승부가 이미 갈린 뒤의 스탯(진 라운드 막판 킬, 끝난 경기의 데스)과 상대 에코 라운드에서 딴 킬은 가볍게 본다.
|
||||
- 역할로 평가한다. <knowledge> 의 역할·포지션 기준을 따른다. 킬이 적은 역할이 킬이 적다고 범인이 되지 않는다.
|
||||
- 음성X 인 사람은 소통 항목 없이 플레이와 채팅으로만 평가한다. 말이 없다고 깎지도, 말실수가 안 잡혔다고 올리지도 않는다.
|
||||
- 음성O 인 사람은 말실수가 기록에 남아 불리하다. 그래서 음성O 인 사람을 범인으로 고를 때는 소통 근거 말고 플레이 근거([e], [r], [s])가 최소 1개 있어야 한다.
|
||||
- "콜 무시"는 (1) 같은 음성채널에서 콜이 있었고 (2) 그 사람이 다르게 움직인 것이 이벤트로 확인될 때만 쓴다.
|
||||
- 음성 인식 오류를 감안한다. 문장 하나로 결론 내지 않는다. 이상한 단어는 <knowledge> 의 오인식 목록을 참고하고, 뜻이 분명하지 않은 문장은 근거로 쓰지 않는다.
|
||||
- 게임과 상관없는 잡담, 친구끼리 장난으로 하는 거친 말은 평가에 쓰지 않는다. 팀원을 계속 탓하거나 포기를 부추기는 말(ff, 서렌 치자, 던지자)은 소통 감점이다.
|
||||
- 좋은 소통도 본다: 적 위치·체력 정보, 타이밍 콜, 침착하게 계획을 세우는 말은 가점이다.
|
||||
- 자료에 없는 것을 지어내지 않는다. 화면, 정확한 위치 이동, 대부분의 스킬 사용은 자료에 없다. 모르면 판단에서 뺀다.
|
||||
- 근거는 자료의 번호로만 단다. 대화 인용은 원문 그대로 쓰고(고치지 않는다), 30자를 넘으면 줄인다.
|
||||
- 자료가 부족하거나 기록이 한쪽으로 쏠려 판단이 약하면 confidence 를 낮추고 이유를 적는다.
|
||||
</judging_rules>
|
||||
|
||||
<tags>
|
||||
캐리 · 숨은 MVP · 클러치 · 무난 · 아쉬움 · 범인 중 하나. "범인" 태그는 팀마다 정확히 한 명, 그 팀의 범인에게만 붙인다.
|
||||
</tags>
|
||||
|
||||
<tone>
|
||||
말투: {{tone}}
|
||||
- mild(순한맛): 담백한 평가. 놀리지 않는다.
|
||||
- medium(중간맛, 기본): 친구끼리 가볍게 놀리는 정도. 예) "연장에서 혼자 B 메인 관광 세 번."
|
||||
- spicy(매운맛): 더 세게 놀린다. 그래도 아래 금지는 지킨다.
|
||||
공통: 짧은 평서문("~했다"). 존댓말·이모지·감탄사 남발 없음. 이름은 자료에 적힌 그대로.
|
||||
금지: 욕설, 외모·성별·나이·지역·가족 이야기, 게임 밖 사생활(잡담 내용 폭로), 진짜 상처가 될 인신공격.
|
||||
</tone>
|
||||
|
||||
<output>
|
||||
정해진 JSON 형식으로만 답한다. players 는 P1~P10 순서로 10명 모두 넣는다. 평점과 범인이 서로 맞는지(범인이 그 팀 최저점인지) 마지막에 확인한다.
|
||||
</output>
|
||||
6
docs/report/culprit/shot.sh
Executable file
@@ -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]))")"
|
||||
262
docs/report/culprit/sim.json
Normal file
@@ -0,0 +1,262 @@
|
||||
{
|
||||
"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": 20325,
|
||||
"p50": 28033,
|
||||
"p90": 38881,
|
||||
"p99": 51878.8871,
|
||||
"mean": 29052.8009
|
||||
},
|
||||
"out": {
|
||||
"p10": 9851.5492,
|
||||
"p50": 13599.4192,
|
||||
"p90": 19550.2369,
|
||||
"p99": 27056.5033,
|
||||
"mean": 14248.8196
|
||||
},
|
||||
"cost": {
|
||||
"p10": 0.3002,
|
||||
"p50": 0.3879,
|
||||
"p90": 0.5193,
|
||||
"p99": 0.6824,
|
||||
"mean": 0.4012
|
||||
},
|
||||
"cost_val": {
|
||||
"p10": 0.3139,
|
||||
"p50": 0.4037,
|
||||
"p90": 0.5366,
|
||||
"p99": 0.6964,
|
||||
"mean": 0.4169
|
||||
},
|
||||
"cost_lol": {
|
||||
"p10": 0.2887,
|
||||
"p50": 0.3725,
|
||||
"p90": 0.4968,
|
||||
"p99": 0.6606,
|
||||
"mean": 0.3854
|
||||
}
|
||||
},
|
||||
"hist": [
|
||||
[
|
||||
0.175,
|
||||
4
|
||||
],
|
||||
[
|
||||
0.2,
|
||||
26
|
||||
],
|
||||
[
|
||||
0.225,
|
||||
191
|
||||
],
|
||||
[
|
||||
0.25,
|
||||
574
|
||||
],
|
||||
[
|
||||
0.275,
|
||||
1186
|
||||
],
|
||||
[
|
||||
0.3,
|
||||
1883
|
||||
],
|
||||
[
|
||||
0.325,
|
||||
2349
|
||||
],
|
||||
[
|
||||
0.35,
|
||||
2509
|
||||
],
|
||||
[
|
||||
0.375,
|
||||
2430
|
||||
],
|
||||
[
|
||||
0.4,
|
||||
2103
|
||||
],
|
||||
[
|
||||
0.425,
|
||||
1772
|
||||
],
|
||||
[
|
||||
0.45,
|
||||
1372
|
||||
],
|
||||
[
|
||||
0.475,
|
||||
1007
|
||||
],
|
||||
[
|
||||
0.5,
|
||||
733
|
||||
],
|
||||
[
|
||||
0.525,
|
||||
560
|
||||
],
|
||||
[
|
||||
0.55,
|
||||
392
|
||||
],
|
||||
[
|
||||
0.575,
|
||||
280
|
||||
],
|
||||
[
|
||||
0.6,
|
||||
199
|
||||
],
|
||||
[
|
||||
0.625,
|
||||
134
|
||||
],
|
||||
[
|
||||
0.65,
|
||||
78
|
||||
],
|
||||
[
|
||||
0.675,
|
||||
64
|
||||
],
|
||||
[
|
||||
0.7,
|
||||
54
|
||||
],
|
||||
[
|
||||
0.725,
|
||||
31
|
||||
],
|
||||
[
|
||||
0.75,
|
||||
30
|
||||
],
|
||||
[
|
||||
0.775,
|
||||
18
|
||||
],
|
||||
[
|
||||
0.8,
|
||||
13
|
||||
],
|
||||
[
|
||||
0.825,
|
||||
4
|
||||
],
|
||||
[
|
||||
0.85,
|
||||
2
|
||||
],
|
||||
[
|
||||
0.875,
|
||||
2
|
||||
]
|
||||
],
|
||||
"hist_n": 20000,
|
||||
"per_model": {
|
||||
"opus-5.5": {
|
||||
"p5": 232,
|
||||
"p50": 237,
|
||||
"p95": 242,
|
||||
"mean": 237.06733333333332,
|
||||
"batch_p50": 474
|
||||
},
|
||||
"sonnet-5.5": {
|
||||
"p5": 467,
|
||||
"p50": 475,
|
||||
"p95": 483,
|
||||
"mean": 474.98066666666665,
|
||||
"batch_p50": 950
|
||||
},
|
||||
"haiku-4.5": {
|
||||
"p5": 939,
|
||||
"p50": 950,
|
||||
"p95": 961,
|
||||
"mean": 950.174,
|
||||
"batch_p50": 1900
|
||||
}
|
||||
},
|
||||
"scenarios": {
|
||||
"quiet/valorant": {
|
||||
"mean": 0.3694,
|
||||
"p90": 0.4733,
|
||||
"per100": 257
|
||||
},
|
||||
"quiet/lol": {
|
||||
"mean": 0.3464,
|
||||
"p90": 0.4494,
|
||||
"per100": 274
|
||||
},
|
||||
"quiet/mix": {
|
||||
"mean": 0.3577,
|
||||
"p90": 0.4614,
|
||||
"per100": 266
|
||||
},
|
||||
"normal/valorant": {
|
||||
"mean": 0.4184,
|
||||
"p90": 0.5415,
|
||||
"per100": 227
|
||||
},
|
||||
"normal/lol": {
|
||||
"mean": 0.384,
|
||||
"p90": 0.4974,
|
||||
"per100": 248
|
||||
},
|
||||
"normal/mix": {
|
||||
"mean": 0.4004,
|
||||
"p90": 0.5156,
|
||||
"per100": 237
|
||||
},
|
||||
"loud/valorant": {
|
||||
"mean": 0.488,
|
||||
"p90": 0.6328,
|
||||
"per100": 195
|
||||
},
|
||||
"loud/lol": {
|
||||
"mean": 0.4426,
|
||||
"p90": 0.5776,
|
||||
"per100": 215
|
||||
},
|
||||
"loud/mix": {
|
||||
"mean": 0.4685,
|
||||
"p90": 0.6171,
|
||||
"per100": 203
|
||||
}
|
||||
},
|
||||
"opus_medium": {
|
||||
"p5": 295,
|
||||
"p50": 301,
|
||||
"p95": 307,
|
||||
"mean": 301.1546666666667
|
||||
}
|
||||
}
|
||||
@@ -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/<Name>.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/<Name>.png
|
||||
|
||||
BIN
docs/report/mock/assets/lol/c-Darius.png
Normal file
|
After Width: | Height: | Size: 27 KiB |
BIN
docs/report/mock/assets/lol/c-Jinx.png
Normal file
|
After Width: | Height: | Size: 27 KiB |
BIN
docs/report/mock/assets/lol/c-Lux.png
Normal file
|
After Width: | Height: | Size: 28 KiB |
BIN
docs/report/mock/assets/val/a-breach.png
Normal file
|
After Width: | Height: | Size: 446 KiB |
BIN
docs/report/mock/assets/val/a-cypher.png
Normal file
|
After Width: | Height: | Size: 418 KiB |
BIN
docs/report/mock/assets/val/a-phoenix.png
Normal file
|
After Width: | Height: | Size: 402 KiB |
BIN
docs/report/mock/assets/val/a-skye.png
Normal file
|
After Width: | Height: | Size: 440 KiB |
BIN
docs/report/mock/assets/val/a-viper.png
Normal file
|
After Width: | Height: | Size: 411 KiB |
@@ -1,2 +1,4 @@
|
||||
export * from './protocol.js';
|
||||
export * from './time.js';
|
||||
export * from './rating.js';
|
||||
export * from './rating-model.js';
|
||||
|
||||
@@ -1,3 +1,5 @@
|
||||
import type { PlayerRating } from './rating.js';
|
||||
|
||||
// 앱 코어 · 사이트 서버 · 사이트 프런트엔드가 같이 쓰는 타입. docs/dev/ARCHITECTURE.md 4~6장.
|
||||
|
||||
export type GameType = 'valorant' | 'lol';
|
||||
@@ -146,6 +148,38 @@ export interface MatchPlayer {
|
||||
items?: { id: number; name: string; icon: string | null }[];
|
||||
rank?: string | null;
|
||||
userId?: string;
|
||||
/** 범인찾기용 추가 지표 (v1.3~ 에 저장한 경기만 있다) */
|
||||
stats?: PlayerStats;
|
||||
}
|
||||
|
||||
/** 경기 상세에서 더 저장하는 지표. 예전 경기는 없다 (범인찾기는 "기본 기록으로 분석"으로 표시) */
|
||||
export interface PlayerStats {
|
||||
/** 발로란트: 요원 역할(타격대·척후대·전략가·감시자) / 롤: 포지션(탑·정글·미드·원딜·서폿, 추정) */
|
||||
role?: string;
|
||||
/** 발로란트: 준 피해 합 / 롤: 챔피언에게 준 피해 */
|
||||
damage?: number;
|
||||
rounds?: number;
|
||||
// 발로란트
|
||||
headshotPct?: number;
|
||||
firstKills?: number;
|
||||
firstDeaths?: number;
|
||||
plants?: number;
|
||||
defuses?: number;
|
||||
abilityCasts?: number;
|
||||
/** 발로란트: KAST(킬 · 어시 · 생존 · 트레이드)를 한 라운드 수 (v1.3~) */
|
||||
kastRounds?: number;
|
||||
/** 롤 · 발로란트(v1.3~): 받은 피해 */
|
||||
damageTaken?: number;
|
||||
// 롤
|
||||
vision?: number;
|
||||
wardsPlaced?: number;
|
||||
wardsKilled?: number;
|
||||
controlWards?: number;
|
||||
objectiveDamage?: number;
|
||||
turretDamage?: number;
|
||||
ccSeconds?: number;
|
||||
at10?: { cs: number; gold: number; xp: number };
|
||||
at15?: { cs: number; gold: number; xp: number };
|
||||
}
|
||||
|
||||
export interface MatchRound {
|
||||
@@ -155,7 +189,11 @@ export interface MatchRound {
|
||||
win: boolean;
|
||||
result: string;
|
||||
score: { ally: number; enemy: number };
|
||||
economy?: Record<string, { spent: number; remaining: number; weapon?: string }>;
|
||||
economy?: Record<string, { spent: number; remaining: number; weapon?: string; loadout?: number }>;
|
||||
/** 이 라운드에서 우리 팀이 공격이었나 (v1.3~) */
|
||||
allyAttack?: boolean;
|
||||
/** 선수별 이 라운드 킬 · 준 피해 (v1.3~) */
|
||||
players?: Record<string, { kills: number; damage: number }>;
|
||||
}
|
||||
|
||||
export interface MatchDetail extends MatchSummary {
|
||||
@@ -185,7 +223,107 @@ export interface UserProfile {
|
||||
matches: MatchSummary[];
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------------ 범인찾기 (계획서 v1.1)
|
||||
/** ready = 분석 가능, done = 분석 완료, pending = 준비 중(경기 진행 · 음성 변환), blocked = 기록 부족 */
|
||||
export interface CulpritEligibility {
|
||||
state: 'ready' | 'done' | 'pending' | 'blocked';
|
||||
reasons: string[];
|
||||
}
|
||||
export interface CulpritPlayer {
|
||||
/** P1~P10 (우리 팀 먼저) */
|
||||
id: string;
|
||||
puuid: string;
|
||||
name: string;
|
||||
team: 'ally' | 'enemy';
|
||||
character: { id: string; name: string; icon: string | null } | null;
|
||||
userId: string | null;
|
||||
/** 이 경기 음성 대화가 있는지 */
|
||||
voice: boolean;
|
||||
/** Riot ID 태그 (OP.GG 에서 경기를 찾을 때, v1.3~) */
|
||||
tag?: string;
|
||||
/** 기록 점수: OP.GG OP스코어 방식으로 우리 기록에서 계산 (v1.3~) */
|
||||
rating?: PlayerRating;
|
||||
/** OP.GG 에 이 경기가 있으면 그 사이트의 실제 OP스코어 (사이트 서버가 분석할 때 붙인다) */
|
||||
opgg?: { score: number; rank: number | null };
|
||||
}
|
||||
/** 근거 번호가 가리키는 것 (사이트에서 누르면 그 순간으로 이동) */
|
||||
export type CulpritRefTarget =
|
||||
| { kind: 'utterance'; id: string; ts: number }
|
||||
| { kind: 'event'; id: string; ts: number; round?: number }
|
||||
| { kind: 'round'; round: number; ts: number }
|
||||
| { kind: 'stat'; pid: string };
|
||||
/** 앱이 만든 AI 입력 (사이트 서버만 받는다) */
|
||||
export interface CulpritInput {
|
||||
game: GameType;
|
||||
text: string;
|
||||
refs: Record<string, CulpritRefTarget>;
|
||||
players: CulpritPlayer[];
|
||||
stats: { utterances: number; utterancesTotal: number; events: number; chats: number; rounds: number; basic: boolean };
|
||||
/** OP.GG 에서 같은 경기를 찾을 정보 (v1.3~). riotMatchId = 발로란트 경기 UUID · 롤 gameId */
|
||||
lookup?: { riotMatchId: string | null; startedAt: number; endedAt: number; durationSec: number };
|
||||
}
|
||||
export interface CulpritEvidence {
|
||||
ref: string;
|
||||
note: string;
|
||||
target?: CulpritRefTarget;
|
||||
}
|
||||
export const CULPRIT_TAGS = ['캐리', '숨은 MVP', '클러치', '무난', '아쉬움', '범인'] as const;
|
||||
export interface CulpritResult {
|
||||
summary: string;
|
||||
confidence: 'high' | 'medium' | 'low';
|
||||
confidence_note: string;
|
||||
teams: { team: 'ally' | 'enemy'; culprit: string; reason: string; evidence: CulpritEvidence[] }[];
|
||||
players: { id: string; score: number; tag: (typeof CULPRIT_TAGS)[number]; comment: string; evidence: CulpritEvidence[] }[];
|
||||
}
|
||||
export interface CulpritAnalysis {
|
||||
id: string;
|
||||
matchId: string;
|
||||
createdAt: number;
|
||||
createdBy: { id: string; name: string };
|
||||
model: string;
|
||||
result: CulpritResult;
|
||||
players: CulpritPlayer[];
|
||||
meta: {
|
||||
tone?: string;
|
||||
durationMs?: number;
|
||||
costUsd?: number;
|
||||
usage?: { input: number; output: number; cacheRead?: number; cacheWrite?: number };
|
||||
inputStats?: CulpritInput['stats'];
|
||||
fallback?: boolean;
|
||||
/** OP.GG 실제 점수를 찾았는지 · 못 찾은 이유 */
|
||||
opgg?: { found: boolean; note?: string };
|
||||
};
|
||||
}
|
||||
export interface CulpritMatchItem {
|
||||
match: MatchSummary;
|
||||
eligibility: CulpritEligibility;
|
||||
culprits: { team: 'ally' | 'enemy'; name: string; character: { id: string; name: string; icon: string | null } | null }[];
|
||||
}
|
||||
export interface CulpritMatchInfo {
|
||||
match: MatchSummary;
|
||||
eligibility: CulpritEligibility;
|
||||
sources: { rounds: number | null; events: number; utterances: number; chats: number; extraStats: boolean };
|
||||
players: CulpritPlayer[];
|
||||
analysis: CulpritAnalysis | null;
|
||||
history: { id: string; at: number; by: { id: string; name: string }; model: string; current: boolean }[];
|
||||
}
|
||||
/** 사이트 서버의 예산 · 권한 (GET /api/culprit/budget) */
|
||||
export interface CulpritBudget {
|
||||
enabled: boolean;
|
||||
canAnalyze: boolean;
|
||||
canReanalyze: boolean;
|
||||
monthSpentUsd: number;
|
||||
monthLimitUsd: number;
|
||||
todayCount: number;
|
||||
dailyLimit: number;
|
||||
estimateUsd: number;
|
||||
model: string;
|
||||
running: string[];
|
||||
}
|
||||
export type CulpritStage = 'collect' | 'thinking' | 'verify' | 'done' | 'failed';
|
||||
|
||||
export type LiveEvent =
|
||||
| { type: 'culprit.progress'; data: { matchId: string; stage: CulpritStage; message?: string } }
|
||||
| { type: 'utterance.created' | 'utterance.updated'; data: UtteranceItem }
|
||||
| { type: 'event.created'; data: EventItem }
|
||||
| { type: 'match.updated'; data: MatchSummary }
|
||||
@@ -224,3 +362,93 @@ export type RelayFromDevice =
|
||||
| { t: 'res_head'; id: string; status: number; headers: Record<string, string> }
|
||||
| { t: 'res_end'; id: string }
|
||||
| { t: 'event'; event: LiveEvent };
|
||||
|
||||
// 앱(exe) 로그인 · 유저 등록 (사이트 서버 /auth/app/*, /app/*)
|
||||
/** superadmin = 최고 관리자(서버에 고정), admin = 관리자, user = 일반 유저 */
|
||||
export type AppRole = 'superadmin' | 'admin' | 'user';
|
||||
|
||||
export interface AppUserInfo {
|
||||
id: string;
|
||||
name: string;
|
||||
avatar: string | null;
|
||||
}
|
||||
|
||||
/** POST /auth/app/begin → 브라우저로 열 주소와 결과를 받아 갈 비밀값 */
|
||||
export interface AppLoginBegin {
|
||||
id: string;
|
||||
secret: string;
|
||||
url: string;
|
||||
expiresAt: number;
|
||||
}
|
||||
|
||||
/** POST /auth/app/poll 응답 */
|
||||
export type AppLoginPoll =
|
||||
| { state: 'pending' }
|
||||
| { state: 'ok'; token: string; user: AppUserInfo; role: AppRole }
|
||||
| { state: 'not_registered'; user: AppUserInfo }
|
||||
| { state: 'error'; error: string };
|
||||
|
||||
/** GET /app/me 응답 (등록된 유저만). 겜녹이 봇 토큰은 내려주지 않는다 (봇은 서버가 대신 연결, 아래 BotGw*) */
|
||||
export interface AppMe {
|
||||
user: AppUserInfo;
|
||||
role: AppRole;
|
||||
serverTime: number;
|
||||
}
|
||||
|
||||
/** 관리자 화면의 등록 유저 한 줄 */
|
||||
export interface AppUserRow {
|
||||
id: string;
|
||||
name: string;
|
||||
avatar: string | null;
|
||||
role: AppRole;
|
||||
/** 서버에 고정된 최고 관리자 (지우거나 역할을 바꿀 수 없음) */
|
||||
fixed: boolean;
|
||||
addedBy: string | null;
|
||||
addedAt: number | null;
|
||||
lastSeenAt: number | null;
|
||||
lastVersion: string | null;
|
||||
}
|
||||
|
||||
// 겜녹이 봇 중계 (사이트 서버 WebSocket /app/bot/ws, Authorization: Bearer <앱 토큰>)
|
||||
// 권한: 앱 유저가 가입한 디스코드 서버만, 그 유저가 볼 수 있는 채널만 보이고, 들어갈 수 있는(보기 + 연결) 음성채널에만 봇을 부를 수 있다
|
||||
// 봇 토큰은 서버에만 있다. 서버가 디스코드 게이트웨이에 붙어 있고, 앱은 필요한 정보만 받는다.
|
||||
// 음성채널에 들어갈 때는 앱의 @discordjs/voice 가 보낸 op 4 를 서버가 대신 보내고,
|
||||
// 디스코드가 준 일회용 음성 접속 정보(VOICE_STATE/SERVER_UPDATE)를 앱에 넘긴다. 음성은 앱 ↔ 디스코드로 바로 간다.
|
||||
export interface BotGwMember {
|
||||
id: string;
|
||||
name: string;
|
||||
avatar: string | null;
|
||||
bot: boolean;
|
||||
}
|
||||
export interface BotGwGuild {
|
||||
id: string;
|
||||
name: string;
|
||||
icon: string | null;
|
||||
}
|
||||
export interface BotGwChannel {
|
||||
id: string;
|
||||
name: string;
|
||||
}
|
||||
|
||||
export type BotGwToApp =
|
||||
| { t: 'ready'; me: BotGwMember; guilds: BotGwGuild[] }
|
||||
| { t: 'guilds'; guilds: BotGwGuild[] }
|
||||
/** watch 응답: 그 서버에서 이 유저가 볼 수 있는 음성채널 · 그 채널에 있는 사람 */
|
||||
| { t: 'guild'; guild: BotGwGuild; channels: BotGwChannel[]; voice: { member: BotGwMember; channelId: string }[] }
|
||||
/** watch 거절: 이 유저가 가입하지 않은 서버 */
|
||||
| { t: 'watch_denied'; guildId: string }
|
||||
| { t: 'voiceState'; guildId: string; member: BotGwMember; oldChannelId: string | null; newChannelId: string | null; channel: BotGwChannel | null }
|
||||
| { t: 'cmd'; id: string; name: string; guildId: string; user: BotGwMember; voiceChannel: BotGwChannel | null }
|
||||
/** 음성 접속 정보 (디스코드 VOICE_SERVER_UPDATE / 봇 자신의 VOICE_STATE_UPDATE 원문) */
|
||||
| { t: 'vserver'; guildId: string; data: any }
|
||||
| { t: 'vstate'; guildId: string; data: any }
|
||||
/** 다른 PC 가 이 서버에서 봇을 데려갔다 → 녹음을 멈춘다 */
|
||||
| { t: 'taken'; guildId: string }
|
||||
| { t: 'res'; id: string; ok: boolean; data?: any; error?: string };
|
||||
|
||||
export type BotGwFromApp =
|
||||
| { t: 'watch'; guildId: string; commands: boolean }
|
||||
/** @discordjs/voice 어댑터가 보낸 게이트웨이 op 4 (음성채널 참여 · 나가기) */
|
||||
| { t: 'voice'; guildId: string; payload: any }
|
||||
| { t: 'cmd_res'; id: string; content: string }
|
||||
| { t: 'req'; id: string; op: 'members'; guildId: string };
|
||||
|
||||
11
packages/shared/src/rating-model.ts
Normal file
@@ -0,0 +1,11 @@
|
||||
// 자동 생성: tools/opscore-fit/gen_model.py — 손으로 고치지 않는다.
|
||||
// OP.GG 공식 MCP(mcp-api.op.gg)에서 받은 실제 경기의 OP Score 를 앱에 있는 지표로 맞춘 선형 모델 (교차 검증 값은 cv).
|
||||
// 발로란트 315명·254경기, 롤 800명·80경기.
|
||||
export interface LinearModel {
|
||||
features: string[];
|
||||
coef: number[];
|
||||
intercept: number;
|
||||
cv: { mae: number; r: number; spearman: number; lowestAgree?: number };
|
||||
}
|
||||
export const VALORANT_MODEL: { full: LinearModel; basic: LinearModel } = {"full": {"features": ["rwr", "kast", "acs", "ddd"], "coef": [3.209816, 6.776853, 0.007243, 0.010052], "intercept": -2.3976, "cv": {"mae": 0.492, "r": 0.968, "spearman": 0.974}}, "basic": {"features": ["rwr", "acs", "kpr", "dpr", "apr"], "coef": [3.564892, 0.010291, 1.892489, -3.558135, 1.82333], "intercept": 2.2705, "cv": {"mae": 0.674, "r": 0.928, "spearman": 0.936}}};
|
||||
export const LOL_MODEL: { full: LinearModel; basic: LinearModel } = {"full": {"features": ["win", "kp", "death_share", "dpm", "kda", "dmg_share", "dmg_rel", "taken_share", "gold_share", "gold_rel", "cspm", "lvl_diff", "ccpm", "wardpm", "cwpm"], "coef": [0.581805, 1.686807, 2.678466, -2.157005, 1.89478, -0.583504, 0.837466, -0.710903, 0.485658, 2.283615, -0.135173, 0.059317, 0.013698, -0.018032, 0.126284], "intercept": -0.5962, "cv": {"mae": 0.6, "r": 0.943, "spearman": 0.949, "lowestAgree": 0.85}}, "basic": {"features": ["win", "kp", "death_share", "dpm", "kda", "gold_share", "gold_rel", "cspm", "lvl_diff"], "coef": [0.563588, 1.743634, 3.235958, -1.927705, 2.008261, 1.011327, 2.762106, -0.113694, 0.079826], "intercept": -1.0442, "cv": {"mae": 0.611, "r": 0.94, "spearman": 0.947, "lowestAgree": 0.825}}};
|
||||
202
packages/shared/src/rating.ts
Normal file
@@ -0,0 +1,202 @@
|
||||
import type { MatchPlayer, MatchRound } from './protocol.js';
|
||||
import { LOL_MODEL, VALORANT_MODEL, type LinearModel } from './rating-model.js';
|
||||
|
||||
/**
|
||||
* 기록 점수 (범인찾기, 0~10): 전적 사이트 점수를 우리 기록으로 다시 계산한 값.
|
||||
* - 발로란트: OP.GG OP스코어. OP.GG 가 밝힌 입력(라운드 승률 · KAST · ACS · 피해량 격차)을 실제 OP.GG 점수에 맞춘 선형 모델
|
||||
* - 롤: OP.GG OP스코어. 킬 관여 · 데스 · 딜/받은 피해 비중 · 골드 · CS · 레벨 · CC · 와드를 실제 OP.GG 점수에 맞춘 선형 모델
|
||||
* (포지션별로 나눠도 나아지지 않았다. 딜 · 받은 피해 · 와드 비중이 포지션 차이를 담고, 내전은 포지션 추정이 틀릴 수 있다)
|
||||
* - 롤 라인전: LOL.PS 처럼 15분 맞라인 상대와 CS · 골드 · 경험치 차 (점수에는 넣지 않고 따로 보여 준다)
|
||||
* 계수는 tools/opscore-fit (OP.GG 공식 MCP 로 받은 실제 경기) 에서 만든다. 승패 · MVP/ACE 표시도 OP.GG 와 같다.
|
||||
*/
|
||||
|
||||
export interface RatingPart {
|
||||
/** 화면 · AI 자료용 짧은 글 ("KAST 82%") */
|
||||
text: string;
|
||||
/** 점수를 올린 지표인가 (true = 강점, false = 약점) */
|
||||
good: boolean;
|
||||
}
|
||||
|
||||
export interface PlayerRating {
|
||||
/** 0~10, 0.1 단위 */
|
||||
score: number;
|
||||
/** 경기 10명 중 순위 (1 = 최고) */
|
||||
rank: number;
|
||||
/** 팀 안 순위 */
|
||||
teamRank: number;
|
||||
/** OP.GG 처럼 이긴 팀 1등 = MVP, 진 팀 1등 = ACE */
|
||||
badge: 'MVP' | 'ACE' | null;
|
||||
/** 점수를 가장 많이 올리고 깎은 지표 (각각 최대 2개) */
|
||||
parts: RatingPart[];
|
||||
/** 롤 15분 맞라인 비교 (LOL.PS 라인전 지표). 맞상대를 모르면 없음 */
|
||||
lane?: { vs: string; cs: number; gold: number; xp: number };
|
||||
/** 추가 지표 없이 기본 기록(K/D/A 등)만으로 낸 점수 */
|
||||
basic: boolean;
|
||||
}
|
||||
|
||||
type Feat = Record<string, number>;
|
||||
interface FeatInfo {
|
||||
/** 이 지표가 크면 좋은가 (+1) 나쁜가 (-1). 0 = 설명에 쓰지 않음 (팀 전체 값 등) */
|
||||
dir: 1 | -1 | 0;
|
||||
label: (v: number) => string;
|
||||
}
|
||||
|
||||
const pct = (v: number) => `${Math.round(v * 100)}%`;
|
||||
const signed = (v: number, d = 0) => `${v >= 0 ? '+' : ''}${v.toFixed(d)}`;
|
||||
|
||||
const VAL_INFO: Record<string, FeatInfo> = {
|
||||
rwr: { dir: 0, label: (v) => `라운드 승률 ${pct(v)}` },
|
||||
kast: { dir: 1, label: (v) => `KAST ${pct(v)}` },
|
||||
acs: { dir: 1, label: (v) => `ACS ${Math.round(v)}` },
|
||||
ddd: { dir: 1, label: (v) => `피해 격차 ${signed(v)}/라운드` },
|
||||
kpr: { dir: 1, label: (v) => `라운드당 킬 ${v.toFixed(2)}` },
|
||||
dpr: { dir: -1, label: (v) => `라운드당 데스 ${v.toFixed(2)}` },
|
||||
apr: { dir: 1, label: (v) => `라운드당 어시 ${v.toFixed(2)}` },
|
||||
};
|
||||
|
||||
const LOL_INFO: Record<string, FeatInfo> = {
|
||||
win: { dir: 0, label: () => '' },
|
||||
kp: { dir: 1, label: (v) => `킬 관여 ${pct(v)}` },
|
||||
death_share: { dir: -1, label: (v) => `상대 킬의 ${pct(v)}가 이 사람` },
|
||||
dpm: { dir: -1, label: (v) => `분당 데스 ${v.toFixed(2)}` },
|
||||
kda: { dir: 1, label: (v) => `KDA ${Math.expm1(v).toFixed(1)}` },
|
||||
dmg_share: { dir: 1, label: (v) => `팀 딜 비중 ${pct(v)}` },
|
||||
dmg_rel: { dir: 1, label: (v) => `딜량 평균의 ${v.toFixed(1)}배` },
|
||||
taken_share: { dir: 1, label: (v) => `받은 피해 비중 ${pct(v)}` },
|
||||
gold_share: { dir: 1, label: (v) => `팀 골드 비중 ${pct(v)}` },
|
||||
gold_rel: { dir: 1, label: (v) => `골드 평균의 ${v.toFixed(1)}배` },
|
||||
cspm: { dir: 1, label: (v) => `분당 CS ${v.toFixed(1)}` },
|
||||
lvl_diff: { dir: 1, label: (v) => `레벨 평균 ${signed(v, 1)}` },
|
||||
ccpm: { dir: 1, label: (v) => `분당 CC ${v.toFixed(1)}초` },
|
||||
wardpm: { dir: 1, label: (v) => `분당 와드 ${v.toFixed(2)}` },
|
||||
cwpm: { dir: 1, label: (v) => `분당 제어 와드 ${v.toFixed(2)}` },
|
||||
};
|
||||
|
||||
/** 라인전 비교를 하는 포지션 (바텀 = 원딜/서폿을 모름 → 비교 안 함) */
|
||||
const LANES = new Set(['탑', '정글', '미드', '원딜', '서폿']);
|
||||
|
||||
function apply(m: LinearModel, f: Feat): number {
|
||||
let s = m.intercept;
|
||||
m.features.forEach((k, i) => (s += m.coef[i] * (f[k] ?? 0)));
|
||||
return Math.min(10, Math.max(0, s));
|
||||
}
|
||||
|
||||
/** 경기 평균과 비교해 점수를 가장 많이 올리고 깎은 지표 (모델 계수 × 평균과의 차) */
|
||||
function explain(m: LinearModel, f: Feat, mean: Feat, info: Record<string, FeatInfo>): RatingPart[] {
|
||||
const contrib = m.features
|
||||
.map((k, i) => ({ k, c: m.coef[i] * ((f[k] ?? 0) - (mean[k] ?? 0)) }))
|
||||
// 계수 부호가 상식과 반대인 지표(다른 지표와 겹쳐 생긴 것)는 설명에 쓰지 않는다
|
||||
.filter(({ k }) => info[k] && info[k].dir !== 0 && Math.sign(m.coef[m.features.indexOf(k)]) === info[k].dir);
|
||||
const ups = contrib.filter((x) => x.c >= 0.25).sort((a, b) => b.c - a.c).slice(0, 2);
|
||||
const downs = contrib.filter((x) => x.c <= -0.25).sort((a, b) => a.c - b.c).slice(0, 2);
|
||||
return [...ups.map((x) => ({ text: info[x.k].label(f[x.k]), good: true })), ...downs.map((x) => ({ text: info[x.k].label(f[x.k]), good: false }))];
|
||||
}
|
||||
|
||||
function meanOf(fs: Feat[]): Feat {
|
||||
const out: Feat = {};
|
||||
for (const f of fs) for (const [k, v] of Object.entries(f)) out[k] = (out[k] ?? 0) + v / fs.length;
|
||||
return out;
|
||||
}
|
||||
|
||||
function finish(players: MatchPlayer[], scores: number[], parts: RatingPart[][], basic: boolean, teamWin: (p: MatchPlayer) => boolean | null): Map<string, PlayerRating> {
|
||||
const out = new Map<string, PlayerRating>();
|
||||
const rounded = scores.map((s) => Math.round(s * 10) / 10);
|
||||
const order = rounded.map((s, i) => ({ s, i })).sort((a, b) => b.s - a.s);
|
||||
// 기록이 깨진 경기(값 없는 선수)는 점수를 내지 않는다
|
||||
if (!rounded.every(Number.isFinite)) return out;
|
||||
players.forEach((p, i) => {
|
||||
const mates = players.map((q, j) => ({ q, j })).filter(({ q }) => q.team === p.team);
|
||||
const teamOrder = [...mates].sort((a, b) => rounded[b.j] - rounded[a.j]);
|
||||
const teamRank = teamOrder.findIndex((x) => x.j === i) + 1;
|
||||
const win = teamWin(p);
|
||||
out.set(p.puuid, {
|
||||
score: rounded[i],
|
||||
rank: order.findIndex((x) => x.i === i) + 1,
|
||||
teamRank,
|
||||
badge: teamRank === 1 && win !== null ? (win ? 'MVP' : 'ACE') : null,
|
||||
parts: parts[i],
|
||||
basic,
|
||||
});
|
||||
});
|
||||
return out;
|
||||
}
|
||||
|
||||
/** 발로란트 기록 점수. rounds = 경기 라운드 기록(우리 팀 기준 승패) */
|
||||
export function rateValorant(players: MatchPlayer[], rounds: MatchRound[]): Map<string, PlayerRating> {
|
||||
if (!players.length) return new Map();
|
||||
const total = rounds.length;
|
||||
const allyWon = rounds.filter((r) => r.win).length;
|
||||
const full = players.every((p) => p.stats?.kastRounds !== undefined && p.stats?.damageTaken !== undefined && p.stats?.damage !== undefined);
|
||||
const model = full ? VALORANT_MODEL.full : VALORANT_MODEL.basic;
|
||||
const feats: Feat[] = players.map((p) => {
|
||||
const n = p.stats?.rounds || total || 1;
|
||||
const won = p.ally ? allyWon : total - allyWon;
|
||||
return {
|
||||
rwr: total ? won / total : 0.5,
|
||||
kast: (p.stats?.kastRounds ?? 0) / n,
|
||||
acs: (p.score ?? 0) / n,
|
||||
ddd: ((p.stats?.damage ?? 0) - (p.stats?.damageTaken ?? 0)) / n,
|
||||
kpr: (p.kills ?? 0) / n,
|
||||
dpr: (p.deaths ?? 0) / n,
|
||||
apr: (p.assists ?? 0) / n,
|
||||
};
|
||||
});
|
||||
const mean = meanOf(feats);
|
||||
const scores = feats.map((f) => apply(model, f));
|
||||
const parts = feats.map((f) => explain(model, f, mean, VAL_INFO));
|
||||
return finish(players, scores, parts, !full, (p) => (total ? (p.ally ? allyWon * 2 > total : allyWon * 2 < total) : null));
|
||||
}
|
||||
|
||||
/** 롤 기록 점수. minutes = 경기 시간(분), allyWin = 우리 팀 승리 여부 */
|
||||
export function rateLol(players: MatchPlayer[], minutes: number, allyWin: boolean | null): Map<string, PlayerRating> {
|
||||
if (!players.length) return new Map();
|
||||
const m = Math.max(1, minutes);
|
||||
const full = players.every((p) => p.stats?.damage !== undefined && p.stats?.damageTaken !== undefined);
|
||||
const sum = (xs: MatchPlayer[], f: (p: MatchPlayer) => number) => xs.reduce((n, p) => n + f(p), 0);
|
||||
const avgLevel = sum(players, (p) => p.level ?? 0) / players.length;
|
||||
const lobbyDmg = Math.max(1, sum(players, (p) => p.stats?.damage ?? 0) / players.length);
|
||||
const lobbyGold = Math.max(1, sum(players, (p) => p.gold ?? 0) / players.length);
|
||||
const feats: Feat[] = players.map((p) => {
|
||||
const mates = players.filter((q) => q.team === p.team);
|
||||
const foes = players.filter((q) => q.team !== p.team);
|
||||
const tk = Math.max(1, sum(mates, (q) => q.kills));
|
||||
const ek = Math.max(1, sum(foes, (q) => q.kills));
|
||||
const tdmg = Math.max(1, sum(mates, (q) => q.stats?.damage ?? 0));
|
||||
const ttaken = Math.max(1, sum(mates, (q) => q.stats?.damageTaken ?? 0));
|
||||
const tgold = Math.max(1, sum(mates, (q) => q.gold ?? 0));
|
||||
const win = allyWin === null ? 0.5 : p.ally === allyWin ? 1 : 0;
|
||||
return {
|
||||
win,
|
||||
kp: (p.kills + p.assists) / tk,
|
||||
death_share: p.deaths / ek,
|
||||
dpm: p.deaths / m,
|
||||
kda: Math.log1p((p.kills + p.assists) / Math.max(1, p.deaths)),
|
||||
dmg_share: (p.stats?.damage ?? 0) / tdmg,
|
||||
dmg_rel: (p.stats?.damage ?? 0) / lobbyDmg,
|
||||
taken_share: (p.stats?.damageTaken ?? 0) / ttaken,
|
||||
gold_share: (p.gold ?? 0) / tgold,
|
||||
gold_rel: (p.gold ?? 0) / lobbyGold,
|
||||
cspm: (p.cs ?? 0) / m,
|
||||
lvl_diff: (p.level ?? 0) - avgLevel,
|
||||
ccpm: (p.stats?.ccSeconds ?? 0) / m,
|
||||
wardpm: (p.stats?.wardsPlaced ?? 0) / m,
|
||||
cwpm: (p.stats?.controlWards ?? 0) / m,
|
||||
};
|
||||
});
|
||||
const model = full ? LOL_MODEL.full : LOL_MODEL.basic;
|
||||
const mean = meanOf(feats);
|
||||
const scores = feats.map((f) => apply(model, f));
|
||||
const parts = feats.map((f) => explain(model, f, mean, LOL_INFO));
|
||||
const out = finish(players, scores, parts, !full, (p) => (allyWin === null ? null : p.ally === allyWin));
|
||||
// 라인전 (LOL.PS): 같은 포지션 상대가 딱 한 명이면 15분 차이
|
||||
for (const p of players) {
|
||||
const role = p.stats?.role;
|
||||
const a = p.stats?.at15;
|
||||
if (!role || !LANES.has(role) || !a) continue;
|
||||
const opp = players.filter((q) => q.team !== p.team && q.stats?.role === role);
|
||||
const b = opp.length === 1 ? opp[0].stats?.at15 : undefined;
|
||||
if (!b) continue;
|
||||
out.get(p.puuid)!.lane = { vs: opp[0].puuid, cs: a.cs - b.cs, gold: a.gold - b.gold, xp: a.xp - b.xp };
|
||||
}
|
||||
return out;
|
||||
}
|
||||
305
site/server/package-lock.json
generated
@@ -8,8 +8,10 @@
|
||||
"name": "gvr-site-server",
|
||||
"version": "1.0.0",
|
||||
"dependencies": {
|
||||
"@anthropic-ai/sdk": "^0.134.0",
|
||||
"@fastify/cookie": "^11.0.2",
|
||||
"@fastify/static": "^8.2.0",
|
||||
"discord.js": "^14.27.0",
|
||||
"fastify": "^5.6.1",
|
||||
"ws": "^8.18.3"
|
||||
},
|
||||
@@ -21,6 +23,157 @@
|
||||
"typescript": "^5.9.3"
|
||||
}
|
||||
},
|
||||
"node_modules/@anthropic-ai/sdk": {
|
||||
"version": "0.134.0",
|
||||
"resolved": "https://registry.npmjs.org/@anthropic-ai/sdk/-/sdk-0.134.0.tgz",
|
||||
"integrity": "sha512-j0DNXXKUKkr3kKyVR/I3pPWVv93g7vgHjgGYgh9uCXv5IKoXZPWmTwXKiVq/SZSbhBaD3KmtKhIszzt8dBnzog==",
|
||||
"dependencies": {
|
||||
"@opentelemetry/api": "^1.4.1",
|
||||
"json-schema-to-ts": "^3.1.1",
|
||||
"standardwebhooks": "^1.0.0"
|
||||
},
|
||||
"bin": {
|
||||
"anthropic-ai-sdk": "bin/cli"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"zod": "^3.25.0 || ^4.0.0"
|
||||
},
|
||||
"peerDependenciesMeta": {
|
||||
"zod": {
|
||||
"optional": true
|
||||
}
|
||||
}
|
||||
},
|
||||
"node_modules/@babel/runtime": {
|
||||
"version": "7.29.10",
|
||||
"resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.10.tgz",
|
||||
"integrity": "sha512-NpugTzbKgGrNe45Ui32cN8vCFFMxVtP/9rtfwv0nP5FRDAjvYBxJcLVpYA9mr1jxP6cnIT7x9LUzuDTbWYYNRA==",
|
||||
"engines": {
|
||||
"node": ">=6.9.0"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/builders": {
|
||||
"version": "1.14.1",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/builders/-/builders-1.14.1.tgz",
|
||||
"integrity": "sha512-gSKkhXLqs96TCzk66VZuHHl8z2bQMJFGwrXC0f33ngK+FLNau4hU1PYny3DNJfNdSH+gVMzE85/d5FQ2BpcNwQ==",
|
||||
"dependencies": {
|
||||
"@discordjs/formatters": "^0.6.2",
|
||||
"@discordjs/util": "^1.2.0",
|
||||
"@sapphire/shapeshift": "^4.0.0",
|
||||
"discord-api-types": "^0.38.40",
|
||||
"fast-deep-equal": "^3.1.3",
|
||||
"ts-mixer": "^6.0.4",
|
||||
"tslib": "^2.6.3"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=16.11.0"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/collection": {
|
||||
"version": "1.5.3",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/collection/-/collection-1.5.3.tgz",
|
||||
"integrity": "sha512-SVb428OMd3WO1paV3rm6tSjM4wC+Kecaa1EUGX7vc6/fddvw/6lg90z4QtCqm21zvVe92vMMDt9+DkIvjXImQQ==",
|
||||
"engines": {
|
||||
"node": ">=16.11.0"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/formatters": {
|
||||
"version": "0.6.2",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/formatters/-/formatters-0.6.2.tgz",
|
||||
"integrity": "sha512-y4UPwWhH6vChKRkGdMB4odasUbHOUwy7KL+OVwF86PvT6QVOwElx+TiI1/6kcmcEe+g5YRXJFiXSXUdabqZOvQ==",
|
||||
"dependencies": {
|
||||
"discord-api-types": "^0.38.33"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=16.11.0"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/rest": {
|
||||
"version": "2.6.3",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/rest/-/rest-2.6.3.tgz",
|
||||
"integrity": "sha512-wvOylxNYJkwKjctS/Mn5GP1w9r3/rzyH+ThD1JlAca6zEdlHs8QWBBUQJpU5Q+W6DoIj/Ljh1IPlZs7hTU+UAg==",
|
||||
"dependencies": {
|
||||
"@discordjs/collection": "^2.1.1",
|
||||
"@discordjs/util": "^1.2.0",
|
||||
"@sapphire/async-queue": "^1.5.3",
|
||||
"@sapphire/snowflake": "^3.5.5",
|
||||
"@vladfrangu/async_event_emitter": "^2.4.6",
|
||||
"discord-api-types": "^0.38.50",
|
||||
"magic-bytes.js": "^1.13.0",
|
||||
"tslib": "^2.6.3",
|
||||
"undici": "^6.27.0"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/rest/node_modules/@discordjs/collection": {
|
||||
"version": "2.1.1",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/collection/-/collection-2.1.1.tgz",
|
||||
"integrity": "sha512-LiSusze9Tc7qF03sLCujF5iZp7K+vRNEDBZ86FT9aQAv3vxMLihUvKvpsCWiQ2DJq1tVckopKm1rxomgNUc9hg==",
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/util": {
|
||||
"version": "1.2.0",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/util/-/util-1.2.0.tgz",
|
||||
"integrity": "sha512-3LKP7F2+atl9vJFhaBjn4nOaSWahZ/yWjOvA4e5pnXkt2qyXRCHLxoBQy81GFtLGCq7K9lPm9R517M1U+/90Qg==",
|
||||
"dependencies": {
|
||||
"discord-api-types": "^0.38.33"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/ws": {
|
||||
"version": "1.2.3",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/ws/-/ws-1.2.3.tgz",
|
||||
"integrity": "sha512-wPlQDxEmlDg5IxhJPuxXr3Vy9AjYq5xCvFWGJyD7w7Np8ZGu+Mc+97LCoEc/+AYCo2IDpKioiH0/c/mj5ZR9Uw==",
|
||||
"dependencies": {
|
||||
"@discordjs/collection": "^2.1.0",
|
||||
"@discordjs/rest": "^2.5.1",
|
||||
"@discordjs/util": "^1.1.0",
|
||||
"@sapphire/async-queue": "^1.5.2",
|
||||
"@types/ws": "^8.5.10",
|
||||
"@vladfrangu/async_event_emitter": "^2.2.4",
|
||||
"discord-api-types": "^0.38.1",
|
||||
"tslib": "^2.6.2",
|
||||
"ws": "^8.17.0"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=16.11.0"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/ws/node_modules/@discordjs/collection": {
|
||||
"version": "2.1.1",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/collection/-/collection-2.1.1.tgz",
|
||||
"integrity": "sha512-LiSusze9Tc7qF03sLCujF5iZp7K+vRNEDBZ86FT9aQAv3vxMLihUvKvpsCWiQ2DJq1tVckopKm1rxomgNUc9hg==",
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/aix-ppc64": {
|
||||
"version": "0.25.12",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz",
|
||||
@@ -667,16 +820,58 @@
|
||||
"node": ">=8"
|
||||
}
|
||||
},
|
||||
"node_modules/@opentelemetry/api": {
|
||||
"version": "1.9.1",
|
||||
"resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.1.tgz",
|
||||
"integrity": "sha512-gLyJlPHPZYdAk1JENA9LeHejZe1Ti77/pTeFm/nMXmQH/HFZlcS/O2XJB+L8fkbrNSqhdtlvjBVjxwUYanNH5Q==",
|
||||
"engines": {
|
||||
"node": ">=8.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/@pinojs/redact": {
|
||||
"version": "0.4.0",
|
||||
"resolved": "https://registry.npmjs.org/@pinojs/redact/-/redact-0.4.0.tgz",
|
||||
"integrity": "sha512-k2ENnmBugE/rzQfEcdWHcCY+/FM3VLzH9cYEsbdsoqrvzAKRhUZeRNhAZvB8OitQJ1TBed3yqWtdjzS6wJKBwg=="
|
||||
},
|
||||
"node_modules/@sapphire/async-queue": {
|
||||
"version": "1.5.5",
|
||||
"resolved": "https://registry.npmjs.org/@sapphire/async-queue/-/async-queue-1.5.5.tgz",
|
||||
"integrity": "sha512-cvGzxbba6sav2zZkH8GPf2oGk9yYoD5qrNWdu9fRehifgnFZJMV+nuy2nON2roRO4yQQ+v7MK/Pktl/HgfsUXg==",
|
||||
"engines": {
|
||||
"node": ">=v14.0.0",
|
||||
"npm": ">=7.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/@sapphire/shapeshift": {
|
||||
"version": "4.0.0",
|
||||
"resolved": "https://registry.npmjs.org/@sapphire/shapeshift/-/shapeshift-4.0.0.tgz",
|
||||
"integrity": "sha512-d9dUmWVA7MMiKobL3VpLF8P2aeanRTu6ypG2OIaEv/ZHH/SUQ2iHOVyi5wAPjQ+HmnMuL0whK9ez8I/raWbtIg==",
|
||||
"dependencies": {
|
||||
"fast-deep-equal": "^3.1.3",
|
||||
"lodash": "^4.17.21"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=v16"
|
||||
}
|
||||
},
|
||||
"node_modules/@sapphire/snowflake": {
|
||||
"version": "3.5.5",
|
||||
"resolved": "https://registry.npmjs.org/@sapphire/snowflake/-/snowflake-3.5.5.tgz",
|
||||
"integrity": "sha512-xzvBr1Q1c4lCe7i6sRnrofxeO1QTP/LKQ6A6qy0iB4x5yfiSfARMEQEghojzTNALDTcv8En04qYNIco9/K9eZQ==",
|
||||
"engines": {
|
||||
"node": ">=v14.0.0",
|
||||
"npm": ">=7.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/@stablelib/base64": {
|
||||
"version": "1.0.1",
|
||||
"resolved": "https://registry.npmjs.org/@stablelib/base64/-/base64-1.0.1.tgz",
|
||||
"integrity": "sha512-1bnPQqSxSuc3Ii6MhBysoWCg58j97aUjuCSZrGSmDxNqtytIi0k8utUenAwTZN4V5mXXYGsVUI9zeBqy+jBOSQ=="
|
||||
},
|
||||
"node_modules/@types/node": {
|
||||
"version": "22.20.5",
|
||||
"resolved": "https://registry.npmjs.org/@types/node/-/node-22.20.5.tgz",
|
||||
"integrity": "sha512-U2+DNr+wSjpsTS/wZGYHq7GcwfuSmKiKvoPvK22zwTlRhU91yOniN4qRR5KhIjvif7ysw/dz/hKmfDH0Ris4aA==",
|
||||
"dev": true,
|
||||
"dependencies": {
|
||||
"undici-types": "~6.21.0"
|
||||
}
|
||||
@@ -685,11 +880,19 @@
|
||||
"version": "8.18.2",
|
||||
"resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.18.2.tgz",
|
||||
"integrity": "sha512-67MQl+fpWKVTT1NYdnmo3U4sc/xPo/zQBncVnI74qmQa0z/b+1g6iYqNmGCPbxO+zz2aklb08a0oHfegiVd0/w==",
|
||||
"dev": true,
|
||||
"dependencies": {
|
||||
"@types/node": "*"
|
||||
}
|
||||
},
|
||||
"node_modules/@vladfrangu/async_event_emitter": {
|
||||
"version": "2.4.7",
|
||||
"resolved": "https://registry.npmjs.org/@vladfrangu/async_event_emitter/-/async_event_emitter-2.4.7.tgz",
|
||||
"integrity": "sha512-Xfe6rpCTxSxfbswi/W/Pz7zp1WWSNn4A0eW4mLkQUewCrXXtMj31lCg+iQyTkh/CkusZSq9eDflu7tjEDXUY6g==",
|
||||
"engines": {
|
||||
"node": ">=v14.0.0",
|
||||
"npm": ">=7.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/abstract-logging": {
|
||||
"version": "2.0.1",
|
||||
"resolved": "https://registry.npmjs.org/abstract-logging/-/abstract-logging-2.0.1.tgz",
|
||||
@@ -839,6 +1042,37 @@
|
||||
"node": ">=6"
|
||||
}
|
||||
},
|
||||
"node_modules/discord-api-types": {
|
||||
"version": "0.38.56",
|
||||
"resolved": "https://registry.npmjs.org/discord-api-types/-/discord-api-types-0.38.56.tgz",
|
||||
"integrity": "sha512-Hti4RZsGvF5C7SM8rF2MDHtIm0Hyfrlk84GpEA29nj91tvVVMvX+oQSCodu10t2ZcjFGofq8TX0YyC04B2E69Q=="
|
||||
},
|
||||
"node_modules/discord.js": {
|
||||
"version": "14.27.0",
|
||||
"resolved": "https://registry.npmjs.org/discord.js/-/discord.js-14.27.0.tgz",
|
||||
"integrity": "sha512-qHbFlFG2N7y3LjPySYsL6A1+BnX6bkTVgo842EX0CqVPk/KTMwZkojPHEXKsQUpWZNyz5BISNHK1cPpQw0+m4A==",
|
||||
"dependencies": {
|
||||
"@discordjs/builders": "^1.14.1",
|
||||
"@discordjs/collection": "1.5.3",
|
||||
"@discordjs/formatters": "^0.6.2",
|
||||
"@discordjs/rest": "^2.6.2",
|
||||
"@discordjs/util": "^1.2.0",
|
||||
"@discordjs/ws": "^1.2.3",
|
||||
"@sapphire/snowflake": "3.5.5",
|
||||
"discord-api-types": "^0.38.49",
|
||||
"fast-deep-equal": "3.1.3",
|
||||
"lodash.snakecase": "4.1.1",
|
||||
"magic-bytes.js": "^1.13.0",
|
||||
"tslib": "^2.6.3",
|
||||
"undici": "^6.27.0"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/esbuild": {
|
||||
"version": "0.25.12",
|
||||
"resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz",
|
||||
@@ -926,6 +1160,11 @@
|
||||
"fast-decode-uri-component": "^1.0.1"
|
||||
}
|
||||
},
|
||||
"node_modules/fast-sha256": {
|
||||
"version": "1.3.0",
|
||||
"resolved": "https://registry.npmjs.org/fast-sha256/-/fast-sha256-1.3.0.tgz",
|
||||
"integrity": "sha512-n11RGP/lrWEFI/bWdygLxhI+pVeo1ZYIVwvvPkW7azl/rOy+F3HYRZ2K5zeE9mmkhQppyv9sQFx0JM9UabnpPQ=="
|
||||
},
|
||||
"node_modules/fast-uri": {
|
||||
"version": "4.2.2",
|
||||
"resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-4.2.2.tgz",
|
||||
@@ -1130,6 +1369,18 @@
|
||||
"dequal": "^2.0.3"
|
||||
}
|
||||
},
|
||||
"node_modules/json-schema-to-ts": {
|
||||
"version": "3.1.1",
|
||||
"resolved": "https://registry.npmjs.org/json-schema-to-ts/-/json-schema-to-ts-3.1.1.tgz",
|
||||
"integrity": "sha512-+DWg8jCJG2TEnpy7kOm/7/AxaYoaRbjVB4LFZLySZlWn8exGs3A4OLJR966cVvU26N7X9TWxl+Jsw7dzAqKT6g==",
|
||||
"dependencies": {
|
||||
"@babel/runtime": "^7.18.3",
|
||||
"ts-algebra": "^2.0.0"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=16"
|
||||
}
|
||||
},
|
||||
"node_modules/json-schema-traverse": {
|
||||
"version": "1.0.0",
|
||||
"resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
|
||||
@@ -1156,6 +1407,16 @@
|
||||
"set-cookie-parser": "^3.0.1"
|
||||
}
|
||||
},
|
||||
"node_modules/lodash": {
|
||||
"version": "4.18.1",
|
||||
"resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
|
||||
"integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q=="
|
||||
},
|
||||
"node_modules/lodash.snakecase": {
|
||||
"version": "4.1.1",
|
||||
"resolved": "https://registry.npmjs.org/lodash.snakecase/-/lodash.snakecase-4.1.1.tgz",
|
||||
"integrity": "sha512-QZ1d4xoBHYUeuouhEq3lk3Uq7ldgyFXGBhg04+oRLnIz8o9T65Eh+8YdroUwn846zchkA9yDsDl5CVVaV2nqYw=="
|
||||
},
|
||||
"node_modules/lru-cache": {
|
||||
"version": "11.5.3",
|
||||
"resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.3.tgz",
|
||||
@@ -1164,6 +1425,11 @@
|
||||
"node": "20 || >=22"
|
||||
}
|
||||
},
|
||||
"node_modules/magic-bytes.js": {
|
||||
"version": "1.13.1",
|
||||
"resolved": "https://registry.npmjs.org/magic-bytes.js/-/magic-bytes.js-1.13.1.tgz",
|
||||
"integrity": "sha512-x5sn4UX2k5gCWlcfmoFwG4TPie8+dctESyqOBdhB5p6MsgWXdBKGmt9nXPObj/JI50TTL928lc5Yt1WntMn1bw=="
|
||||
},
|
||||
"node_modules/mime": {
|
||||
"version": "3.0.0",
|
||||
"resolved": "https://registry.npmjs.org/mime/-/mime-3.0.0.tgz",
|
||||
@@ -1452,6 +1718,15 @@
|
||||
"node": ">= 10.x"
|
||||
}
|
||||
},
|
||||
"node_modules/standardwebhooks": {
|
||||
"version": "1.1.1",
|
||||
"resolved": "https://registry.npmjs.org/standardwebhooks/-/standardwebhooks-1.1.1.tgz",
|
||||
"integrity": "sha512-bCbX9ZEyFkWPsRz7Bl3NuQUJohmwGSev/yhr7vhaGPlc4AfIrspIRa6cPTBuI1ItmrTDJ4d/S2hCsfe4+vQGnQ==",
|
||||
"dependencies": {
|
||||
"@stablelib/base64": "^1.0.0",
|
||||
"fast-sha256": "^1.3.0"
|
||||
}
|
||||
},
|
||||
"node_modules/statuses": {
|
||||
"version": "2.0.2",
|
||||
"resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
|
||||
@@ -1487,6 +1762,21 @@
|
||||
"node": ">=0.6"
|
||||
}
|
||||
},
|
||||
"node_modules/ts-algebra": {
|
||||
"version": "2.0.0",
|
||||
"resolved": "https://registry.npmjs.org/ts-algebra/-/ts-algebra-2.0.0.tgz",
|
||||
"integrity": "sha512-FPAhNPFMrkwz76P7cdjdmiShwMynZYN6SgOujD1urY4oNm80Ou9oMdmbR45LotcKOXoy7wSmHkRFE6Mxbrhefw=="
|
||||
},
|
||||
"node_modules/ts-mixer": {
|
||||
"version": "6.0.4",
|
||||
"resolved": "https://registry.npmjs.org/ts-mixer/-/ts-mixer-6.0.4.tgz",
|
||||
"integrity": "sha512-ufKpbmrugz5Aou4wcr5Wc1UUFWOLhq+Fm6qa6P0w0K5Qw2yhaUoiWszhCVuNQyNwrlGiscHOmqYoAox1PtvgjA=="
|
||||
},
|
||||
"node_modules/tslib": {
|
||||
"version": "2.8.1",
|
||||
"resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
|
||||
"integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="
|
||||
},
|
||||
"node_modules/tsx": {
|
||||
"version": "4.23.15",
|
||||
"resolved": "https://registry.npmjs.org/tsx/-/tsx-4.23.15.tgz",
|
||||
@@ -1975,11 +2265,18 @@
|
||||
"node": ">=14.17"
|
||||
}
|
||||
},
|
||||
"node_modules/undici": {
|
||||
"version": "6.29.0",
|
||||
"resolved": "https://registry.npmjs.org/undici/-/undici-6.29.0.tgz",
|
||||
"integrity": "sha512-R+RODBqp6i2pPflGdq+xIOUkl+RNfGgHwoinecKu/JCuf2uO06cOKoDbI2P7Dn6KcswdKwrczbU6IYJ6K8X+wg==",
|
||||
"engines": {
|
||||
"node": ">=18.17"
|
||||
}
|
||||
},
|
||||
"node_modules/undici-types": {
|
||||
"version": "6.21.0",
|
||||
"resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
|
||||
"integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
|
||||
"dev": true
|
||||
"integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ=="
|
||||
},
|
||||
"node_modules/which": {
|
||||
"version": "2.0.2",
|
||||
|
||||
@@ -12,8 +12,10 @@
|
||||
"test": "node --import tsx --test test/*.test.ts"
|
||||
},
|
||||
"dependencies": {
|
||||
"@anthropic-ai/sdk": "^0.134.0",
|
||||
"@fastify/cookie": "^11.0.2",
|
||||
"@fastify/static": "^8.2.0",
|
||||
"discord.js": "^14.27.0",
|
||||
"fastify": "^5.6.1",
|
||||
"ws": "^8.18.3"
|
||||
},
|
||||
|
||||
36
site/server/prompt/knowledge-lol.md
Normal file
42
site/server/prompt/knowledge-valorant.md
Normal file
@@ -0,0 +1,42 @@
|
||||
<!-- 발로란트 지식 묶음 v1 (초안, 2026-10-15). system 프롬프트 뒤에 <knowledge> 로 붙인다.
|
||||
"자동 갱신" 칸은 valorant-api.com(ko-KR)에서 패치마다 다시 만든다 (tools/gen-dictionary.mjs 와 같은 소스). 아래는 2026-10-15 스냅샷. -->
|
||||
<knowledge game="valorant">
|
||||
## 경기 규칙
|
||||
- 13라운드를 먼저 이기면 승리. 12:12 이면 연장(경쟁전은 2라운드 차가 날 때까지). 12라운드 뒤 공수 교대.
|
||||
- 1라운드와 13라운드는 권총 라운드. 라운드는 구매 시간 30초 + 교전 1분 40초. 스파이크 설치 뒤 45초면 폭발, 해체는 7초(절반 지점 저장).
|
||||
- 공격: 스파이크 설치나 전멸로 승리. 수비: 전멸, 해체, 시간 초과로 승리.
|
||||
|
||||
## 경제 (패치에 따라 조금 바뀔 수 있음)
|
||||
- 시작 800, 라운드 승리 3,000, 패배 1,900 → 연패마다 +500 (최대 2,900), 킬 200, 설치 300(공격팀 전원). 최대 9,000.
|
||||
- 풀바이 = 라이플(밴달·팬텀 2,900) 또는 오퍼레이터(4,700) + 실드 + 스킬, 대략 3,900 이상. 에코(세이브) = 거의 안 삼. 포스바이 = 돈이 모자라도 삼. 하프바이 = 중간.
|
||||
- 팀이 같이 세이브하는 건 정상 운영이다. 혼자만 사거나 혼자만 안 사서 팀 경제가 어긋나면 감점.
|
||||
- 상대가 에코인 라운드를 지는 것은 큰 손실. 에코 라운드에서 딴 킬은 가치가 낮다.
|
||||
|
||||
## 역할별 기준
|
||||
- 타격대(제트·레이즈·레이나 등): 진입해서 첫 교전을 열고 공간을 만든다. 첫 데스가 많아도 팀이 바로 복수(트레이드)하면 정상. 트레이드도 안 되는 혼자 진입이 반복되면 감점.
|
||||
- 척후대(소바·브리치·스카이 등): 정보와 진입 보조. 어시스트, 정찰 정보 콜이 중요.
|
||||
- 전략가(오멘·브림스톤·아스트라 등): 연막으로 시야를 끊어 진입·리테이크를 돕는다. 오래 살아남는 것이 중요. 킬이 적어도 정상.
|
||||
- 감시자(킬조이·사이퍼·세이지 등): 사이트 수비, 측면 차단, 리테이크. 전투 점수가 낮은 게 흔하다. 세이지 부활은 큰 기여.
|
||||
- 역할이 겹치면(타격대 3명 등) 판단을 팀 구성 탓으로 돌리지 말고 각자 맡은 일을 했는지 본다.
|
||||
|
||||
## 지표
|
||||
- 전투 점수(ACS): 라운드당 평균. 보통 200 안팎, 250 넘으면 높음, 150 아래면 낮음.
|
||||
- 라운드당 피해량: 보통 130~150. 첫 킬 · 첫 데스: 라운드 첫 교전 결과로 라운드 승률에 크게 영향.
|
||||
- 클러치: 혼자 남아 여러 명을 상대로 라운드를 이김. 멀티킬 · 에이스(5킬).
|
||||
- 막판 정리 킬(이미 진 라운드에서 도망가는 적을 잡음)은 숫자를 부풀린다.
|
||||
|
||||
## 콜아웃 · 은어 (음성·채팅에 나오는 말)
|
||||
- 장소: A/B/C 사이트, 메인, 롱, 숏(쇼트), 미드, 헤븐, 마켓, 로비, 링크, 백사이트, 개구멍, 문, 계단, 창문, 엘보, 지붕, 하수구, 텔레포터, 로프, 파이프, 정원, 트리, 박스, 기둥.
|
||||
- 전투: 원탭/투탭(머리 한두 발), 헤드, 퍼블·첫킬, 각(사격 위치), 피킹(엄폐물에서 나와 쏨), 프리파이어(미리 쏨), 트레이드(복수 킬), 리테이크(설치 뒤 사이트 탈환), 로테(다른 사이트로 이동), 스택(한 사이트에 몰림), 디폴트(흩어져 정보 수집), 러시·패스트(빠른 진입), 원웨이(한쪽만 보이는 연막), 몰리(화염), 플래시·섬광, 연막·스모크, 궁(궁극기), 오브.
|
||||
- 상태: "하나 남았어"(적 1명), "피 30"(체력 30), "깎였어"(맞음), "세이브해"(무기 아끼고 살아라), "에코/이코", "풀바이", "포스".
|
||||
- 태도: ㅈㅈ·ff(포기), "던졌네"(실수로 경기를 망침), "버스 탔다"(남이 이겨 줌).
|
||||
|
||||
## 음성 인식이 자주 틀리는 말
|
||||
레이저→레이즈, 비 싸이트→B 사이트, 에이 싸이트→A 사이트, 로태→로테, 오퍼래이터→오퍼레이터, 반달→밴달, 펜텀→팬텀, 쉐리프·세리프→셰리프, 디퓨저→디퓨즈, 킬 조이→킬조이, 브림 스톤→브림스톤, 아스트로→아스트라, 클로버→클로브.
|
||||
숫자·알파벳 콜아웃(A, B, 피 30)은 한글로 받아 적히거나("에이", "비") 빠지기 쉽다.
|
||||
|
||||
## 자동 갱신 (2026-10-15 스냅샷)
|
||||
- 요원 (역할): 척후대: 게코, 브리치, 소바, 스카이, 케이/오, 테호, 페이드 / 감시자: 데드록, 바이스, 비토, 사이퍼, 세이지, 체임버, 킬조이 / 타격대: 네온, 레이나, 레이즈, 아이소, 요루, 웨이레이, 제트, 피닉스 / 전략가: 믹스, 바이퍼, 브림스톤, 아스트라, 오멘, 클로브, 하버
|
||||
- 맵: 어센트, 스플릿, 프랙처, 바인드, 브리즈, 어비스, 로터스, 선셋, 펄, 서밋, 아이스박스, 코로드, 헤이븐
|
||||
- 무기 (가격): 오딘 3200, 아레스 1600, 밴달 2900, 워든 2900, 불독 2050, 팬텀 2900, 저지 1850, 버키 850, 프렌지 450, 클래식 0, 밴딧 600, 고스트 500, 셰리프 800, 쇼티 300, 오퍼레이터 4700, 가디언 2250, 아웃로 2400, 마샬 950, 스펙터 1600, 스팅어 1100
|
||||
</knowledge>
|
||||
52
site/server/prompt/output-schema.json
Normal file
@@ -0,0 +1,52 @@
|
||||
{
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["summary", "confidence", "confidence_note", "teams", "players"],
|
||||
"properties": {
|
||||
"summary": { "type": "string", "description": "경기 한 줄 요약, 1~2문장" },
|
||||
"confidence": { "type": "string", "enum": ["high", "medium", "low"] },
|
||||
"confidence_note": { "type": "string", "description": "confidence 가 medium/low 인 이유. high 면 빈 문자열" },
|
||||
"teams": {
|
||||
"type": "array",
|
||||
"description": "우리 팀, 상대 팀 순서로 2개",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["team", "culprit", "reason", "evidence"],
|
||||
"properties": {
|
||||
"team": { "type": "string", "enum": ["ally", "enemy"] },
|
||||
"culprit": { "type": "string", "description": "P1~P10" },
|
||||
"reason": { "type": "string", "description": "2~3문장" },
|
||||
"evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } }
|
||||
}
|
||||
}
|
||||
},
|
||||
"players": {
|
||||
"type": "array",
|
||||
"description": "P1~P10 순서로 10명",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["id", "score", "tag", "comment", "evidence"],
|
||||
"properties": {
|
||||
"id": { "type": "string", "description": "P1~P10" },
|
||||
"score": { "type": "number", "description": "1.0~10.0, 0.5 단위" },
|
||||
"tag": { "type": "string", "enum": ["캐리", "숨은 MVP", "클러치", "무난", "아쉬움", "범인"] },
|
||||
"comment": { "type": "string", "description": "한 줄 평, 40자 안팎" },
|
||||
"evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } }
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"$defs": {
|
||||
"evidence": {
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["ref", "note"],
|
||||
"properties": {
|
||||
"ref": { "type": "string", "description": "자료의 근거 번호: e123 · u456 · c7 · r21 · s:P4" },
|
||||
"note": { "type": "string", "description": "이 근거가 뜻하는 것. 대화면 원문 인용" }
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||