v1.3.7 보고서 PDF · 테스트 기록

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
EJClaw
2026-10-16 05:44:07 +09:00
parent 5d494eb8e8
commit 31fd18a0e9
3 changed files with 297 additions and 0 deletions

View File

@@ -221,3 +221,4 @@ VOICE E2E PASS
8. TTS 속도 바꾸기가 중간에 죽으면 반쪽 파일이 계속 쓰임 → 다 만든 뒤 이름 바꾸기
- 그 밖: 브라우저 오류 로그에 검색어가 남던 것, 경기 끝 직후 늦게 끝난 실시간 변환의 잡음 파일을 정밀 확인 전에 지우던 것, 많이 골랐을 때 내려받기 주소가 너무 길던 것(본문으로 보냄), zip 풀기 메모리 한도 600MB, 날짜 묶음이 "10월"로만 나오던 것(경기 · 기록 목록)
- 테스트: 앱 53 · 사이트 서버 16 · 워커 42 통과, 타입 검사 통과
- 배포: 사이트 서버 다시 배포 (`/api/%62undles/delete` 로그인 없이 401), Windows CI (5d494eb, full) 7개 모두 PASS · 앱 버전 1.3.7 → Gitea 릴리스 v1.3.7 (v1.3.6 에 새 버전 안내) · 보고서 `docs/gemnoki-v1.3.7-report.pdf`

Binary file not shown.

View File

@@ -0,0 +1,296 @@
<!doctype html>
<html lang="ko"><head><meta charset="utf-8"><title>겜녹이 v1.3.6 · v1.3.7 수정 보고서</title>
<style>
@page { size: A4; margin: 16mm 15mm 18mm 15mm; }
:root {
--ink: #1b1f27; --muted: #5d6675; --line: #d9dee6; --soft: #f3f5f8;
--accent: #ff4655; --accent2: #0fb5ae; --warn: #f2a516; --dark: #0f1923;
}
* { box-sizing: border-box; }
body { font-family: "Noto Sans CJK KR", "NanumBarunGothic", sans-serif; color: var(--ink);
font-size: 10pt; line-height: 1.6; margin: 0; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
h1, h2, h3 { font-family: "NanumSquare Neo", "Noto Sans CJK KR", sans-serif; line-height: 1.3; }
h2 { font-size: 16pt; margin: 0 0 10px; padding-bottom: 6px; border-bottom: 3px solid var(--dark); }
h2 .num { color: var(--accent); margin-right: 8px; }
h3 { font-size: 11.5pt; margin: 16px 0 6px; color: var(--dark); }
p { margin: 4px 0 8px; }
code, .mono { font-family: "D2Coding ligature", "DejaVu Sans Mono", monospace; font-size: 9pt; }
.page { margin-bottom: 22px; }
.cover { page-break-after: always; }
h2, h3 { break-after: avoid; }
tr, .card, .q, .callout, .arch, .pipe, .row { break-inside: avoid; }
table { width: 100%; border-collapse: collapse; margin: 6px 0 10px; font-size: 9pt; }
th, td { border: 1px solid var(--line); padding: 5px 7px; vertical-align: top; text-align: left; }
th { background: var(--dark); color: #fff; font-weight: 600; }
tr:nth-child(even) td { background: #fafbfc; }
ul { margin: 4px 0 8px; padding-left: 18px; }
li { margin: 2px 0; }
.callout { border-left: 4px solid var(--accent); background: #fff3f4; padding: 8px 12px; margin: 8px 0; border-radius: 0 6px 6px 0; }
.callout.info { border-color: var(--accent2); background: #ecfaf9; }
.callout.warn { border-color: var(--warn); background: #fff8e8; }
.callout b.t { display: block; margin-bottom: 2px; }
.tag { display: inline-block; font-size: 8pt; padding: 1px 6px; border-radius: 9px; background: var(--soft); border: 1px solid var(--line); margin-right: 3px; }
.tag.red { background: #ffe5e7; border-color: #ffb3b9; color: #b0122a; }
.tag.green { background: #e2f7ef; border-color: #a6e3c9; color: #116b47; }
.tag.yellow { background: #fff2cf; border-color: #f5d27a; color: #7a5600; }
.grid2 { display: grid; grid-template-columns: 1fr 1fr; gap: 10px; }
.card { border: 1px solid var(--line); border-radius: 8px; padding: 8px 10px; background: #fff; }
.card h4 { margin: 0 0 4px; font-size: 10pt; font-family: "NanumSquare Neo", sans-serif; }
.small { font-size: 8.5pt; color: var(--muted); }
/* cover */
.cover { height: 260mm; background: var(--dark); color: #fff; padding: 16mm 18mm; position: relative; overflow: hidden; }
.cover .bar { width: 70px; height: 6px; background: var(--accent); margin-bottom: 18px; }
.cover h1 { font-size: 30pt; margin: 0 0 6px; letter-spacing: -0.5px; }
.cover .sub { font-size: 12pt; color: #c9d1dc; margin-bottom: 12px; }
.cover .meta td { border: none; color: #c9d1dc; padding: 1.5px 12px 1.5px 0; background: transparent !important; font-size: 10pt; }
.cover .meta td:first-child { color: #7f8b99; width: 100px; white-space: nowrap; }
.cover .wave { position: absolute; left: 18mm; right: 18mm; bottom: 40mm; display: flex; align-items: center; gap: 4px; height: 70px; }
.cover .wave span { flex: 1; background: linear-gradient(var(--accent), #ff8a94); border-radius: 3px; opacity: .85; }
.cover .foot { position: absolute; left: 18mm; bottom: 18mm; color: #7f8b99; font-size: 9pt; }
/* architecture diagram */
.arch { border: 2px dashed #9aa6b5; border-radius: 10px; padding: 10px; position: relative; margin-top: 6px; }
.arch .label { position: absolute; top: -10px; left: 12px; background: #fff; padding: 0 6px; font-weight: 700; font-size: 9pt; color: var(--muted); }
.box { border-radius: 7px; padding: 6px 8px; font-size: 8.6pt; border: 1px solid; }
.box b { display: block; font-size: 9pt; }
.b-core { background: #eef2f8; border-color: #b9c6d9; }
.b-stt { background: #ecfaf9; border-color: #94dcd8; }
.b-ui { background: #fff3f4; border-color: #ffb3b9; }
.b-ext { background: #fff8e8; border-color: #f2d083; }
.row { display: flex; gap: 8px; margin: 6px 0; }
.row > * { flex: 1; }
.arrow { text-align: center; color: var(--muted); font-size: 9pt; margin: 2px 0; }
/* pipeline */
.pipe { display: flex; gap: 4px; align-items: stretch; margin: 8px 0; }
.pipe .st { flex: 1; background: var(--soft); border: 1px solid var(--line); border-radius: 6px; padding: 6px; font-size: 8.2pt; position: relative; }
.pipe .st b { display: block; font-size: 8.8pt; color: var(--dark); }
.pipe .st .n { position: absolute; top: -8px; left: 6px; background: var(--accent); color: #fff; border-radius: 8px; font-size: 7.5pt; padding: 0 5px; }
.q { border: 1px solid var(--line); border-radius: 8px; padding: 7px 10px; margin: 6px 0; break-inside: avoid; }
.q .qh { font-weight: 700; font-family: "NanumSquare Neo", sans-serif; }
.q .qh .id { color: #fff; background: var(--accent); border-radius: 5px; padding: 0 6px; margin-right: 6px; font-size: 9pt; }
.q .rec { color: #116b47; font-size: 9pt; }
.q .ans { background:#f6f1e6; border-left:3px solid #c8aa6e; padding:3px 8px; margin:4px 0 3px; border-radius:0 5px 5px 0; font-size:9.2pt; }
.q .ans b { color:#8a6d35; margin-right:4px; }
.toc li { margin: 3px 0; }
/* figures & infographics */
figure { margin: 10px 0 12px; break-inside: avoid; }
figure img.shot { width: 100%; border-radius: 8px; box-shadow: 0 4px 14px rgba(15,25,35,.25); border: 1px solid #263544; display: block; }
figcaption { font-size: 8.5pt; color: var(--muted); margin-top: 5px; }
figcaption b { color: var(--ink); }
.ex { display:inline-block; font-size:7.5pt; background:#eef1f5; border:1px solid var(--line); border-radius:4px; padding:0 5px; margin-left:4px; color:var(--muted); }
.flow { display:flex; align-items:flex-start; margin: 10px 0 6px; position:relative; break-inside: avoid; }
.flow:before { content:""; position:absolute; left:6%; right:6%; top:23px; height:3px; background: linear-gradient(90deg, var(--accent), var(--accent2)); border-radius:2px; }
.flow .s { flex:1; text-align:center; position:relative; padding:0 2px; }
.flow .ic { width:46px; height:46px; border-radius:50%; background:#fff; border:3px solid var(--dark); margin:0 auto 5px; display:flex; align-items:center; justify-content:center; font-size:19px; position:relative; z-index:1; }
.flow .s:nth-child(odd) .ic { border-color: var(--accent); }
.flow .s:nth-child(even) .ic { border-color: var(--accent2); }
.flow .t { font-weight:700; font-size:8.6pt; font-family:"NanumSquare Neo",sans-serif; line-height:1.3; }
.flow .d { font-size:7.6pt; color:var(--muted); line-height:1.35; margin-top:2px; }
.flow .n { position:absolute; top:-4px; left:50%; margin-left:12px; background:var(--dark); color:#fff; font-size:7pt; border-radius:7px; padding:0 4px; z-index:2; }
.stats { display:grid; grid-template-columns: repeat(4, 1fr); gap:8px; margin: 8px 0 10px; break-inside: avoid; }
.stat { background: var(--dark); color:#fff; border-radius:10px; padding:10px 12px; }
.stat .v { font-family:"NanumSquare Neo",sans-serif; font-size:19pt; font-weight:800; line-height:1.1; }
.stat .v small { font-size:10pt; font-weight:700; color:#c9d1dc; margin-left:2px; }
.stat .l { font-size:8pt; color:#c9d1dc; margin-top:3px; line-height:1.35; }
.stat:nth-child(1) .v { color:#ff7a85; } .stat:nth-child(2) .v { color:#4fd8cf; } .stat:nth-child(3) .v { color:#ffc86a; } .stat:nth-child(4) .v { color:#9fc4ff; }
.viz { border:1px solid var(--line); border-radius:10px; padding:10px 12px; background:#fcfcfb; break-inside: avoid; margin: 8px 0 10px; }
.viz .vt { font-weight:700; font-size:9.5pt; font-family:"NanumSquare Neo",sans-serif; margin-bottom:2px; }
.viz .vs { font-size:8pt; color:var(--muted); margin-bottom:6px; }
.legend { display:flex; gap:14px; font-size:8pt; color:#52514e; margin:4px 0 6px; flex-wrap:wrap; }
.legend i { display:inline-block; width:10px; height:10px; border-radius:2px; margin-right:4px; vertical-align:-1px; }
.vbar { display:flex; align-items:center; gap:8px; margin:5px 0; font-size:8.4pt; }
.vbar .lab { width:150px; flex:none; color:#0b0b0b; }
.vbar .lab small { color:#52514e; }
.vbar .track { flex:1; display:flex; gap:2px; height:20px; }
.vbar .seg { height:100%; display:flex; align-items:center; justify-content:center; font-size:7.6pt; color:#fff; white-space:nowrap; overflow:hidden; }
.vbar .seg:first-child { border-radius:4px 0 0 4px; } .vbar .seg:last-child { border-radius:0 4px 4px 0; }
.vbar .tot { width:38px; text-align:right; color:#52514e; font-size:8pt; }
.dtree { display:flex; align-items:stretch; gap:6px; margin:8px 0; break-inside: avoid; }
.dtree .col { flex:1; display:flex; flex-direction:column; align-items:center; gap:4px; }
.dtree .qq { margin:0; width:100%; text-align:center; font-size:8.2pt; padding:6px; background:#fff; border:1.5px solid var(--dark); border-radius:8px; }
.dtree .yes { font-size:7.6pt; color:#b0122a; font-weight:700; }
.dtree .noise { width:100%; text-align:center; background:#eef0f3; color:#5d6675; border:1px dashed #9aa6b5; border-radius:8px; padding:4px; font-size:8pt; font-style:italic; }
.dtree .ar { align-self:center; color:var(--muted); font-size:13pt; margin-top:-26px; }
.dtree .ok { background:#ecfaf9; border:1.5px solid var(--accent2); border-radius:8px; padding:6px; text-align:center; font-size:8.2pt; width:100%; }
.gantt { border:1px solid var(--line); border-radius:10px; padding:10px 12px; background:#fcfcfb; break-inside: avoid; }
.gantt .hd, .gantt .gr { display:grid; grid-template-columns: 170px repeat(12, 1fr); align-items:center; }
.gantt .gr .b.opt2 { background:#c8aa6e; color:#1e1a12; }
.gantt .hd div { font-size:7.8pt; color:#52514e; text-align:center; border-left:1px dashed #e1e4e8; }
.gantt .hd div:first-child { border:none; text-align:left; }
.gantt .gr { height:24px; font-size:8.4pt; }
.gantt .gr .nm { color:#0b0b0b; }
.gantt .gr .b { height:14px; border-radius:4px; background:#2a78d6; color:#fff; font-size:7.4pt; display:flex; align-items:center; padding-left:6px; white-space:nowrap; }
.gantt .gr .b.opt { background: repeating-linear-gradient(45deg,#cfd6df,#cfd6df 4px,#e6eaef 4px,#e6eaef 8px); color:#52514e; }
.shots2 { display:grid; grid-template-columns: 1.7fr 1fr; gap:10px; align-items:start; }
.cover .hero { position:absolute; left:18mm; right:-14mm; top:164mm; height:64mm; overflow:hidden; border-radius:10px; }
.brandrow { display:grid; grid-template-columns: 1fr 3.2fr; gap:12px; align-items:start; margin:8px 0 10px; }
.sw { display:inline-block; width:12px; height:12px; border-radius:3px; vertical-align:-1px; margin-right:6px; border:1px solid #c9d1dc; }
.cover .ban { display:block; width:100%; border-radius:10px; border:1px solid #2f4152; margin:0 0 14px; box-shadow:0 12px 40px rgba(0,0,0,.5); }
.cover .hero img { width:100%; border-radius:10px; box-shadow: 0 20px 60px rgba(0,0,0,.6); border:1px solid #2f4152; }
figure { margin: 8px 0 12px; break-inside: avoid; }
figure img { width: 100%; border: 1px solid var(--line); border-radius: 6px; display: block; }
figcaption { font-size: 8.5pt; color: var(--muted); margin-top: 3px; }
.two { display: grid; grid-template-columns: 1fr 1fr; gap: 10px; }
.legend i { display: inline-block; width: 10px; height: 10px; border-radius: 2px; vertical-align: -1px; margin: 0 3px 0 8px; }
.pb { page-break-before: always; }
td.num { text-align: right; white-space: nowrap; }
</style>
</head><body>
<section class="cover">
<div class="bar"></div>
<h1>겜녹이 수정 보고서</h1>
<div class="sub">v1.3.6 · v1.3.7 — 목소리 깨짐 분석, 요청 사항 반영, 오류 점검</div>
<table class="meta">
<tr><td>작성일</td><td>2026-10-16</td></tr>
<tr><td>대상 버전</td><td>게임 PC 앱 v1.3.7 (v1.3.6 포함) · 사이트 gvr.tkrmagid.kr</td></tr>
<tr><td>릴리스</td><td>git.tkrmagid.kr/tkrmagid/game_voice_recorder/releases/tag/v1.3.7</td></tr>
<tr><td>분석 자료</td><td>사용자가 보낸 GVR-Data (발화 40개 · 데스매치 1경기 · exe 로그) · 사이트 화면 캡처 2장</td></tr>
<tr><td>확인</td><td>앱 테스트 53 · 사이트 서버 16 · 음성 인식 워커 42 통과, Windows 빌드 검사 7개 통과</td></tr>
</table>
<div class="wave"><span style="height:30%"></span><span style="height:55%"></span><span style="height:80%"></span><span style="height:45%"></span><span style="height:95%"></span><span style="height:60%"></span><span style="height:35%"></span><span style="height:70%"></span><span style="height:88%"></span><span style="height:50%"></span><span style="height:25%"></span><span style="height:65%"></span><span style="height:90%"></span><span style="height:40%"></span><span style="height:75%"></span><span style="height:55%"></span><span style="height:30%"></span><span style="height:85%"></span><span style="height:60%"></span><span style="height:45%"></span><span style="height:70%"></span><span style="height:95%"></span><span style="height:50%"></span><span style="height:35%"></span><span style="height:80%"></span><span style="height:60%"></span><span style="height:40%"></span><span style="height:72%"></span><span style="height:92%"></span><span style="height:48%"></span></div>
<div class="foot">Game Voice Recorder · 겜녹이</div>
</section>
<section class="page">
<h2><span class="num">1</span>요약</h2>
<table>
<tr><th style="width:28%">요청 · 문제</th><th style="width:12%">결과</th><th>한 줄 설명</th></tr>
<tr><td>목소리가 깨져서 저장됨</td><td><span class="tag green">고침</span></td><td>녹음기가 패킷 도착 간격으로 쉼을 채워, 게임 중 몰려 온 패킷 사이에 20ms 무음이 계속 끼었다. 디스코드 RTP 시각 기준으로 바꾸고 예전 녹음도 고친다</td></tr>
<tr><td>말한 사람 "알 수 없음"</td><td><span class="tag green">고침</span></td><td>앱이 유저 목록 갱신을 빈 목록으로 보내 사이트 목록이 비었다</td></tr>
<tr><td>잡음만 있으면 표시하지 않기 · ogg 삭제 · 로그에 잡음</td><td><span class="tag green">완료</span></td><td>사이트에 안 보이고 파일도 지운다. 로그에 "잡음 발화 … 숨김 · 음성 파일 삭제 (이유, 인식 문장)"</td></tr>
<tr><td>켜는 중 작은 창</td><td><span class="tag green">완료</span></td><td>포터블 exe 를 푸는 동안 그림 창, 앱이 켜지는 동안 "켜는 중" 창</td></tr>
<tr><td>녹음 안내 TTS 속도 0.1~2.0</td><td><span class="tag green">완료</span></td><td>디스코드 탭 "말 속도". 0.5배보다 느린 부분은 음성 인식 엔진이 늘린다</td></tr>
<tr><td>사이트 재생 음량</td><td><span class="tag green">완료</span></td><td>플레이어 막대 0~200%, 음소거</td></tr>
<tr><td>사이트 로그 (게임 PC 꺼져도)</td><td><span class="tag green">완료</span></td><td>gvr.tkrmagid.kr/logs (관리자), 날짜별 보기 · 내려받기, 14일 보관</td></tr>
<tr><td>우클릭 → 자세한 정보 · 다운로드</td><td><span class="tag green">완료</span></td><td>원본 ogg 이름 · 게임 PC 경로 · 크기 · 인식 정보, ogg 다운로드</td></tr>
<tr><td>지금 게임 자세한 정보 (앱 · 사이트)</td><td><span class="tag green">완료</span></td><td>상태 · 모드 · 맵 · 라운드 · 점수 · 내 요원/챔피언 · KDA · 게임 시간</td></tr>
<tr><td>경기별 묶어 관리 · 경기 전후 대화 묶음</td><td><span class="tag green">완료</span></td><td>사이트 "기록" 탭. 한 번에 지우기 · zip 내려받기 · zip 받아오기(빠진 내용이 있으면 실패)</td></tr>
<tr><td>분석 중 찾은 문제</td><td><span class="tag green">고침</span></td><td>데스매치 가짜 라운드 · 에이스, 빈 선수 이름("주인 계정 자동 연결: #")</td></tr>
<tr><td>전체 코드 검토로 찾은 오류 8개 + 5개</td><td><span class="tag green">고침</span></td><td>관리자 확인 우회, 큰 zip 전송 중 연결 끊김, 진행 중 경기 지우기 등 (6장)</td></tr>
</table>
</section>
<section class="page pb">
<h2><span class="num">2</span>목소리 깨짐 분석</h2>
<h3>보내 주신 파일에서 본 것</h3>
<p>ogg 파일을 패킷(20ms) 단위로 열어 보니, 게임 중 파일은 거의 모두 "목소리 2개 → 무음 1개"가 되풀이되었다. 아래는 "S매치 되는지 한번 해봐야겠다…" 발화의 앞 200개 패킷이다.</p>
<figure><img src="img/packets.png"><figcaption class="legend"><i style="background:#14aaa0"></i>목소리 패킷 <i style="background:#e63c46"></i>녹음기가 끼워 넣은 무음 (가운데 긴 빨간 부분은 실제로 말을 쉰 곳)</figcaption></figure>
<table>
<tr><th>파일</th><th class="num">파일 길이</th><th class="num">끼운 무음</th><th class="num">고친 뒤</th></tr>
<tr><td>"S매치 되는지 한번 해봐야겠다…" (경기 전)</td><td class="num">8.48초</td><td class="num">132개 (2.64초)</td><td class="num">7.32초</td></tr>
<tr><td>"…게임을 좀 해봐오면…" (경기 중)</td><td class="num">6.40초</td><td class="num">117개</td><td class="num">5.02초</td></tr>
<tr><td>"…홈 워치카라드 런던 키위드" (경기 중)</td><td class="num">4.64초</td><td class="num">69개</td><td class="num">3.54초</td></tr>
<tr><td>"운동을 싫어하면 별로 안 맞네" (경기 중)</td><td class="num">6.50초</td><td class="num">143개</td><td class="num">5.38초</td></tr>
</table>
<h3>원인</h3>
<p>디스코드는 말하는 동안 20ms 마다 패킷을 보낸다. 녹음기는 "앞 패킷이 도착한 뒤 흐른 시간"으로 빈 자리를 무음으로 채웠다. 그런데 게임 중에는 PC 부하로 패킷이 2~3개씩 몰려 도착한다. 녹음기는 몰려 오기 전의 기다림을 쉼으로 보고 무음을 넣었다. 그래서 말 사이사이에 20ms 구멍이 계속 생겼고 소리가 늘어났다. 실제 수신 시간은 약 7.0초인데 파일은 8.5초였다.</p>
<figure><img src="img/wave-compare.png" style="width:82%;margin:0 auto"><figcaption>같은 발화 앞 1.6초 (음량 키움). 위: 저장된 파일 (끊김), 아래: 끼운 무음을 뺀 것</figcaption></figure>
<h3>고친 방법</h3>
<ul>
<li>디스코드가 패킷마다 붙여 보내는 시각(RTP 타임스탬프)으로 패킷 자리를 정한다. 도착이 몰리거나 늦어도 소리가 늘어나지 않는다. 중복 패킷은 버리고, 시각이 튀면 다시 맞춘다.</li>
<li>예전 녹음은 v1.3.7 을 처음 켤 때 한 번 고친다. 앞뒤가 목소리인 1~3개짜리 무음 묶음을 빼고, 정밀 모델로 다시 글자로 바꾼다. 업그레이드 전에 만든 녹음만 고치고, 20개씩 나눠 처리한다. 중간에 꺼져도 다음에 이어서 한다. 다시 인식한 결과가 잡음이면 원래 글을 그대로 둔다.</li>
</ul>
<h3>인식 결과 비교 (같은 Whisper large-v3 로 다시 인식)</h3>
<table>
<tr><th style="width:50%">저장된 파일 (깨짐)</th><th>끼운 무음을 뺀 파일</th></tr>
<tr><td>이제 게임을 좀 해봐봐 스태스트랜 맛있긴 하네</td><td>실제로 게임을 좀 해봐오면서 테스트를 했는데 맛있긴 하네</td></tr>
<tr><td>왜는 리플레이가 귀하다</td><td>이거는 리플레이가 없긴 하다</td></tr>
<tr><td>이거 시험은 별로 안 맞네</td><td>이만큼만 시도하면 별로 안 맞네</td></tr>
</table>
</section>
<section class="page pb">
<h2><span class="num">3</span>말한 사람 "알 수 없음" · 잡음</h2>
<h3>"알 수 없음"</h3>
<p>녹음 기록에는 말한 사람(사금향)이 제대로 저장되어 있었다. 녹음 시작, 경기 끝, Riot ID 저장 때 앱이 사이트에 "유저 목록이 바뀌었음"을 보낸다. 이때 목록을 빈 목록으로 보냈고, 사이트는 그 빈 목록으로 유저 목록을 덮어썼다. 그래서 새로 고침 전까지 모든 발화가 "알 수 없음"으로 나왔다. 이제 실제 목록을 보낸다. 사이트도 빈 목록을 받으면 목록을 다시 받아 온다.</p>
<h3>잡음</h3>
<ul>
<li>보내 주신 잡음 19개를 음성 검출기로 다시 쟀다. 모두 목소리 0초였다. 이런 소리를 Whisper 에 그냥 넣으면 "시청해주셔서 감사합니다", "자막 제공 배달의민족" 같은 문장을 지어낸다. 그래서 판정은 맞았다.</li>
<li>이제 잡음은 사이트에 보이지 않고 ogg 도 지운다. 경기 중 실시간 판정은 경기가 끝난 뒤 정밀 모델로 다시 확인하고 나서 지운다.</li>
<li>로그 예: <code>잡음 발화 0mv9… 숨김 · 음성 파일 삭제 (사금향, 0.6초, 잡음에서 지어낸 문장, 인식 "자막 제공 배달의민족")</code></li>
<li>목소리가 0.15초만 있어도 인식을 돌린다. 예전에는 길이 대비 비율도 봐서, 긴 잡음 속 짧은 한마디가 버려졌다.</li>
<li>Whisper 가 같은 말을 되풀이하는 오류("페이스페이스페이스…")는 한 번으로 줄여 남은 말을 보여 준다. 숫자("1000원")나 붙어 있는 한 글자 반복은 줄이지 않는다.</li>
</ul>
<h3>데스매치 · 선수 이름 (분석 중 찾은 문제)</h3>
<ul>
<li>데스매치는 점수가 킬 수다. 앱은 이 점수를 라운드로 착각해 "R10 · R22 · R63 승리" 같은 가짜 라운드를 만들었다. 경기 상세에서는 344킬이 "라운드 1" 하나에 들어가서 에이스(한 라운드 5킬)가 11개 생겼다. 이제 데스매치, 팀 데스매치, 에스컬레이션에는 라운드와 에이스를 만들지 않는다.</li>
<li>Riot 경기 상세에 선수 이름이 비어 와서 로그에 "주인 계정 자동 연결: #"이 남았다. 이제 이름 서비스로 채우고, 내 이름은 Riot 클라이언트에서 받는다. 이름이 비어 있으면 계정을 연결하지 않는다.</li>
</ul>
</section>
<section class="page pb">
<h2><span class="num">4</span>기록 관리 (경기별 묶음 · zip)</h2>
<p>사이트 상단 <b>기록</b> 탭에서 녹음을 묶음 단위로 보고 관리한다.</p>
<ul>
<li><b>묶는 규칙</b>
<ul>
<li>경기 하나가 묶음 하나다.</li>
<li>경기 밖 대화는 녹음 세션 안에서 경기 사이마다 하나로 묶는다.</li>
<li>다음 경기가 30분 안에 시작하면 <b>경기 전 대화</b>, 지난 경기가 30분 안에 끝났으면 <b>경기 후 대화</b>, 둘 다 아니면 <b>게임 밖 대화</b>다.</li>
<li>보내 주신 데이터로 확인한 결과: 경기 전 대화 7개 → 데스매치 11개 → 경기 후 대화 3개.</li>
</ul></li>
<li><b>기록 보기</b>: 경기는 경기 타임라인으로, 대화 묶음은 그 시간대의 "게임 외 대화"로 이동한다.</li>
<li><b>한 번에 zip 내려받기</b>: 묶음 여러 개를 골라 zip 하나로 받는다. zip 에는 <code>manifest.json</code>, <code>data.json</code>, <code>audio/발화ID.ogg</code>, <code>대화.txt</code>(시각 · 이름 · 내용)가 들어 있다. 한 번에 음성 280MB 까지 받는다.</li>
<li><b>한 번에 지우기</b> (관리자만): 발화, 음성 파일, 경기 기록(킬 · 라운드 · 범인 분석)을 함께 지운다. 진행 중인 경기는 지울 수 없다. 지우기 전에 확인 창에서 "먼저 zip 받기"를 할 수 있다.</li>
<li><b>받아오기</b> (관리자만): 받아 둔 zip 을 그대로 넣으면 기록이 다시 추가된다. 이미 있는 발화는 건너뛴다. 받아온 녹음의 보관 기간(7일)은 받아온 날부터 센다.</li>
</ul>
<div class="callout warn"><b class="t">받아오기 실패 조건 (하나라도 해당하면 아무것도 넣지 않음)</b>
zip 이 아님 · 손상 · 암호 · manifest.json 없음 · 겜녹이 형식(gvr-bundle)이 아님 · 모르는 형식 버전 · data.json 없음 · 발화 · 유저 목록 없음 · 발화 ID 잘못됨 · 중복 · 말한 사람이 유저 목록에 없음 · 시각 잘못됨 · 경기 묶음인데 경기 기록 없음 · 이벤트의 경기 없음 · 음성 파일이 zip 에 없음 · ogg 가 아님 · manifest 의 발화 수와 다름 · 300MB 초과</div>
<figure><img src="img/7-records.jpg"><figcaption>기록 탭: 날짜별 묶음, 묶음마다 기록 보기 · zip · 지우기, 날짜 전체 선택</figcaption></figure>
<div class="two">
<figure><img src="img/8-records-delete.jpg"><figcaption>골라서 한 번에 지우기 확인 창</figcaption></figure>
<figure><img src="img/9-records-import-fail.jpg"><figcaption>필요한 내용이 없는 zip → "받아오기 실패: (이유)"</figcaption></figure>
</div>
</section>
<section class="page pb">
<h2><span class="num">5</span>그 밖의 요청</h2>
<div class="two">
<figure><img src="img/splash.jpg"><figcaption>켜는 중 창 (포터블 exe 는 압축을 푸는 동안 같은 그림 창)</figcaption></figure>
<figure><img src="img/6-app-tts.jpg"><figcaption>디스코드 탭 "말 속도" 0.1~2.0배</figcaption></figure>
</div>
<figure><img src="img/2-context.jpg"><figcaption>발화 우클릭 메뉴 · 플레이어 막대 재생 음량(오른쪽 아래) · 머리글 지금 게임 · 오른쪽 게임 상태</figcaption></figure>
<div class="two">
<figure><img src="img/3-info.jpg"><figcaption>자세한 정보: 원본 ogg 이름 · 게임 PC 경로(복사) · 크기 · 인식 정보 · 원본 다운로드</figcaption></figure>
<figure><img src="img/4-logs.jpg"><figcaption>사이트 로그 (/logs): 게임 PC 연결 · 끊김, 요청 결과, 봇, 화면 오류. 전체 · 경고 이상 · 오류만, 찾기, 내려받기</figcaption></figure>
</div>
<figure><img src="img/5-app-games.jpg"><figcaption>앱 게임 연동 탭 "지금 게임"</figcaption></figure>
<p class="small">사이트 로그에는 게임 PC 연결 · 끊김(이유), 정보(버전 · 서버), 기록 요청(주소 · 결과 · 걸린 시간 · 누가), 응답 없는 요청, 겜녹이 봇 중계, 범인찾기, 브라우저 화면 오류가 남는다. 로그인 code · 검색어 같은 쿼리 값은 남기지 않는다. 문제가 생기면 이 로그와 게임 PC 의 <code>GVR-Data\logs\gvr-날짜.log</code> 를 같이 보내면 된다.</p>
</section>
<section class="page pb s6">
<h2><span class="num">6</span>오류 점검 (전체 코드 검토)</h2>
<style>.s6 table{font-size:8.3pt}.s6 td,.s6 th{padding:3px 6px}</style><p>v1.3.6 · v1.3.7 에서 바뀐 코드 약 3,600줄을 다시 검토했다. 실제 오류 8개와 작은 문제 5개를 찾아 모두 고쳤고, 고친 내용마다 테스트를 넣었다.</p>
<table>
<tr><th style="width:4%">#</th><th style="width:22%">문제</th><th style="width:40%">어떻게 생기나</th><th>고친 것</th></tr>
<tr><td>1</td><td>기록 지우기 관리자 확인 우회</td><td>주소를 <code>/api/%62undles/delete</code> 처럼 %인코딩하면 사이트 서버의 확인을 건너뛰고 게임 PC 가 지웠다</td><td>주소를 풀어서 확인하고, 게임 PC 도 사이트가 붙인 역할로 한 번 더 확인한다. 우회 주소 4가지가 403 인 것을 테스트로 확인했다</td></tr>
<tr><td>2</td><td>큰 zip 을 주고받을 때 연결이 끊김</td><td>조각이 쌓여 확인 신호(pong)가 20초 넘게 밀리면 앱이 사이트 연결을 스스로 끊었다</td><td>무엇이든 받으면 연결이 살아 있는 것으로 본다. 보낼 것이 4MB 넘게 쌓이면 기다린다. 20MB zip 이 오가는 것을 테스트로 확인했다</td></tr>
<tr><td>3</td><td>진행 중인 경기 지우기</td><td>경기가 끝날 때 할 일(정밀 변환 · 경기 상세)이 경기를 못 찾아 멈췄다</td><td>진행 중인 경기는 지울 수 없게 했다 (화면에 "● 진행 중" 표시)</td></tr>
<tr><td>4</td><td>다시 넣을 수 없는 zip</td><td>내보내기에는 한도가 없고 받아오기는 300MB 까지라, "먼저 zip 받기" 뒤에 지우면 되살리지 못할 수 있었다</td><td>음성이 280MB 를 넘으면 나눠 받으라고 안내한다</td></tr>
<tr><td>5</td><td>예전 녹음 고치기가 결과를 나쁘게 덮음</td><td>정밀 모델 결과를 실시간 모델 결과로 덮었다. 잡음으로 나오면 파일을 지웠다. 켤 때 한꺼번에 처리했다</td><td>정밀 모델로만 다시 변환하고, 잡음이면 원래 결과를 둔다. 20개씩 처리하고, 중간에 꺼져도 이어서 한다</td></tr>
<tr><td>6</td><td>타임라인 순서</td><td>최신순 목록에서 오래된 발화가 고쳐지면 맨 아래에 붙었다. "더 보기"를 누르면 같은 발화가 두 번 나왔다</td><td>더 불러올 페이지가 남아 있으면 넣지 않는다</td></tr>
<tr><td>7</td><td>반복 줄이기가 숫자를 망가뜨림</td><td>"1000원 줘 줘 줘" → "10원 줘", "www" → "w"</td><td>숫자와 붙은 한 글자 반복은 그대로 둔다</td></tr>
<tr><td>8</td><td>TTS 속도 파일이 반쪽으로 남음</td><td>변환 중 엔진이 죽으면 반쪽 파일이 계속 안내 음성으로 쓰였다</td><td>다 만든 뒤에만 파일 이름을 바꾼다</td></tr>
<tr><td>+</td><td>작은 문제 5개</td><td colspan="2">브라우저 오류 로그에 검색어가 남던 것 · 경기 끝 직후 늦게 끝난 실시간 변환의 잡음 파일을 정밀 확인 전에 지우던 것 · 많이 골랐을 때 내려받기 주소가 너무 길던 것 · zip 풀기 메모리 한도(600MB) · 경기 · 기록 목록의 날짜가 "10월"로만 묶이던 것</td></tr>
</table>
<h3>확인</h3>
<table>
<tr><th>항목</th><th>결과</th></tr>
<tr><td>앱 테스트</td><td>53개 통과 (녹음기 RTP · 예전 녹음 고치기 · 유저 목록 · 잡음 · TTS 속도 · 지금 게임 · 데스매치 · 기록 묶음 5개 · 실제 음성 인식 엔진 E2E)</td></tr>
<tr><td>사이트 서버 테스트</td><td>16개 통과 (사이트 로그 · 큰 zip 중계 · 관리자 확인 우회 차단 포함)</td></tr>
<tr><td>음성 인식 워커 테스트</td><td>42개 통과 (잡음 규칙 · 반복 줄이기 · TTS 속도)</td></tr>
<tr><td>화면</td><td>사이트 · 앱 화면을 띄워 확인, 화면 오류 없음</td></tr>
<tr><td>Windows 빌드 검사</td><td>7개 통과 (워커 테스트 · STT · 워커 exe · 앱 빌드 · 앱 실행)</td></tr>
<tr><td>사용자 데이터 사본</td><td>예전 녹음 43개 고치기 (끼운 무음 489개 제거), 기록 묶음 3개 → zip 1.0MB</td></tr>
</table>
<div class="callout info"><b class="t">아직 실제로 확인하지 못한 것</b>새 녹음 방식(RTP 기준)은 실제 디스코드 통화가 있는 Windows 게임 PC 에서 아직 돌려 보지 못했다. 테스트는 사용자 파일과 같은 도착 모양을 흉내 내서 했다. 한 판 해 보고 목소리가 깨끗한지 확인해 주세요.</div>
</section>
</body></html>