From 31153377063178c27751a249c352df3719aa33be Mon Sep 17 00:00:00 2001 From: EJClaw Date: Fri, 16 Oct 2026 20:30:33 +0900 Subject: [PATCH] =?UTF-8?q?v1.4.0:=20=EB=B0=9C=ED=99=94=20=EC=9A=B0?= =?UTF-8?q?=ED=81=B4=EB=A6=AD=20=EC=82=AD=EC=A0=9C(=EC=9E=A1=EC=9D=8C?= =?UTF-8?q?=EC=9D=B4=EB=9D=BC=20=EC=82=AD=EC=A0=9C=20=C2=B7=20=EA=B7=B8?= =?UTF-8?q?=EB=83=A5=20=EC=82=AD=EC=A0=9C)=20=C2=B7=20=EC=9E=A1=EC=9D=8C?= =?UTF-8?q?=20=EB=AC=B8=EC=9E=A5=20=EB=B0=B0=EC=9A=B0=EA=B8=B0=20=C2=B7=20?= =?UTF-8?q?=EC=83=88=20=EB=B0=9C=ED=99=94/=EC=9E=AC=EC=83=9D=20=EC=8B=9C?= =?UTF-8?q?=EC=9E=91=20=EC=95=8C=EB=A6=BC=20=EA=B8=B0=EB=B3=B8=20=EB=81=84?= =?UTF-8?q?=EA=B8=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- README.md | 8 +- app/package-lock.json | 4 +- app/package.json | 2 +- app/src/core/api/server.ts | 55 ++++++- app/src/core/db/db.ts | 77 +++++++++ app/src/core/db/schema.sql | 9 ++ app/src/core/db/schema.ts | 2 +- app/src/core/stt/pipeline.ts | 9 +- app/test/e2e-stt.test.ts | 18 +++ app/test/utterance-delete.test.ts | 191 +++++++++++++++++++++++ docs/dev/ARCHITECTURE.md | 4 + docs/dev/test-results.md | 8 + packages/shared/src/protocol.ts | 13 +- site/web/mock/server.mjs | 32 ++++ site/web/src/components/UttMenu.tsx | 132 +++++++++++++++- site/web/src/components/UtteranceRow.tsx | 6 +- site/web/src/lib/api.ts | 6 + site/web/src/pages/DictionaryPage.tsx | 35 +++++ site/web/src/pages/TimelinePage.tsx | 3 + site/web/src/store/settings.ts | 19 ++- site/web/src/styles.css | 50 ++++++ 21 files changed, 670 insertions(+), 13 deletions(-) create mode 100644 app/test/utterance-delete.test.ts diff --git a/README.md b/README.md index 453108d..2a8398e 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ - 설계·계획: [`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.3.9](https://git.tkrmagid.kr/tkrmagid/game_voice_recorder/releases/tag/v1.3.9) (`GameVoiceRecorder-1.3.9-win-x64.zip` 권장, 단일 파일 `GameVoiceRecorder-1.3.9-portable.exe`) · 바뀐 점 보고서 [`docs/gemnoki-v1.3.7-report.pdf`](docs/gemnoki-v1.3.7-report.pdf) · 처음 버전 [v1.0.0](https://git.tkrmagid.kr/tkrmagid/game_voice_recorder/releases/tag/v1.0.0) +- Windows 실행 파일: Gitea 릴리스 [v1.4.0](https://git.tkrmagid.kr/tkrmagid/game_voice_recorder/releases/tag/v1.4.0) (`GameVoiceRecorder-1.4.0-win-x64.zip` 권장, 단일 파일 `GameVoiceRecorder-1.4.0-portable.exe`) · 바뀐 점 보고서 [`docs/gemnoki-v1.3.7-report.pdf`](docs/gemnoki-v1.3.7-report.pdf) · 처음 버전 [v1.0.0](https://git.tkrmagid.kr/tkrmagid/game_voice_recorder/releases/tag/v1.0.0) ## 로그인 · 관리자 (v1.2.0~) @@ -19,6 +19,12 @@ - 앱은 시작할 때와 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`. +## v1.4.0 바뀐 점 + +- 사이트 발화 우클릭 → **삭제…**: 확인 창에서 "잡음이라 삭제" 또는 "그냥 삭제". 관리자나 말한 사람만 지울 수 있고, 글 · 음성 파일 · 교정 학습 데이터를 게임 PC 에서 지운다 (`POST /api/utterances/:id/delete`) +- "잡음이라 삭제"는 인식된 문장을 `noise_phrases` 에 배운다. 다음에 같은 문장(띄어쓰기 · 문장부호 무시, 8글자 이상이면 15% 안 글자 차이까지)이 인식되면 잡음(`noise_reason='learned'`)으로 숨기고 파일을 지운다. 배운 문장은 단어사전 화면에서 보고 지운다 (`GET/DELETE /api/noise-phrases`) +- 사이트 효과음: "새 발화 알림" · "재생 시작"을 기본으로 끈다 (예전에 저장한 설정도 한 번 꺼 줌, 그 뒤 다시 켜면 그대로) + ## v1.3.9 바뀐 점 - 기록 zip 받아오기: 표시 이름에 `..` 이 있으면(예: `하늘..별`) 그 이름이 들어간 녹음 파일을 "음성 파일 이름이 잘못되었습니다"로 거절해, 내보낸 zip 을 다시 넣지 못했다. zip 안 이름은 꺼낼 때 찾는 열쇠로만 쓰고 이 PC 에 쓸 경로는 발화 ID 로 만들므로, 폴더 구분자(`/`, `\`)만 막는다 diff --git a/app/package-lock.json b/app/package-lock.json index f877506..a8b9c68 100644 --- a/app/package-lock.json +++ b/app/package-lock.json @@ -1,12 +1,12 @@ { "name": "gvr-app", - "version": "1.3.9", + "version": "1.4.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "gvr-app", - "version": "1.3.9", + "version": "1.4.0", "license": "UNLICENSED", "dependencies": { "@discordjs/voice": "^0.19.2", diff --git a/app/package.json b/app/package.json index 5e0b1e1..1a3f4d2 100644 --- a/app/package.json +++ b/app/package.json @@ -1,7 +1,7 @@ { "name": "gvr-app", "productName": "겜녹이", - "version": "1.3.9", + "version": "1.4.0", "description": "겜녹이 (Game Voice Recorder) - 게임 연동 디스코드 음성 기록", "private": true, "main": "dist/main.cjs", diff --git a/app/src/core/api/server.ts b/app/src/core/api/server.ts index 700d673..932541e 100644 --- a/app/src/core/api/server.ts +++ b/app/src/core/api/server.ts @@ -3,13 +3,26 @@ import fs from 'node:fs'; import path from 'node:path'; import type { CulpritAnalysis, CulpritResult, MatchDetail, MatchPlayer, Overview, User, UserProfile, UtteranceInfo, Word } from '@gvr/shared'; import type { Culprit } from '../culprit.js'; -import type { Store, UserRow } from '../db/db.js'; +import { normalizePhrase, type Store, type UserRow } from '../db/db.js'; import type { Dictionary } from '../dict/dictionary.js'; import type { GameManager } from '../games/manager.js'; import type { Settings } from '../settings.js'; import { safeJson, type Timeline, type TimelineQuery } from '../timeline.js'; import type { Bus } from '../util/events.js'; import { BundleError, type Bundles } from '../bundles.js'; +import { logger } from '../util/log.js'; + +const log = logger('api'); + +/** 파일 지우기. 음성 인식 · 다른 프로그램이 열고 있으면(Windows) 5초마다 다시 (1분까지) */ +export function removeFile(f: string, tries = 12): void { + try { + fs.rmSync(f, { force: true }); + } catch (e: any) { + if (tries <= 1) return void log.warn(`파일 삭제 실패 ${path.basename(f)}: ${e?.code ?? e?.message}`); + setTimeout(() => removeFile(f, tries - 1), 5000).unref?.(); + } +} export interface ApiDeps { store: Store; @@ -171,6 +184,17 @@ export async function buildApi(d: ApiDeps): Promise { reply.code(403).send({ error: 'forbidden', message: '기록 지우기 · 받아오기는 관리자만 할 수 있습니다' }); return false; }; + /** 발화 지우기: 이 PC 안에서 부른 것 · 관리자 · 말한 사람 본인 */ + const canDelete = (req: any, speakerId: string): boolean => { + const raw = req.headers['x-gvr-user']; + if (!raw) return true; + if (req.headers['x-gvr-role'] === 'admin') return true; + try { + return JSON.parse(decodeURIComponent(String(raw)))?.id === speakerId; + } catch { + return false; + } + }; const exportZip = (reply: any, ids: string[]) => { const { zip, fileName } = d.bundles!.export(ids); return reply.header('content-type', 'application/zip').header('content-disposition', `attachment; filename="${fileName}"`).header('cache-control', 'no-store').send(zip); @@ -321,6 +345,35 @@ export async function buildApi(d: ApiDeps): Promise { return item; }); + // 발화 지우기 (v1.4.0): 사이트 우클릭 메뉴. 관리자 또는 말한 사람만. + // noise=true 면 "잡음이라 삭제": 인식된 문장을 배워서, 같은 문장이 다시 나오면 잡음으로 본다 + app.post<{ Params: { id: string }; Body: { noise?: boolean } }>('/api/utterances/:id/delete', async (req, reply) => { + const u = store.getUtterance(req.params.id); + if (!u) return reply.code(404).send({ error: 'not_found', message: '이미 지워진 발화입니다' }); + if (!canDelete(req, u.user_id)) return reply.code(403).send({ error: 'forbidden', message: '발화는 관리자나 말한 사람만 지울 수 있습니다' }); + let learned: string | null = null; + if (req.body?.noise) { + const sample = (u.raw_text ?? u.text ?? '').trim(); + const phrase = normalizePhrase(sample); + if (phrase) { + store.addNoisePhrase(phrase, sample.slice(0, 200)); + learned = sample.slice(0, 200); + } + } + const files = store.deleteUtterance(u.id); + for (const f of files) removeFile(f); + timeline.invalidate(); + d.bus.live({ type: 'utterance.deleted', data: { id: u.id, noise: !!req.body?.noise } }); + return { ok: true, learned }; + }); + app.get('/api/noise-phrases', async () => ({ + phrases: store.listNoisePhrases().map((r) => ({ id: r.id, text: r.sample, hits: r.hits, createdAt: r.created_at })), + })); + app.delete<{ Params: { id: string } }>('/api/noise-phrases/:id', async (req, reply) => { + if (!store.deleteNoisePhrase(Number(req.params.id))) return reply.code(404).send({ error: 'not_found' }); + return { ok: true }; + }); + // 사이트에서 단어·교정 규칙 추가/삭제 (보고서 5-4: 사이트·설정에서 직접 추가·수정) app.post<{ Body: { word?: string; from?: string; to?: string } }>('/api/dictionary', async (req, reply) => { const b = req.body || {}; diff --git a/app/src/core/db/db.ts b/app/src/core/db/db.ts index f9f02f9..e0f6a55 100644 --- a/app/src/core/db/db.ts +++ b/app/src/core/db/db.ts @@ -87,6 +87,46 @@ export interface DictRow { created_at: number; } +export interface NoisePhraseRow { + id: number; + phrase: string; + sample: string; + hits: number; + created_at: number; +} + +/** 잡음 문장 비교용: 띄어쓰기 · 문장부호 · 기호를 빼고 소문자로 (워커 noise.normalize 와 같은 규칙) */ +export function normalizePhrase(text: string | null | undefined): string { + return String(text ?? '') + .replace(/[^\p{L}\p{N}\p{M}]+/gu, '') + .toLowerCase(); +} + +/** + * 거의 같은 문장인가: 둘 다 8글자 이상이고 글자 차이(편집 거리)가 긴 쪽의 15% 이하. + * Whisper 는 같은 잡음에서도 한두 글자 다르게 지어낸다 ("…사용하였습니다" / "…사용했습니다"). 짧은 말은 통째로 같을 때만 + */ +export function similarPhrase(a: string, b: string): boolean { + const A = [...a]; + const B = [...b]; + const max = Math.max(A.length, B.length); + if (Math.min(A.length, B.length) < 8) return false; + const limit = Math.floor(max * 0.15); + if (Math.abs(A.length - B.length) > limit) return false; + let prev = Array.from({ length: B.length + 1 }, (_, j) => j); + for (let i = 1; i <= A.length; i++) { + const cur = [i]; + let rowMin = i; + for (let j = 1; j <= B.length; j++) { + cur[j] = Math.min(prev[j] + 1, cur[j - 1] + 1, prev[j - 1] + (A[i - 1] === B[j - 1] ? 0 : 1)); + rowMin = Math.min(rowMin, cur[j]); + } + if (rowMin > limit) return false; + prev = cur; + } + return prev[B.length] <= limit; +} + export class Store { readonly db: Database.Database; @@ -482,6 +522,43 @@ export class Store { this.db.prepare('DELETE FROM training_samples').run(); } + // ---------------------------------------------------------------- 발화 지우기 · 잡음으로 배운 문장 (v1.4.0) + /** 발화 하나를 지운다 (교정 학습 데이터 포함). 지울 파일 경로를 돌려준다 */ + deleteUtterance(id: string): string[] { + const files: string[] = []; + this.db.transaction(() => { + const u = this.getUtterance(id); + if (!u) return; + if (u.audio_path && !u.audio_deleted) files.push(u.audio_path); + for (const t of this.db.prepare('SELECT audio_path FROM training_samples WHERE utterance_id=?').all(id) as { audio_path: string }[]) files.push(t.audio_path); + this.db.prepare('DELETE FROM training_samples WHERE utterance_id=?').run(id); + this.db.prepare('DELETE FROM utterance_imports WHERE id=?').run(id); + this.db.prepare('DELETE FROM utterances WHERE id=?').run(id); + })(); + return files; + } + /** 잡음 문장 배우기. phrase 는 normalizePhrase 를 거친 값 */ + addNoisePhrase(phrase: string, sample: string): void { + this.db + .prepare('INSERT INTO noise_phrases(phrase,sample,created_at) VALUES(?,?,?) ON CONFLICT(phrase) DO UPDATE SET sample=excluded.sample') + .run(phrase, sample, Date.now()); + } + listNoisePhrases(): NoisePhraseRow[] { + return this.db.prepare('SELECT * FROM noise_phrases ORDER BY created_at DESC').all() as NoisePhraseRow[]; + } + deleteNoisePhrase(id: number): boolean { + return this.db.prepare('DELETE FROM noise_phrases WHERE id=?').run(id).changes > 0; + } + /** 배운 잡음 문장과 같거나 거의 같으면 true (맞힌 횟수를 센다). phrase 는 normalizePhrase 를 거친 값 */ + hitNoisePhrase(phrase: string): boolean { + if (!phrase) return false; + const rows = this.db.prepare('SELECT id, phrase FROM noise_phrases').all() as { id: number; phrase: string }[]; + const hit = rows.find((r) => r.phrase === phrase) ?? rows.find((r) => similarPhrase(r.phrase, phrase)); + if (!hit) return false; + this.db.prepare('UPDATE noise_phrases SET hits=hits+1 WHERE id=?').run(hit.id); + return true; + } + // ---------------------------------------------------------------- stats counts(): { utterances: number; matches: number } { const u = (this.db.prepare('SELECT count(*) n FROM utterances WHERE noise=0 OR corrected=1').get() as any).n; diff --git a/app/src/core/db/schema.sql b/app/src/core/db/schema.sql index bb279cb..c667c95 100644 --- a/app/src/core/db/schema.sql +++ b/app/src/core/db/schema.sql @@ -142,3 +142,12 @@ CREATE TABLE IF NOT EXISTS utterance_imports ( id TEXT PRIMARY KEY, imported_at INTEGER NOT NULL ); + +-- 사이트에서 "잡음이라 삭제"한 문장 (v1.4.0). 같은 문장(띄어쓰기 · 문장부호 무시, 긴 문장은 거의 같은 것까지)이 다시 인식되면 잡음으로 본다 +CREATE TABLE IF NOT EXISTS noise_phrases ( + id INTEGER PRIMARY KEY AUTOINCREMENT, + phrase TEXT NOT NULL UNIQUE, + sample TEXT NOT NULL, + hits INTEGER NOT NULL DEFAULT 0, + created_at INTEGER NOT NULL +); diff --git a/app/src/core/db/schema.ts b/app/src/core/db/schema.ts index 1d5acde..568c19d 100644 --- a/app/src/core/db/schema.ts +++ b/app/src/core/db/schema.ts @@ -1,2 +1,2 @@ // 자동 생성: schema.sql 사본 (npm run build 가 다시 만든다) -export const SCHEMA_SQL = "PRAGMA journal_mode = WAL;\nPRAGMA foreign_keys = ON;\n\nCREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT);\n\nCREATE TABLE IF NOT EXISTS users (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n color TEXT NOT NULL,\n avatar TEXT,\n excluded INTEGER NOT NULL DEFAULT 0,\n gain_lufs REAL,\n gain_n INTEGER NOT NULL DEFAULT 0,\n updated_at INTEGER NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS game_accounts (\n user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n puuid TEXT NOT NULL,\n riot_id TEXT NOT NULL,\n PRIMARY KEY (user_id, puuid)\n);\nCREATE INDEX IF NOT EXISTS game_accounts_puuid ON game_accounts(puuid);\n\nCREATE TABLE IF NOT EXISTS sessions (\n id TEXT PRIMARY KEY,\n guild_id TEXT NOT NULL,\n channel_id TEXT NOT NULL,\n channel_name TEXT,\n started_at INTEGER NOT NULL,\n ended_at INTEGER\n);\n\nCREATE TABLE IF NOT EXISTS utterances (\n id TEXT PRIMARY KEY,\n session_id TEXT,\n user_id TEXT NOT NULL,\n started_at INTEGER NOT NULL,\n ended_at INTEGER NOT NULL,\n audio_path TEXT,\n audio_deleted INTEGER NOT NULL DEFAULT 0,\n text TEXT,\n raw_text TEXT,\n words TEXT NOT NULL DEFAULT '[]',\n noise INTEGER NOT NULL DEFAULT 0,\n noise_reason TEXT,\n confidence REAL,\n lufs REAL,\n gain_db REAL NOT NULL DEFAULT 0,\n model TEXT,\n status TEXT NOT NULL DEFAULT 'pending',\n match_id TEXT,\n corrected INTEGER NOT NULL DEFAULT 0,\n attempts INTEGER NOT NULL DEFAULT 0,\n created_at INTEGER NOT NULL\n);\nCREATE INDEX IF NOT EXISTS utterances_started ON utterances(started_at);\nCREATE INDEX IF NOT EXISTS utterances_user ON utterances(user_id, started_at);\nCREATE INDEX IF NOT EXISTS utterances_match ON utterances(match_id, started_at);\nCREATE INDEX IF NOT EXISTS utterances_status ON utterances(status);\n\nCREATE VIRTUAL TABLE IF NOT EXISTS utterances_fts USING fts5(text, content='utterances', content_rowid='rowid', tokenize='trigram');\nCREATE TRIGGER IF NOT EXISTS utterances_ai AFTER INSERT ON utterances BEGIN\n INSERT INTO utterances_fts(rowid, text) VALUES (new.rowid, coalesce(new.text, ''));\nEND;\nCREATE TRIGGER IF NOT EXISTS utterances_ad AFTER DELETE ON utterances BEGIN\n INSERT INTO utterances_fts(utterances_fts, rowid, text) VALUES ('delete', old.rowid, coalesce(old.text, ''));\nEND;\nCREATE TRIGGER IF NOT EXISTS utterances_au AFTER UPDATE OF text ON utterances BEGIN\n INSERT INTO utterances_fts(utterances_fts, rowid, text) VALUES ('delete', old.rowid, coalesce(old.text, ''));\n INSERT INTO utterances_fts(rowid, text) VALUES (new.rowid, coalesce(new.text, ''));\nEND;\n\nCREATE TABLE IF NOT EXISTS matches (\n id TEXT PRIMARY KEY,\n game TEXT NOT NULL,\n started_at INTEGER NOT NULL,\n ended_at INTEGER,\n map TEXT,\n mode TEXT,\n queue TEXT,\n result TEXT,\n detail TEXT,\n status TEXT NOT NULL DEFAULT 'live',\n clock_offset INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS matches_started ON matches(started_at);\n\nCREATE TABLE IF NOT EXISTS rounds (\n match_id TEXT NOT NULL REFERENCES matches(id) ON DELETE CASCADE,\n num INTEGER NOT NULL,\n started_at INTEGER NOT NULL,\n combat_at INTEGER NOT NULL,\n ended_at INTEGER NOT NULL,\n win INTEGER,\n result TEXT,\n ally_score INTEGER,\n enemy_score INTEGER,\n economy TEXT,\n PRIMARY KEY (match_id, num)\n);\n\nCREATE TABLE IF NOT EXISTS game_events (\n id TEXT PRIMARY KEY,\n match_id TEXT NOT NULL,\n game TEXT NOT NULL,\n type TEXT NOT NULL,\n ts INTEGER NOT NULL,\n game_time_ms INTEGER,\n round INTEGER,\n actor_puuid TEXT,\n target_puuid TEXT,\n data TEXT NOT NULL DEFAULT '{}'\n);\nCREATE INDEX IF NOT EXISTS game_events_ts ON game_events(ts);\nCREATE INDEX IF NOT EXISTS game_events_match ON game_events(match_id, ts);\n\nCREATE TABLE IF NOT EXISTS dictionary (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n word TEXT NOT NULL,\n pack TEXT NOT NULL,\n kind TEXT NOT NULL,\n from_text TEXT NOT NULL DEFAULT '',\n source TEXT NOT NULL,\n enabled INTEGER NOT NULL DEFAULT 1,\n hits INTEGER NOT NULL DEFAULT 0,\n created_at INTEGER NOT NULL,\n UNIQUE (kind, word, from_text, pack)\n);\n\nCREATE TABLE IF NOT EXISTS training_samples (\n id TEXT PRIMARY KEY,\n utterance_id TEXT,\n text TEXT NOT NULL,\n audio_path TEXT NOT NULL,\n used INTEGER NOT NULL DEFAULT 0,\n created_at INTEGER NOT NULL\n);\n\n-- 받아오기(zip)로 넣은 발화: 보관 기간은 녹음 날짜가 아니라 받아온 날부터 센다\nCREATE TABLE IF NOT EXISTS utterance_imports (\n id TEXT PRIMARY KEY,\n imported_at INTEGER NOT NULL\n);\n"; +export const SCHEMA_SQL = "PRAGMA journal_mode = WAL;\nPRAGMA foreign_keys = ON;\n\nCREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT);\n\nCREATE TABLE IF NOT EXISTS users (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n color TEXT NOT NULL,\n avatar TEXT,\n excluded INTEGER NOT NULL DEFAULT 0,\n gain_lufs REAL,\n gain_n INTEGER NOT NULL DEFAULT 0,\n updated_at INTEGER NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS game_accounts (\n user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n puuid TEXT NOT NULL,\n riot_id TEXT NOT NULL,\n PRIMARY KEY (user_id, puuid)\n);\nCREATE INDEX IF NOT EXISTS game_accounts_puuid ON game_accounts(puuid);\n\nCREATE TABLE IF NOT EXISTS sessions (\n id TEXT PRIMARY KEY,\n guild_id TEXT NOT NULL,\n channel_id TEXT NOT NULL,\n channel_name TEXT,\n started_at INTEGER NOT NULL,\n ended_at INTEGER\n);\n\nCREATE TABLE IF NOT EXISTS utterances (\n id TEXT PRIMARY KEY,\n session_id TEXT,\n user_id TEXT NOT NULL,\n started_at INTEGER NOT NULL,\n ended_at INTEGER NOT NULL,\n audio_path TEXT,\n audio_deleted INTEGER NOT NULL DEFAULT 0,\n text TEXT,\n raw_text TEXT,\n words TEXT NOT NULL DEFAULT '[]',\n noise INTEGER NOT NULL DEFAULT 0,\n noise_reason TEXT,\n confidence REAL,\n lufs REAL,\n gain_db REAL NOT NULL DEFAULT 0,\n model TEXT,\n status TEXT NOT NULL DEFAULT 'pending',\n match_id TEXT,\n corrected INTEGER NOT NULL DEFAULT 0,\n attempts INTEGER NOT NULL DEFAULT 0,\n created_at INTEGER NOT NULL\n);\nCREATE INDEX IF NOT EXISTS utterances_started ON utterances(started_at);\nCREATE INDEX IF NOT EXISTS utterances_user ON utterances(user_id, started_at);\nCREATE INDEX IF NOT EXISTS utterances_match ON utterances(match_id, started_at);\nCREATE INDEX IF NOT EXISTS utterances_status ON utterances(status);\n\nCREATE VIRTUAL TABLE IF NOT EXISTS utterances_fts USING fts5(text, content='utterances', content_rowid='rowid', tokenize='trigram');\nCREATE TRIGGER IF NOT EXISTS utterances_ai AFTER INSERT ON utterances BEGIN\n INSERT INTO utterances_fts(rowid, text) VALUES (new.rowid, coalesce(new.text, ''));\nEND;\nCREATE TRIGGER IF NOT EXISTS utterances_ad AFTER DELETE ON utterances BEGIN\n INSERT INTO utterances_fts(utterances_fts, rowid, text) VALUES ('delete', old.rowid, coalesce(old.text, ''));\nEND;\nCREATE TRIGGER IF NOT EXISTS utterances_au AFTER UPDATE OF text ON utterances BEGIN\n INSERT INTO utterances_fts(utterances_fts, rowid, text) VALUES ('delete', old.rowid, coalesce(old.text, ''));\n INSERT INTO utterances_fts(rowid, text) VALUES (new.rowid, coalesce(new.text, ''));\nEND;\n\nCREATE TABLE IF NOT EXISTS matches (\n id TEXT PRIMARY KEY,\n game TEXT NOT NULL,\n started_at INTEGER NOT NULL,\n ended_at INTEGER,\n map TEXT,\n mode TEXT,\n queue TEXT,\n result TEXT,\n detail TEXT,\n status TEXT NOT NULL DEFAULT 'live',\n clock_offset INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS matches_started ON matches(started_at);\n\nCREATE TABLE IF NOT EXISTS rounds (\n match_id TEXT NOT NULL REFERENCES matches(id) ON DELETE CASCADE,\n num INTEGER NOT NULL,\n started_at INTEGER NOT NULL,\n combat_at INTEGER NOT NULL,\n ended_at INTEGER NOT NULL,\n win INTEGER,\n result TEXT,\n ally_score INTEGER,\n enemy_score INTEGER,\n economy TEXT,\n PRIMARY KEY (match_id, num)\n);\n\nCREATE TABLE IF NOT EXISTS game_events (\n id TEXT PRIMARY KEY,\n match_id TEXT NOT NULL,\n game TEXT NOT NULL,\n type TEXT NOT NULL,\n ts INTEGER NOT NULL,\n game_time_ms INTEGER,\n round INTEGER,\n actor_puuid TEXT,\n target_puuid TEXT,\n data TEXT NOT NULL DEFAULT '{}'\n);\nCREATE INDEX IF NOT EXISTS game_events_ts ON game_events(ts);\nCREATE INDEX IF NOT EXISTS game_events_match ON game_events(match_id, ts);\n\nCREATE TABLE IF NOT EXISTS dictionary (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n word TEXT NOT NULL,\n pack TEXT NOT NULL,\n kind TEXT NOT NULL,\n from_text TEXT NOT NULL DEFAULT '',\n source TEXT NOT NULL,\n enabled INTEGER NOT NULL DEFAULT 1,\n hits INTEGER NOT NULL DEFAULT 0,\n created_at INTEGER NOT NULL,\n UNIQUE (kind, word, from_text, pack)\n);\n\nCREATE TABLE IF NOT EXISTS training_samples (\n id TEXT PRIMARY KEY,\n utterance_id TEXT,\n text TEXT NOT NULL,\n audio_path TEXT NOT NULL,\n used INTEGER NOT NULL DEFAULT 0,\n created_at INTEGER NOT NULL\n);\n\n-- 받아오기(zip)로 넣은 발화: 보관 기간은 녹음 날짜가 아니라 받아온 날부터 센다\nCREATE TABLE IF NOT EXISTS utterance_imports (\n id TEXT PRIMARY KEY,\n imported_at INTEGER NOT NULL\n);\n\n-- 사이트에서 \"잡음이라 삭제\"한 문장 (v1.4.0). 같은 문장(띄어쓰기 · 문장부호 무시, 긴 문장은 거의 같은 것까지)이 다시 인식되면 잡음으로 본다\nCREATE TABLE IF NOT EXISTS noise_phrases (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n phrase TEXT NOT NULL UNIQUE,\n sample TEXT NOT NULL,\n hits INTEGER NOT NULL DEFAULT 0,\n created_at INTEGER NOT NULL\n);\n"; diff --git a/app/src/core/stt/pipeline.ts b/app/src/core/stt/pipeline.ts index 8c70d5e..930a5f1 100644 --- a/app/src/core/stt/pipeline.ts +++ b/app/src/core/stt/pipeline.ts @@ -1,5 +1,5 @@ import fs from 'node:fs'; -import type { Store, UtteranceRow } from '../db/db.js'; +import { normalizePhrase, type Store, type UtteranceRow } from '../db/db.js'; import type { Dictionary, DictContext } from '../dict/dictionary.js'; import type { Settings } from '../settings.js'; import type { Timeline } from '../timeline.js'; @@ -15,6 +15,7 @@ const NOISE_REASON: Record = { no_speech: '말소리 아님', hallucination: '잡음에서 지어낸 문장', repetition: '같은 말만 반복', + learned: '잡음으로 배운 문장', }; type Slot = 'realtime' | 'precise'; @@ -291,6 +292,12 @@ export class SttPipeline { } else this.enqueue(u.id, job.slot, job.prio + 2); return; } + // 변환하는 동안 사이트에서 지운 발화: 결과를 버린다 + if (!this.store.getUtterance(u.id)) return; + // 사이트에서 "잡음이라 삭제"한 문장과 같으면 잡음으로 (v1.4.0) + if (!r.noise && this.store.hitNoisePhrase(normalizePhrase(r.raw_text ?? r.text))) { + r = { ...r, noise: true, noise_reason: 'learned', text: null, words: [] }; + } if (job.repair && r.noise) { log.info(`예전 녹음 다시 변환: ${u.id} 는 잡음으로 나와 이전 결과를 그대로 둠`); return; diff --git a/app/test/e2e-stt.test.ts b/app/test/e2e-stt.test.ts index b1888d7..c9f8937 100644 --- a/app/test/e2e-stt.test.ts +++ b/app/test/e2e-stt.test.ts @@ -113,6 +113,24 @@ test('E2E: 발화 → STT 워커 → DB → 실시간 이벤트 → 기록 API', assert.equal(imp.added.utterances, 2, '잡음(keys)은 내보내지 않는다'); assert.equal((await core.api.inject({ method: 'GET', url: '/api/timeline' })).json().items.length, 2); assert.ok(live.some((e) => e.type === 'records.changed')); + // 우클릭 → 삭제 → "잡음이라 삭제" (v1.4.0): 인식된 문장을 배우고, 같은 녹음이 다시 들어오면 잡음으로 숨긴다 + const heard = core.store.getUtterance('speech')!.raw_text!; + const nd = await core.api.inject({ method: 'POST', url: '/api/utterances/speech/delete', headers: { 'x-gvr-user': encodeURIComponent(JSON.stringify({ id: 'u1', name: '하늘', avatar: null })), 'x-gvr-role': 'member' }, payload: { noise: true } }); + assert.deepEqual(nd.json(), { ok: true, learned: heard }); + assert.equal(core.store.getUtterance('speech'), undefined); + const again = path.join(core.paths().audio, 'test', 'again.ogg'); + fs.copyFileSync(path.join(fx, 'speech_ko.ogg'), again); + core.store.insertUtterance({ id: 'again', session_id: null, user_id: 'u1', started_at: Date.now(), ended_at: Date.now() + 3000, audio_path: again, match_id: null }); + core.stt.enqueue('again', 'realtime'); + await wait(() => core.store.getUtterance('again')!.status !== 'pending', 60000, 'transcribe again'); + const ag = core.store.getUtterance('again')!; + console.log('again →', ag.noise, ag.noise_reason, '| raw:', ag.raw_text); + assert.equal(ag.noise, 1); + assert.equal(ag.noise_reason, 'learned'); + assert.equal(ag.audio_deleted, 1); + assert.ok(!fs.existsSync(again)); + assert.equal(core.store.listNoisePhrases()[0].hits, 1); + assert.ok(!(await core.api.inject({ method: 'GET', url: '/api/timeline' })).json().items.some((i: any) => i.id === 'again')); } finally { await core.stop(); } diff --git a/app/test/utterance-delete.test.ts b/app/test/utterance-delete.test.ts new file mode 100644 index 0000000..71f49d7 --- /dev/null +++ b/app/test/utterance-delete.test.ts @@ -0,0 +1,191 @@ +import { test } from 'node:test'; +import assert from 'node:assert/strict'; +import { EventEmitter } from 'node:events'; +import fs from 'node:fs'; +import os from 'node:os'; +import path from 'node:path'; +import { Store, normalizePhrase, similarPhrase } from '../src/core/db/db.ts'; +import { buildApi } from '../src/core/api/server.ts'; +import { Timeline } from '../src/core/timeline.ts'; +import { Bus } from '../src/core/util/events.ts'; +import { SttPipeline } from '../src/core/stt/pipeline.ts'; + +const tmp = () => fs.mkdtempSync(path.join(process.env.TMPDIR || os.tmpdir(), 'gvr-del-')); +const as = (id: string, role: 'admin' | 'member' = 'member') => ({ 'x-gvr-user': encodeURIComponent(JSON.stringify({ id, name: id, avatar: null })), 'x-gvr-role': role }); + +function setup() { + const dir = tmp(); + const store = new Store(path.join(dir, 'db.sqlite')); + const timeline = new Timeline(store); + const bus = new Bus(); + const live: any[] = []; + bus.on('live', (e) => live.push(e)); + store.upsertUser({ id: 'u1', name: '하늘', avatar: null }); + const mk = (id: string, raw: string | null, text: string | null = raw) => { + const f = path.join(dir, 'audio', `${id}.ogg`); + fs.mkdirSync(path.dirname(f), { recursive: true }); + fs.writeFileSync(f, Buffer.concat([Buffer.from('OggS'), Buffer.alloc(50)])); + store.insertUtterance({ id, session_id: null, user_id: 'u1', started_at: Date.now(), ended_at: Date.now() + 1000, audio_path: f, match_id: null }); + if (raw !== null || text !== null) + store.updateUtteranceResult(id, { text, raw_text: raw, words: [], noise: false, noise_reason: null, confidence: 0.4, lufs: -30, gain_db: 0, model: 'm', status: 'precise' }); + return f; + }; + return { dir, store, timeline, bus, live, mk }; +} + +const api = (s: ReturnType) => + buildApi({ + store: s.store, + timeline: s.timeline, + games: {} as any, + dict: { learn() {}, invalidate() {} } as any, + culprit: {} as any, + bus: s.bus, + settings: () => ({ dictionary: { applySiteCorrections: false } }) as any, + trainingDir: () => path.join(s.dir, 'training'), + overviewExtra: () => ({ guild: null, recording: {} as any }), + version: 'test', + }); + +test('잡음 문장 비교: 띄어쓰기 · 문장부호 · 대소문자를 무시한다 (워커 noise.normalize 와 같게)', () => { + assert.equal(normalizePhrase('자막 제공 및 자막을 사용하였습니다.'), '자막제공및자막을사용하였습니다'); + assert.equal(normalizePhrase(' 자막제공, 및 자막을...사용하였습니다!! '), '자막제공및자막을사용하였습니다'); + assert.equal(normalizePhrase('MBC 뉴스_이덕영입니다'), 'mbc뉴스이덕영입니다'); + assert.equal(normalizePhrase('ㅋㅋㅋ'), 'ㅋㅋㅋ'); + assert.equal(normalizePhrase('... !!'), ''); + assert.equal(normalizePhrase(null), ''); +}); + +test('거의 같은 문장: 8글자 이상에서 15% 이하 차이만, 짧은 말은 통째로 같을 때만', () => { + const n = normalizePhrase; + assert.ok(similarPhrase(n('자막 제공 및 자막을 사용하였습니다'), n('자막 제공 및 자막을 사용했습니다'))); + assert.ok(similarPhrase(n('레이드 공 빠졌어 비 사이트로테 하자'), n('레이드 궁 빠졌어 비 사이트로테 하자'))); + assert.ok(!similarPhrase(n('자막 제공 및 자막을 사용하였습니다'), n('자막 제공 및 자막을 사용하였습니다 그리고 레이즈 궁'))); + assert.ok(!similarPhrase(n('시청해 주셔서'), n('시청해 주셨어')), '8글자 미만은 거의 같아도 아니다'); + assert.ok(!similarPhrase(n('오늘 저녁 뭐 먹을래'), n('내일 아침 뭐 먹을래'))); +}); + +test('발화 지우기: 관리자 · 말한 사람만, 글 · 음성 · 학습 데이터를 지우고 실시간으로 알린다', async () => { + const s = setup(); + const app = await api(s); + const f1 = s.mk('a1', '그냥 말'); + // 교정해서 학습 데이터가 생긴 발화 + s.mk('a2', '레이저 궁', '레이저 궁'); + const patched = await app.inject({ method: 'PATCH', url: '/api/utterances/a2', payload: { text: '레이즈 궁' } }); + assert.equal(patched.statusCode, 200); + const sample = s.store.trainingSamples()[0].audio_path; + assert.ok(fs.existsSync(sample)); + s.mk('a3', '아무 말'); + + // 다른 멤버는 못 지운다 (사이트 서버가 붙인 역할 · 유저로 판단) + const no = await app.inject({ method: 'POST', url: '/api/utterances/a1/delete', headers: as('m9'), payload: { noise: false } }); + assert.equal(no.statusCode, 403); + assert.ok(s.store.getUtterance('a1')); + // 말한 사람 본인 + const r1 = await app.inject({ method: 'POST', url: '/api/utterances/a1/delete', headers: as('u1'), payload: { noise: false } }); + assert.equal(r1.statusCode, 200); + assert.deepEqual(r1.json(), { ok: true, learned: null }); + assert.equal(s.store.getUtterance('a1'), undefined); + assert.ok(!fs.existsSync(f1)); + assert.deepEqual(s.live.at(-1), { type: 'utterance.deleted', data: { id: 'a1', noise: false } }); + // "그냥 삭제"는 아무것도 배우지 않는다 + assert.equal(s.store.listNoisePhrases().length, 0); + // 관리자: 교정 학습 데이터(음성 조각)도 같이 지운다 + const r2 = await app.inject({ method: 'POST', url: '/api/utterances/a2/delete', headers: as('m9', 'admin'), payload: {} }); + assert.equal(r2.statusCode, 200); + assert.equal(s.store.trainingSamples().length, 0); + assert.ok(!fs.existsSync(sample)); + // 이 PC 안에서 부른 것 (설정 창) + assert.equal((await app.inject({ method: 'POST', url: '/api/utterances/a3/delete', payload: {} })).statusCode, 200); + // 이미 지운 발화 + assert.equal((await app.inject({ method: 'POST', url: '/api/utterances/a3/delete', payload: {} })).statusCode, 404); + // 타임라인에서 빠진다 + assert.equal((await app.inject({ url: '/api/timeline' })).json().items.length, 0); + // 잘못된 사용자 머리글은 거절 + s.mk('a4', '말'); + assert.equal((await app.inject({ method: 'POST', url: '/api/utterances/a4/delete', headers: { 'x-gvr-user': '%E0%A4%A' }, payload: {} })).statusCode, 403); + await app.close(); +}); + +test('잡음이라 삭제: 인식 문장을 배우고, 목록 · 지우기 API 로 볼 수 있다', async () => { + const s = setup(); + const app = await api(s); + s.mk('n1', '자막 제공 및 자막을 사용하였습니다.'); + s.mk('n2', null); // 아직 인식 전: 배울 문장 없음 + const r = await app.inject({ method: 'POST', url: '/api/utterances/n1/delete', headers: as('u1'), payload: { noise: true } }); + assert.deepEqual(r.json(), { ok: true, learned: '자막 제공 및 자막을 사용하였습니다.' }); + assert.deepEqual(s.live.at(-1), { type: 'utterance.deleted', data: { id: 'n1', noise: true } }); + const r2 = await app.inject({ method: 'POST', url: '/api/utterances/n2/delete', headers: as('u1'), payload: { noise: true } }); + assert.deepEqual(r2.json(), { ok: true, learned: null }); + const list = (await app.inject({ url: '/api/noise-phrases' })).json().phrases; + assert.equal(list.length, 1); + assert.equal(list[0].text, '자막 제공 및 자막을 사용하였습니다.'); + assert.equal(list[0].hits, 0); + assert.equal(s.store.listNoisePhrases()[0].phrase, '자막제공및자막을사용하였습니다'); + // 같은 문장을 또 배우면 하나로 + s.mk('n3', '자막제공 및 자막을 사용하였습니다'); + await app.inject({ method: 'POST', url: '/api/utterances/n3/delete', payload: { noise: true } }); + assert.equal(s.store.listNoisePhrases().length, 1); + assert.equal((await app.inject({ method: 'DELETE', url: `/api/noise-phrases/${list[0].id}` })).statusCode, 200); + assert.equal((await app.inject({ method: 'DELETE', url: `/api/noise-phrases/${list[0].id}` })).statusCode, 404); + assert.equal(s.store.listNoisePhrases().length, 0); + await app.close(); +}); + +test('음성 인식: 배운 잡음 문장과 같으면 잡음으로 숨기고 파일을 지운다 · 변환 중에 지운 발화는 결과를 버린다', async () => { + const s = setup(); + s.store.addNoisePhrase(normalizePhrase('자막 제공 및 자막을 사용하였습니다.'), '자막 제공 및 자막을 사용하였습니다.'); + const results: Record = { p1: '자막 제공 및 자막을 사용했습니다', p2: '자막 제공 및 자막을 사용하였습니다. 그리고 레이즈 궁', p3: '아무 말' }; + let hold: (() => void) | null = null; + const worker: any = Object.assign(new EventEmitter(), { + ready: true, + request: async (op: string, req: any) => { + if (op === 'gpu_info') return { gpus: [] }; + if (op === 'models') return { models: [{ name: 'm', installed: true }] }; + if (op === 'load') return {}; + const id = path.basename(req.path, '.ogg'); + if (id === 'p3') await new Promise((r) => (hold = r)); + const t = results[id]; + return { text: t, raw_text: t, words: [], noise: false, noise_reason: null, confidence: 0.5, lufs: -30, gain_db: 0, speech_ratio: 1, duration_s: 1, model: 'm', elapsed_ms: 1 }; + }, + }); + const settings: any = () => ({ stt: { realtimeModel: 'm', preciseModel: 'm', device: 'cpu', computeType: 'int8', gameVramReserveMb: 0, reprocessAfterMatch: false }, audio: { targetLufs: -18, noiseSensitivity: 0.5, denoise: false } }); + const dict: any = { hotwords: () => '', corrections: () => [], candidates: () => [] }; + const stt = new SttPipeline(worker, s.store, dict, s.timeline, s.bus, settings); + await stt.load('realtime', 'm'); + const f1 = s.mk('p1', null); + const f2 = s.mk('p2', null); + const f3 = s.mk('p3', null); + const wait = async (fn: () => boolean) => { + const t = Date.now(); + while (!fn()) { + if (Date.now() - t > 5000) throw new Error('timeout'); + await new Promise((r) => setTimeout(r, 10)); + } + }; + stt.enqueue('p1', 'realtime'); + stt.enqueue('p2', 'realtime'); + await wait(() => s.store.getUtterance('p2')!.status !== 'pending'); + const p1 = s.store.getUtterance('p1')!; + assert.equal(p1.noise, 1); + assert.equal(p1.noise_reason, 'learned'); + assert.equal(p1.text, null); + assert.equal(p1.audio_deleted, 1); + assert.ok(!fs.existsSync(f1)); + assert.equal(s.store.listNoisePhrases()[0].hits, 1, '한두 글자 다른 문장도 거른다'); + // 문장이 더 붙으면 다른 말이다 (통째로 같을 때만 거른다) + const p2 = s.store.getUtterance('p2')!; + assert.equal(p2.noise, 0); + assert.ok(fs.existsSync(f2)); + // 변환하는 동안 지우면 결과를 DB 에 되살리지 않는다 + stt.enqueue('p3', 'realtime'); + await wait(() => !!hold); + s.store.deleteUtterance('p3'); + const gainN = s.store.getUser('u1')!.gain_n; + hold!(); + await wait(() => !stt.isBusy('p3')); + assert.equal(s.store.getUser('u1')!.gain_n, gainN, '지운 발화의 음량은 평소 음량에 넣지 않는다'); + assert.equal(s.store.getUtterance('p3'), undefined); + assert.ok(!s.live.some((e) => e.type === 'utterance.updated' && e.data.id === 'p3')); + assert.ok(fs.existsSync(f3), 'store.deleteUtterance 는 파일을 직접 지우지 않는다 (API 가 지움)'); +}); diff --git a/docs/dev/ARCHITECTURE.md b/docs/dev/ARCHITECTURE.md index fe7720e..df9de89 100644 --- a/docs/dev/ARCHITECTURE.md +++ b/docs/dev/ARCHITECTURE.md @@ -114,6 +114,7 @@ GVR-Data/ - `game_events(id PK, match_id, game, type, ts INT ms(real), game_time_ms, round, actor_puuid, target_puuid, data JSON)` - `dictionary(id PK, word, pack, kind ('hotword'|'correction'), from_text, source ('builtin'|'user'|'site'), enabled)` - `training_samples(id PK, utterance_id, text, audio_path, used INT, created_at)` +- `noise_phrases(id PK, phrase UNIQUE (띄어쓰기 · 문장부호 뺀 값), sample, hits, created_at)` — "잡음이라 삭제"로 배운 문장 (v1.4.0) ## 4. 앱 HTTP API (코어 Fastify, 127.0.0.1) — 사이트 서버가 그대로 중계 @@ -131,6 +132,9 @@ GVR-Data/ | GET | `/api/matches/:id` | `MatchDetail` | | PATCH | `/api/utterances/:id` | `{text}` → 교정 저장, 교정 사전·학습 데이터 반영. 응답 `TimelineItem` | | GET | `/api/dictionary` | 사전 목록 | +| POST | `/api/utterances/:id/delete` | `{noise}` → 발화 · 음성 · 학습 데이터 지우기 (관리자 · 말한 사람). noise=true 면 문장을 잡음으로 배움. 응답 `{ok, learned}`, 실시간 `utterance.deleted` | +| GET | `/api/noise-phrases` | `{phrases:[{id,text,hits,createdAt}]}` 잡음으로 배운 문장 | +| DELETE | `/api/noise-phrases/:id` | 배운 문장 지우기 | `/api/timeline` 쿼리: `users=a,b` · `game=valorant|lol|none` · `match=` · `from=&to=` · `q=<키워드>` · `types=utterance,kill,chat,object,round` · `hideNoise=1` · `cursor=` · `limit=100` · diff --git a/docs/dev/test-results.md b/docs/dev/test-results.md index 1574633..f9785bf 100644 --- a/docs/dev/test-results.md +++ b/docs/dev/test-results.md @@ -236,3 +236,11 @@ VOICE E2E PASS - 고침: zip 안 이름은 zip 에서 꺼낼 열쇠로만 쓰고, 이 PC 에 쓰는 경로는 발화 ID 로 만든다. 폴더 구분자만 막는다 - 테스트: `audio-names.test.ts` "표시 이름에 .. 이 있어도 내보내기 → 지우기 → 받아오기" (예전 코드에서 실패 확인 뒤 고침), "폴더를 넘나드는 zip 안 이름(audio/../, audio/..\, audio/sub/, ../)은 막는다". 앱 57 통과 - 배포: Windows CI (55ec58f, full) 7개 모두 PASS · 앱 버전 1.3.9 → Gitea 릴리스 v1.3.9 (v1.3.8 에 새 버전 안내). 사이트 서버는 바뀐 것 없음 + +## v1.4.0 — 발화 우클릭 삭제 · 잡음 문장 배우기 · 알림 기본 끄기 (2026-10-16) + +- 사이트 우클릭 → 삭제… → "잡음이라 삭제" / "그냥 삭제" / 취소. 관리자 · 말한 사람만 (사이트 서버가 붙인 역할 · 유저로 앱이 확인) +- 테스트 `utterance-delete.test.ts`: 다른 멤버 403 · 본인 · 관리자 · 이 PC 안에서는 지움, 글 · 음성 · 교정 학습 음성 조각까지 지움, `utterance.deleted` 실시간 이벤트, 이미 지운 발화 404, 잘못된 사용자 머리글 403. 잡음이라 삭제 → 문장 배움(같은 문장은 하나로) · 목록 · 지우기. 음성 인식: 배운 문장과 같거나 거의 같으면(`…사용하였습니다` / `…사용했습니다`) 잡음 · 파일 삭제, 문장이 더 붙으면 그대로, 변환하는 동안 지운 발화는 결과 · 평소 음량에 넣지 않음 (이 확인을 빼면 실패하는 것 확인) +- 실제 STT 워커 E2E: "잡음이라 삭제"한 녹음을 다시 넣으니 인식이 한 글자 달랐다 ("레이드 공 빠졌어…" → "레이드 궁 빠졌어…", 교정 사전이 바뀌어 핫워드가 달라짐). 그래서 통째로 같을 때만이 아니라 8글자 이상이면 15% 안 글자 차이까지 같은 문장으로 본다 → `learned` 잡음, 파일 삭제, 타임라인에서 빠짐 +- 사이트(목 서버 + 실제 빌드, 브라우저): 우클릭 메뉴 삭제 → 확인 창 → 잡음이라 삭제 → 줄이 사라지고 "앞으로 … 는 잡음으로 거릅니다", 단어사전 "잡음으로 배운 문장"에 추가. 인식된 글이 없으면 "잡음이라 삭제" 꺼짐. 효과음: 저장된 설정이 없으면 새 기본값, 예전 설정(전부 켜짐)은 두 알림만 한 번 끄고, 그 뒤 다시 켠 것은 그대로 +- 테스트: 앱 62 · 사이트 서버 16 · 워커 42 통과, 앱 · 화면 · 서버 타입 검사 통과 diff --git a/packages/shared/src/protocol.ts b/packages/shared/src/protocol.ts index 46c451c..6743b4f 100644 --- a/packages/shared/src/protocol.ts +++ b/packages/shared/src/protocol.ts @@ -427,7 +427,18 @@ export type LiveEvent = | { type: 'recording.state'; data: Overview['recording'] } | { type: 'users.updated'; data: User[] } | { type: 'games.state'; data: LiveGame[] } - | { type: 'records.changed'; data: { reason: 'deleted' | 'imported'; ids?: string[] } }; + | { type: 'records.changed'; data: { reason: 'deleted' | 'imported'; ids?: string[] } } + /** 사이트 우클릭으로 발화 하나를 지움 (v1.4.0). noise = "잡음이라 삭제" */ + | { type: 'utterance.deleted'; data: { id: string; noise: boolean } }; + +/** "잡음이라 삭제"로 배운 문장 (GET /api/noise-phrases) */ +export interface NoisePhrase { + id: number; + text: string; + /** 그 뒤로 이 문장을 잡음으로 걸러 낸 횟수 */ + hits: number; + createdAt: number; +} export interface DeviceStatus { registered: boolean; diff --git a/site/web/mock/server.mjs b/site/web/mock/server.mjs index b52ce2c..74af592 100644 --- a/site/web/mock/server.mjs +++ b/site/web/mock/server.mjs @@ -117,6 +117,9 @@ function userProfile(id) { // ── WS ─────────────────────────────────────────────── let wss; +// "잡음이라 삭제"로 배운 문장 (v1.4.0) +const noisePhrases = [{ id: 1, text: '시청해 주셔서 감사합니다 자막 제공', hits: 3, createdAt: Date.now() - 86400000 }]; +let noiseSeq = 1; const broadcast = (msg) => { const s = JSON.stringify(msg, (k, v) => (k.startsWith('_') ? undefined : v)); wss?.clients.forEach((c) => c.readyState === 1 && c.send(s)); @@ -264,6 +267,35 @@ async function handle(req, res) { broadcast({ type: 'utterance.updated', data: it }); return json(res, 200, it); } + if ((m = p.match(/^\/api\/utterances\/([^/]+)\/delete$/)) && req.method === 'POST') { + const i = db.utterances.findIndex((u) => u.id === decodeURIComponent(m[1])); + if (i < 0) return json(res, 404, { error: 'not_found' }); + const body = JSON.parse((await readBody(req)) || '{}'); + const [it] = db.utterances.splice(i, 1); + let learned = null; + if (body.noise && it.text) { + learned = it.text; + noisePhrases.unshift({ id: ++noiseSeq, text: it.text, hits: 0, createdAt: Date.now() }); + } + broadcast({ type: 'utterance.deleted', data: { id: it.id, noise: !!body.noise } }); + return json(res, 200, { ok: true, learned }); + } + if (p === '/api/dictionary') + return json(res, 200, { + labels: { valorant: '발로란트', lol: '롤' }, + entries: [ + { id: 1, word: '로테', from: null, kind: 'hotword', pack: 'site', source: 'site', enabled: true, hits: 12 }, + { id: 2, word: '레이즈', from: '레이저', kind: 'correction', pack: 'site', source: 'site', enabled: true, hits: 0 }, + ], + packs: [{ key: 'valorant', label: '발로란트', count: 420 }], + }); + if (p === '/api/noise-phrases') return json(res, 200, { phrases: noisePhrases }); + if ((m = p.match(/^\/api\/noise-phrases\/(\d+)$/)) && req.method === 'DELETE') { + const i = noisePhrases.findIndex((x) => x.id === Number(m[1])); + if (i < 0) return json(res, 404, { error: 'not_found' }); + noisePhrases.splice(i, 1); + return json(res, 200, { ok: true }); + } if (p === '/api/bundles') { const out = []; for (const mt of db.matches) { diff --git a/site/web/src/components/UttMenu.tsx b/site/web/src/components/UttMenu.tsx index c9c7b22..c9314d9 100644 --- a/site/web/src/components/UttMenu.tsx +++ b/site/web/src/components/UttMenu.tsx @@ -3,13 +3,16 @@ import type { UtteranceInfo, UtteranceItem } from '@gvr/shared'; import { api, ApiError } from '../lib/api'; import { fmtWhen } from '../lib/format'; import { player } from '../store/player'; -import { useData } from '../store/app'; +import { useAuth, useData, useLive } from '../store/app'; import { IClose, IDownload, IPlay } from './Icons'; /** 발화 우클릭 메뉴 · 자세한 정보 창 (앱에 하나만 띄운다) */ type MenuState = { item: UtteranceItem; x: number; y: number } | null; let menu: MenuState = null; let infoFor: UtteranceItem | null = null; +let deleteFor: UtteranceItem | null = null; +/** 이 화면에서 지운 발화 (다른 사람이 지운 것도 실시간으로). 목록마다 따로 고치지 않고 줄이 스스로 숨는다 */ +const deleted = new Set(); const subs = new Set<() => void>(); const notify = () => subs.forEach((f) => f()); const subscribe = (f: () => void) => { @@ -36,6 +39,25 @@ function closeInfo(): void { infoFor = null; notify(); } +function openDelete(item: UtteranceItem): void { + menu = null; + deleteFor = item; + notify(); +} +function closeDelete(): void { + deleteFor = null; + notify(); +} +function markDeleted(id: string): void { + if (deleted.has(id)) return; + deleted.add(id); + if (player.state.item?.id === id) player.stop(); + notify(); +} +/** 지운 발화인가 (줄을 숨긴다) */ +export function useDeleted(id: string): boolean { + return useSyncExternalStore(subscribe, () => deleted.has(id)); +} /** 녹음 원본(.ogg)을 내려받는다. 게임 PC → 사이트 서버 중계로 받은 파일을 그대로 저장 */ export async function downloadAudio(item: UtteranceItem, fileName?: string | null): Promise { @@ -59,7 +81,16 @@ const copy = (text: string) => navigator.clipboard?.writeText(text).catch(() => export function UttMenuHost() { const m = useSyncExternalStore(subscribe, () => menu); const info = useSyncExternalStore(subscribe, () => infoFor); + const del = useSyncExternalStore(subscribe, () => deleteFor); const [err, setErr] = useState(null); + const [okMsg, setOkMsg] = useState(null); + const { auth } = useAuth(); + // 지우기: 관리자나 말한 사람만 (게임 PC 도 한 번 더 확인한다) + const canDelete = (it: UtteranceItem) => auth.status === 'ok' && (!!auth.me.canViewLogs || auth.me.user.id === it.userId); + + useLive((e) => { + if (e.type === 'utterance.deleted') markDeleted(e.data.id); + }); useEffect(() => { if (!m) return; @@ -82,6 +113,11 @@ export function UttMenuHost() { const t = setTimeout(() => setErr(null), 4000); return () => clearTimeout(t); }, [err]); + useEffect(() => { + if (!okMsg) return; + const t = setTimeout(() => setOkMsg(null), 4000); + return () => clearTimeout(t); + }, [okMsg]); const act = (fn: () => unknown) => (e: React.PointerEvent | React.MouseEvent) => { e.stopPropagation(); @@ -95,7 +131,7 @@ export function UttMenuHost() {
e.stopPropagation()} onContextMenu={(e) => e.preventDefault()} > @@ -111,10 +147,32 @@ export function UttMenuHost() { +
+
)} {info && } + {del && ( + { + markDeleted(del.id); + closeDelete(); + setOkMsg(learned ? `삭제했습니다. 앞으로 "${learned.length > 40 ? learned.slice(0, 40) + '…' : learned}" 는 잡음으로 거릅니다` : '삭제했습니다'); + }} + /> + )} {err &&
{err}
} + {okMsg && !err &&
{okMsg}
} ); } @@ -218,3 +276,73 @@ function InfoDialog({ item, onError }: { item: UtteranceItem; onError: (m: strin
); } + +/** 삭제 확인: 잡음이라 삭제(같은 문장을 다음부터 잡음으로 거름) · 그냥 삭제 · 취소 */ +function DeleteDialog({ item, onDone }: { item: UtteranceItem; onDone: (learned: string | null) => void }) { + const { userById } = useData(); + const [busy, setBusy] = useState<'noise' | 'plain' | null>(null); + const [failed, setFailed] = useState(null); + const text = item.text?.trim() || null; + + useEffect(() => { + const onKey = (e: KeyboardEvent) => e.key === 'Escape' && !busy && closeDelete(); + window.addEventListener('keydown', onKey); + return () => window.removeEventListener('keydown', onKey); + }, [busy]); + + const run = async (noise: boolean) => { + setBusy(noise ? 'noise' : 'plain'); + setFailed(null); + try { + const r = await api.deleteUtterance(item.id, noise); + onDone(r.learned); + } catch (e) { + setBusy(null); + if (e instanceof ApiError && e.status === 404 && e.code === 'not_found') return onDone(null); // 이미 지워짐 + setFailed( + e instanceof ApiError && e.status === 404 + ? '게임 PC 의 겜녹이가 예전 버전입니다. v1.4.0 이상으로 업데이트하면 지울 수 있습니다.' + : e instanceof ApiError && e.status === 403 + ? '관리자나 말한 사람만 지울 수 있습니다.' + : e instanceof ApiError && e.status === 503 + ? '게임 PC 가 꺼져 있어 지우지 못했습니다.' + : '지우지 못했습니다. 잠시 뒤 다시 시도해 주세요.', + ); + } + }; + + return ( +
!busy && closeDelete()}> +
e.stopPropagation()}> +
+ 발화 삭제 + +
+
+ {userById(item.userId)?.name ?? '알 수 없음'} · {fmtWhen(item.ts)} +

{text ?? '(인식된 글 없음)'}

+
+

+ 글과 음성 파일을 게임 PC 에서 지웁니다. 되돌릴 수 없습니다. +
+ 잡음이라 삭제를 고르면 이 문장을 잡음으로 배워서, 다음에 같은 문장이 인식되면 자동으로 잡음 처리합니다 (띄어쓰기 · 문장부호는 무시하고, 긴 문장은 한두 글자 달라도 같은 문장으로 봅니다). + 배운 문장은 사전 화면에서 지울 수 있습니다. +

+ {failed &&

{failed}

} +
+ + + +
+
+
+ ); +} diff --git a/site/web/src/components/UtteranceRow.tsx b/site/web/src/components/UtteranceRow.tsx index 8128bef..24ce6ac 100644 --- a/site/web/src/components/UtteranceRow.tsx +++ b/site/web/src/components/UtteranceRow.tsx @@ -7,7 +7,7 @@ import { sfx } from '../lib/sfx'; import { realTip } from '../lib/format'; import { Avatar, TimeCell } from './common'; import { IEdit } from './Icons'; -import { openUttMenu } from './UttMenu'; +import { openUttMenu, useDeleted } from './UttMenu'; const STATUS: Record = { realtime: ['실시간', 'st-rt'], @@ -147,6 +147,7 @@ export const UtteranceRow = memo(function UtteranceRow({ item, variant = 'full', const playing = usePlayer((s) => active && s.playing); const [editing, setEditing] = useState(false); const [st, stCls] = STATUS[item.status]; + const gone = useDeleted(item.id); const click = () => { if (editing) return; @@ -183,6 +184,9 @@ export const UtteranceRow = memo(function UtteranceRow({ item, variant = 'full', ); + // 우클릭으로 지운 발화 (경기 화면 · 유저 화면 등 어느 목록이든 줄이 숨는다) + if (gone) return null; + if (variant === 'compact') { return (
diff --git a/site/web/src/lib/api.ts b/site/web/src/lib/api.ts index 63de93d..6424800 100644 --- a/site/web/src/lib/api.ts +++ b/site/web/src/lib/api.ts @@ -14,6 +14,7 @@ import type { GameType, BundleInfo, BundleImportResult, + NoisePhrase, } from '@gvr/shared'; import { reportClient } from './report'; @@ -191,6 +192,11 @@ export const api = { utteranceInfo: (id: string) => request(`/api/utterances/${encodeURIComponent(id)}/info`), correct: (id: string, text: string) => request(`/api/utterances/${encodeURIComponent(id)}`, { method: 'PATCH', body: JSON.stringify({ text }) }), + /** 발화 지우기 (v1.4.0). noise = 잡음이라 삭제 (같은 문장을 다음부터 잡음으로) */ + deleteUtterance: (id: string, noise: boolean) => + request<{ ok: true; learned: string | null }>(`/api/utterances/${encodeURIComponent(id)}/delete`, { method: 'POST', body: JSON.stringify({ noise }) }), + noisePhrases: () => request<{ phrases: NoisePhrase[] }>('/api/noise-phrases'), + deleteNoisePhrase: (id: number) => request<{ ok: true }>(`/api/noise-phrases/${id}`, { method: 'DELETE' }), }; export interface DictionaryEntry { diff --git a/site/web/src/pages/DictionaryPage.tsx b/site/web/src/pages/DictionaryPage.tsx index af7f52d..d5ac078 100644 --- a/site/web/src/pages/DictionaryPage.tsx +++ b/site/web/src/pages/DictionaryPage.tsx @@ -1,4 +1,5 @@ import { useEffect, useMemo, useState } from 'react'; +import type { NoisePhrase } from '@gvr/shared'; import { api, type DictionaryResponse } from '../lib/api'; import { useStatus } from '../store/app'; import { sfx } from '../lib/sfx'; @@ -17,12 +18,18 @@ export function DictionaryPage() { const [from, setFrom] = useState(''); const [to, setTo] = useState(''); const [busy, setBusy] = useState(false); + // "잡음이라 삭제"로 배운 문장 (v1.4.0). 예전 앱이면 null → 칸을 숨긴다 + const [noise, setNoise] = useState(null); useEffect(() => { let alive = true; api .dictionary() .then((d) => alive && setData(d)) .catch((e) => alive && setErr(e)); + api + .noisePhrases() + .then((r) => alive && setNoise(r.phrases)) + .catch(() => alive && setNoise(null)); return () => { alive = false; }; @@ -110,6 +117,34 @@ export function DictionaryPage() {
+ {noise && ( +
+

+ 잡음으로 배운 문장 {noise.length} +

+

타임라인에서 우클릭 → 삭제 → "잡음이라 삭제"로 넣은 문장입니다. 같은 문장이 다시 인식되면 자동으로 잡음 처리합니다 (띄어쓰기 · 문장부호 무시, 8글자 이상이면 한두 글자 달라도). 실제 말까지 걸러지면 여기서 지워 주세요.

+ + + {noise.length === 0 && ( + + + + )} + {noise.map((p) => ( + + + + + + ))} + +
아직 없습니다
{p.text}{p.hits ? `${p.hits}번 거름` : ''} + +
+
+ )} ); } diff --git a/site/web/src/pages/TimelinePage.tsx b/site/web/src/pages/TimelinePage.tsx index b6ea021..1c3df4e 100644 --- a/site/web/src/pages/TimelinePage.tsx +++ b/site/web/src/pages/TimelinePage.tsx @@ -321,6 +321,9 @@ export function TimelinePage() { if (i < 0) return next ? prev : [...prev, it]; return [...prev.slice(0, i), it, ...prev.slice(i)]; }); + } else if (e.type === 'utterance.deleted') { + // 우클릭으로 지운 발화 (v1.4.0) + setItems((prev) => prev.filter((p) => p.id !== e.data.id)); } }); diff --git a/site/web/src/store/settings.ts b/site/web/src/store/settings.ts index 2ce0f44..75c79ed 100644 --- a/site/web/src/store/settings.ts +++ b/site/web/src/store/settings.ts @@ -10,17 +10,21 @@ export interface Settings { normalize: boolean; /** 녹음 재생 음량 0..2 (1 = 원래 크기) */ playVolume: number; + /** 기본값을 바꾼 횟수 (예전에 저장한 설정을 한 번만 새 기본값으로 맞춘다) */ + defaultsRev?: number; } const KEY = 'gvr.settings.v1'; const DEFAULTS: Settings = { volume: 0.5, - sfx: { click: true, play: true, kill: true, round: true, chime: true }, + // 새 발화 알림 · 재생 시작 효과음은 기본으로 끈다 (v1.4.0) + sfx: { click: true, play: false, kill: true, round: true, chime: false }, reduceMotion: false, rate: 1, continuous: true, normalize: true, playVolume: 1, + defaultsRev: 1, }; function load(): Settings { @@ -28,7 +32,18 @@ function load(): Settings { const raw = localStorage.getItem(KEY); if (!raw) return DEFAULTS; const v = JSON.parse(raw) as Partial; - return { ...DEFAULTS, ...v, sfx: { ...DEFAULTS.sfx, ...(v.sfx ?? {}) } }; + const out = { ...DEFAULTS, ...v, sfx: { ...DEFAULTS.sfx, ...(v.sfx ?? {}) } }; + // 예전 사이트는 설정을 하나만 바꿔도 효과음 켜짐/꺼짐을 전부 저장했다: 새 기본값(두 알림 끄기)을 한 번 적용 + if ((v.defaultsRev ?? 0) < 1) { + out.sfx = { ...out.sfx, play: false, chime: false }; + out.defaultsRev = 1; + try { + localStorage.setItem(KEY, JSON.stringify(out)); + } catch { + /* 사생활 보호 모드 등 */ + } + } + return out; } catch { return DEFAULTS; } diff --git a/site/web/src/styles.css b/site/web/src/styles.css index 22077f7..184abe9 100644 --- a/site/web/src/styles.css +++ b/site/web/src/styles.css @@ -3211,6 +3211,9 @@ button.match:hover { @media (max-width: 900px) { .dict-grid { grid-template-columns: 1fr; } } .dict-grid .card { background: #121e29; border: 1px solid #243545; border-radius: 12px; padding: 16px 18px; } .dict-grid h3 { font-size: 15px; margin-bottom: 12px; } +.dict-noise { margin-top: 16px; background: #121e29; border: 1px solid #243545; border-radius: 12px; padding: 16px 18px; } +.dict-noise h3 { font-size: 15px; margin-bottom: 6px; } +.dict-noise p { margin: 0 0 10px; } .dict-form { display: flex; gap: 8px; align-items: center; margin-bottom: 12px; } .dict-form input { flex: 1; min-width: 0; background: #0d1720; border: 1px solid #243545; border-radius: 8px; padding: 9px 12px; color: inherit; } .dict-list { display: flex; flex-wrap: wrap; gap: 8px; } @@ -3579,6 +3582,53 @@ button.match:hover { border-radius: 8px; font-size: 13px; } +.ctx-toast.ok { + background: #102a1f; + border-color: #23573f; + color: #a6f0c6; +} +.ctx-sep { + height: 1px; + margin: 4px 6px; + background: #22323f; +} +.ctx-menu button.danger:not(:disabled) { + color: #ff9aa3; +} +.ctx-menu button.danger:hover:not(:disabled) { + background: rgba(255, 70, 85, 0.14); +} +.del-dialog { + width: min(480px, 100%); +} +.del-quote { + padding: 10px 12px; + border-radius: 9px; + background: #13202c; + border: 1px solid #22323f; + font-size: 12px; +} +.del-quote p { + margin: 4px 0 0; + font-size: 14px; + word-break: break-all; +} +.del-help { + font-size: 12.5px; + line-height: 1.6; + color: var(--muted); + margin: 12px 0 0; +} +.del-err { + font-size: 13px; + color: #ff9aa3; + margin: 10px 0 0; +} +.chip.danger.on { + background: rgba(255, 70, 85, 0.22); + border-color: rgba(255, 70, 85, 0.7); + color: #ffd0d4; +} /* ── 사이트 로그 (/logs) ── */ .logs-page {