diff --git a/README.md b/README.md index 9c8317a..197910d 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.4.1](https://git.tkrmagid.kr/tkrmagid/game_voice_recorder/releases/tag/v1.4.1) (`GameVoiceRecorder-1.4.1-win-x64.zip` 권장, 단일 파일 `GameVoiceRecorder-1.4.1-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.2](https://git.tkrmagid.kr/tkrmagid/game_voice_recorder/releases/tag/v1.4.2) (`GameVoiceRecorder-1.4.2-win-x64.zip` 권장, 단일 파일 `GameVoiceRecorder-1.4.2-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,11 @@ - 앱은 시작할 때와 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.2 바뀐 점 + +- 녹음 중에 음성채널에 들어온 사람이 사이트에서 "알 수 없음"으로 뜨던 문제: 앱이 그 사람을 유저로 저장만 하고 `users.updated` 를 보내지 않았다. 이제 들어올 때 보낸다 (`app/src/core/discord/bot.ts` onVoiceState) +- 사이트도 실시간 발화 · 녹음 상태에 처음 보는 사람 아이디가 오면 유저 목록을 한 번 다시 받아 온다 (v1.4.1 이하 앱에서도 이름이 뜸) + ## v1.4.1 바뀐 점 - 잡음으로 배운 문장 비교: v1.4.0 은 편집 거리로 비교해서, 배운 문장 뒤에 짧은 실제 말("네", "가자", "아니")이 붙은 발화까지 잡음으로 지웠다. 이제 글자 수가 같고 15% 안 글자만 바뀐 것(인식이 한두 글자 다르게 나온 것)만 같은 문장으로 본다 diff --git a/app/package-lock.json b/app/package-lock.json index ec52a2b..34e7be7 100644 --- a/app/package-lock.json +++ b/app/package-lock.json @@ -1,12 +1,12 @@ { "name": "gvr-app", - "version": "1.4.1", + "version": "1.4.2", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "gvr-app", - "version": "1.4.1", + "version": "1.4.2", "license": "UNLICENSED", "dependencies": { "@discordjs/voice": "^0.19.2", diff --git a/app/package.json b/app/package.json index b92d8b8..0d7a169 100644 --- a/app/package.json +++ b/app/package.json @@ -1,7 +1,7 @@ { "name": "gvr-app", "productName": "겜녹이", - "version": "1.4.1", + "version": "1.4.2", "description": "겜녹이 (Game Voice Recorder) - 게임 연동 디스코드 음성 기록", "private": true, "main": "dist/main.cjs", diff --git a/app/src/core/discord/bot.ts b/app/src/core/discord/bot.ts index 6510fa6..3c9d6d0 100644 --- a/app/src/core/discord/bot.ts +++ b/app/src/core/discord/bot.ts @@ -177,6 +177,8 @@ export class Bot { // 새 사람이 들어오면 안내를 다시 튼다 if (e.newChannelId === myCh && e.oldChannelId !== myCh && (!e.member.bot || process.env.GVR_RECORD_BOTS === '1')) { this.touchUser(e.member); + // 녹음 중에 들어온 사람도 사이트가 이름을 알게 한다 (안 보내면 그 사람 발화가 "알 수 없음"으로 뜸) + this.bus.live({ type: 'users.updated', data: [] }); this.updateParticipants(); if (s.ttsEnabled && s.ttsOnNewMember) void this.announce(); } diff --git a/app/test/core.test.ts b/app/test/core.test.ts index 5fabc5b..2632832 100644 --- a/app/test/core.test.ts +++ b/app/test/core.test.ts @@ -296,6 +296,29 @@ test('users.updated: 보내는 쪽이 빈 목록을 줘도 실제 유저 목록 assert.equal(got[0].data[0].name, '하늘'); }); +test('녹음 중에 들어온 사람: 유저로 저장하고 users.updated 를 보낸다 (중간 참여자 "알 수 없음" 버그)', async () => { + const { Bus } = await import('../src/core/util/events.ts'); + const { Bot } = await import('../src/core/discord/bot.ts'); + const store = new Store(path.join(tmp(), 'db.sqlite')); + const bus = new Bus(); + bus.usersProvider = () => store.listUsers().map((u) => ({ id: u.id, name: u.name, color: u.color, avatar: u.avatar, excluded: false, riot: [] })); + const got: any[] = []; + bus.on('live', (e) => got.push(e)); + const settings = () => ({ discord: { followEnabled: false, followUserId: null, ttsEnabled: false, ttsOnNewMember: false } }) as any; + const bot = new Bot(store, {} as any, {} as any, bus, settings); + const late = { id: '42', name: '늦게온사람', avatar: null, bot: false }; + bot.gateway = { channelMembers: () => [late] } as any; + bot.state.guild = { id: 'g', name: 'g', icon: null }; + bot.state.recording = { active: true, channel: '음성', channelId: 'vc', since: 1, participants: [], reason: 'command' }; + await (bot as any).onVoiceState({ guildId: 'g', member: late, oldChannelId: null, newChannelId: 'vc', channel: { id: 'vc', name: '음성' } }); + assert.equal(store.getUser('42')?.name, '늦게온사람'); + const upd = got.filter((e) => e.type === 'users.updated'); + assert.equal(upd.length, 1); + assert.ok(upd[0].data.some((u: any) => u.id === '42' && u.name === '늦게온사람')); + assert.deepEqual(bot.state.recording.participants, ['42']); + store.close(); +}); + test('녹음 안내 말 속도: 0.1~2.0 으로 자르고 속도마다 따로 캐시한다', async () => { const { Announcer, clampRate } = await import('../src/core/discord/tts.ts'); assert.equal(clampRate(0.05), 0.1); diff --git a/docs/dev/test-results.md b/docs/dev/test-results.md index 788d39b..4603656 100644 --- a/docs/dev/test-results.md +++ b/docs/dev/test-results.md @@ -252,3 +252,11 @@ VOICE E2E PASS - 고침: 글자 수가 같고(8글자 이상) 바뀐 글자가 15% 이하일 때만 (실제 엔진에서 본 "레이드 공" / "레이드 궁" 은 그대로 잡음). 글자가 붙거나 빠지면 다른 말 - 테스트 `utterance-delete.test.ts`: 앞뒤에 `네` · `가자` · `아니`를 붙인 문장은 비슷하지 않음, 음성 인식에서 그 발화들의 글 · 음성 파일이 남음 (v1.4.0 코드에서 실패 확인 뒤 고침) - 배포: 사이트 서버 다시 배포 (바뀐 안내 문구 확인), Windows CI (df0c826, full) 7개 모두 PASS · 앱 버전 1.4.1 → Gitea 릴리스 v1.4.1 (v1.4.0 에 새 버전 안내). 실제 STT 워커 E2E 에서 "레이드 공/궁" 은 그대로 learned 잡음 + +## v1.4.2 — 녹음 중에 들어온 사람이 "알 수 없음"으로 뜨던 문제 (2026-10-16) + +- 원인: 녹음 시작 때 채널에 있던 사람만 `users.updated` 를 보냈다. 녹음 중에 들어온 사람은 `onVoiceState` 에서 DB 에 저장만 하고 알리지 않아, 사이트의 유저 목록에 없어 발화가 "알 수 없음"으로 떴다 (새로고침하면 보임) +- 고침: 앱은 들어올 때 `users.updated` 를 보낸다. 사이트는 `utterance.created/updated` · `recording.state` 에 모르는 아이디가 오면 `/api/users` 를 한 번 다시 받는다 (같은 아이디는 한 번만) +- 테스트 `core.test.ts` "녹음 중에 들어온 사람": 고치기 전 코드에서 실패(users.updated 0번) 확인 뒤 통과 +- 사이트(목 서버 `/mock/latejoin`, 브라우저): 고치기 전 화면은 새 발화 2곳이 "알 수 없음", 고친 화면은 이름이 바로 뜨고 왼쪽 유저 목록에도 추가 +- 테스트: 앱 63 · 사이트 서버 16 통과, 앱 · 화면 · 서버 타입 검사 · 화면 빌드 통과 diff --git a/site/web/mock/server.mjs b/site/web/mock/server.mjs index 74af592..a33969e 100644 --- a/site/web/mock/server.mjs +++ b/site/web/mock/server.mjs @@ -6,6 +6,7 @@ // GET /mock/device?registered=0|1 등록 안 된 상태 흉내 // GET /mock/live?on=0|1 주기적 가짜 실시간 발화 켜기/끄기 // GET /mock/emit 가짜 실시간 발화 하나 즉시 만들기 +// GET /mock/latejoin 녹음 중에 새 사람이 들어와 말함 (v1.4.1 이하 앱처럼 users.updated 없이 발화만 보냄) // GET /auth/discord?as=notmember 길드 멤버가 아닌 계정으로 로그인 흉내 (403 not_member) import http from 'node:http'; import fs from 'node:fs'; @@ -166,6 +167,14 @@ async function handle(req, res) { return json(res, 200, { live: state.live }); } if (p === '/mock/emit') return json(res, 200, emitLive() ?? { error: 'device_offline' }); + if (p === '/mock/latejoin') { + const n = db.users.length; + const u = { id: `41000000000000${String(n).padStart(4, '0')}`, name: `늦게온사람${n}`, color: '#d4537e', avatar: null, excluded: false, riot: [] }; + db.users.push(u); + const it = db.addLiveUtterance(u, '나 지금 들어왔어'); + broadcast({ type: 'utterance.created', data: it }); + return json(res, 200, { user: u, utterance: it.id }); + } // 게임 이미지 (목: docs/report/mock/assets) if (p.startsWith('/game-assets/mock/')) { diff --git a/site/web/src/store/app.tsx b/site/web/src/store/app.tsx index 9b45008..5aeb78a 100644 --- a/site/web/src/store/app.tsx +++ b/site/web/src/store/app.tsx @@ -139,21 +139,36 @@ export function DataProvider({ children }: { children: ReactNode }) { alive = false; }; }, [epoch, locked]); + const reloadUsers = useCallback(() => { + api + .users() + .then((users) => setOverview((o) => (o ? { ...o, users } : o))) + .catch(() => {}); + }, []); + const users = overview?.users ?? []; + const map = useMemo(() => new Map(users.map((u) => [u.id, u])), [users]); + // 처음 보는 사람 아이디는 한 번만 유저 목록을 다시 받아 온다 (v1.4.1 이하 앱은 녹음 중에 들어온 사람을 알려 주지 않아 "알 수 없음"으로 뜸) + const asked = useRef(new Set()); + const checkUnknown = (ids: string[]) => { + if (!overview) return; + const fresh = ids.filter((id) => id && !map.has(id) && !asked.current.has(id)); + if (!fresh.length) return; + fresh.forEach((id) => asked.current.add(id)); + reloadUsers(); + }; useLive((e) => { if (e.type === 'users.updated') { // v1.3.5 이하 앱은 빈 목록을 보낸다: 그대로 쓰면 모든 발화가 "알 수 없음"이 되니 다시 받아 온다 if (e.data.length) setOverview((o) => (o ? { ...o, users: e.data } : o)); - else - api - .users() - .then((users) => setOverview((o) => (o ? { ...o, users } : o))) - .catch(() => {}); + else reloadUsers(); } - if (e.type === 'recording.state') setOverview((o) => (o ? { ...o, recording: e.data } : o)); + if (e.type === 'recording.state') { + setOverview((o) => (o ? { ...o, recording: e.data } : o)); + checkUnknown(e.data.participants); + } + if (e.type === 'utterance.created' || e.type === 'utterance.updated') checkUnknown([e.data.userId]); if (e.type === 'games.state') setOverview((o) => (o ? { ...o, live: e.data } : o)); }); - const users = overview?.users ?? []; - const map = useMemo(() => new Map(users.map((u) => [u.id, u])), [users]); const userById = useCallback((id: string | undefined | null) => (id ? map.get(id) : undefined), [map]); return {children}; }