Skip to content

feat(tone): v0.4 말투 프리셋 — 공식·커뮤니티·간결 3톤 + 렌더 시점 문장 생성 전환 - #8

Merged
juunghyun merged 1 commit into
mainfrom
feature/v0.4-tone-presets
Jul 8, 2026
Merged

juunghyun merged 1 commit into
mainfrom
feature/v0.4-tone-presets

Conversation

@juunghyun

Copy link
Copy Markdown
Owner

요약

한국어 중계 문장의 톤을 3종(공식/커뮤니티 순한맛/간결)에서 고르고 시청 중 t 키로 즉시 전환할 수 있게 하며, 이를 위해 문장 생성을 어댑터 시점에서 렌더 시점으로 옮긴다 — 부수 효과로 소스 원문 프로즈가 화면·녹화·번들 어디에도 남지 않게 된다.

변경사항

  • 톤 3종 + 전환 UX: --tone official|community|brief(config 영구 저장, 비정상 값 official 강등) + 시청 중 t 키 순환 — 이미 출력된 로그 전체가 새 톤으로 즉시 재렌더. 기본 톤 official(기존 경험 유지), en 세션은 기존 단일 레지스터 유지(t 비활성)
  • 렌더 시점 문장 생성: 신규 core/tone.ts — 3톤 × 22 이벤트타입 템플릿 테이블(정적 export) + 순수 함수 toneSentence. 받침 조사 자동 처리("잉글랜드가/독일이"), 변형 풀은 event id의 FNV-1a 해시로 결정적 선택(리플레이·재렌더 동일 문장)
  • 한글 음차 엔진: 신규 core/hangul.ts — 외래어 표기법 준용 규칙 엔진(어중 l→ㄹㄹ, 받침/클러스터 규칙) + 주요 선수 예외 테이블(hangul-names.json, 8강 진출팀 시드). community/brief에서 "메리노"·"실바" 식 표기, official은 로마자 유지
  • 콘텐츠 정책 자동 게이트: 금지어 렉시콘 3층 테스트 — ① 전 템플릿 정적 스캔 ② 3톤×전타입×컨텍스트 ~7천 문장 렌더 매트릭스(음차 통과 후 최종 문장) ③ 민감 이벤트(자책골·PK실축·퇴장)의 community 문장을 중립 서브셋으로 구조 강제. 렉시콘은 test 전용(배포 번들 미포함)
  • 구조 사실 승격: 어댑터가 text 필드를 더 이상 출력하지 않고(원문은 파싱 소스로만), text에만 있던 사실을 구조로 — playerIn/Out, ASSIST·CORNER 주체, ADDED_TIME injury. YELLOW의 "주심이 X" 오추출도 해소
  • 구 녹화 하위호환: v0.2/0.3 녹화는 로드 시점에 저장 text에서 사실만 추출 보강(원문 화면 직행 폴백 없음) — 실녹화 파일(POR-ESP)로 3톤 재생 검증. 스키마는 전부 additive(리플레이 v1·config 무버전 유지)
  • demo 재생성(text 0건), README 현행화(--tone, 톤 소개, 데이터 고지 강화)

이유

중계 문장이 FIFA 원문 그대로라 톤 선택지가 없었고, ESPN 폴백 시 문체가 소스에 따라 달라졌다. 또한 원문이 이벤트에 실려 녹화 JSONL에 축적되고 있었다 — 렌더 시점 생성으로 전환하면 톤 기능과 "원문 프로즈 0건" 원칙의 로컬 파일 확장이 한 번에 해결된다. 사용자 확정: 커뮤니티 톤은 순한맛 고정, 선수 비하·법적 리스크 표현은 어떤 톤에서도 금지(렉시콘 게이트로 강제).

기술 메모

  • 음차는 정확성이 아닌 "결정성+무해성"이 게이트: 로마자 철자에 발음 정보가 없어 오변환은 구조적으로 불가피(요구사항 수용) — 완화는 예외 테이블 + official 로마자 유지. 스타 선수 오변환 발견 시 hangul-names.json에 항목 추가만 하면 됨
  • 호환성 주의 1건: v0.3 이하 바이너리로 v0.4 녹화를 재생하면 문장이 비어 보임(신규 녹화에 text 미기록, 로컬 한정·정방향 호환은 완전) — 릴리즈 노트 명기 필요
  • ESPN 골 스코어: scoreAfter가 없어 수신 시점 state를 LogLine에 캡처 — 폴백 상황 한정 ±1골 표기 오차 가능(수용)
  • CI-세이프 게이트 통과: rm -rf dist && npm run build(163KB) + tsc --noEmit + vitest run 21파일 146개 green (2026-07-08)
  • 검증: demo(community/brief 톤) 완주 + v0.3 실녹화 재생 + config 저장 실기기 확인(테스트 값 원복 완료) + dist에 소스 프로즈·금지어 grep 0건

Review Focus

  • 커뮤니티 톤 문장의 수위·자연스러움: src/core/tone.ts의 COMMUNITY 템플릿 — 순한맛 기준에 맞는지, 어색한 문장이 없는지 (템플릿만 고치면 되는 구조라 출시 후 패치도 저비용)
  • 음차 예외 테이블 커버리지: hangul-names.json 시드(~70명)가 준결승·결승에서 충분한지 — 부족 시 추가 대상 선수
  • 신규 녹화의 text 미기록 결정: 다운그레이드 재생 호환을 포기하는 대신 원문 축적을 차단 — 이 트레이드오프가 적절한지

🤖 Generated with Claude Code

중계 문장이 FIFA 원문 그대로라 톤 선택지가 없고 ESPN 폴백 시 문체가 소스에 따라 달라지던 것을, 문장 생성을 어댑터 시점에서 렌더 시점으로 옮겨 해소한다. 사용자는 --tone 플래그·config·시청 중 t키로 공식(방송 문어체, 로마자)/커뮤니티 순한맛(구어체, 한글 음차)/간결(위젯 미니멀) 중 고를 수 있고, 토글 시 이미 출력된 로그 전체가 새 톤으로 즉시 재렌더된다. 부수 효과로 이벤트에서 text 필드가 사라져 녹화 JSONL에 소스 원문이 더 이상 축적되지 않는다 — "원문 프로즈 0건" 원칙이 사용자 로컬 파일까지 확장.

* src/core/tone.ts (신규): 3톤 × 22 이벤트타입 템플릿 테이블(정적 export) + toneSentence 순수 함수, 받침 조사 처리, FNV-1a(event id) 해시 변형 선택 -> 렌더·리플레이·재렌더 전부 결정적, 렉시콘 테스트가 전 템플릿을 정적 스캔 가능
* src/core/hangul.ts + src/data/hangul-names.json (신규): 외래어 표기법 준용 로마자→한글 음차 규칙 엔진(어중 l→ㄹㄹ, 받침·클러스터 규칙) + 주요 선수 예외 테이블 -> community/brief 톤 선수명 전수 한글 표기, 정확성 아닌 결정성+무해성을 게이트로
* src/core/factextract.ts (신규) + fifa.ts·espn.ts: 어댑터 text 출력 제거, 원문은 함수 로컬 파싱 소스로만 사용 — 교체 in/out·어시스트·코너 주체를 구조 필드로 승격, YELLOW "주심이 X" 오추출 해소 -> 톤 재생성에 필요한 사실이 이벤트 구조에 완비
* src/core/model.ts: playerIn/playerOut(additive)·ALL_EVENT_TYPES(satisfies 정합 강제) -> 리플레이 포맷 v1 유지, 렉시콘 매트릭스가 타입 전수 순회
* src/ui/matchScreen.ts: t키 순환(en 무시)·LogLine 스코어 캡처(ESPN 골 scoreAfter 부재 보강)·골취소 라인 구조화·ASSIST text 분기 제거, 종료 시 최종 톤 반환 -> 전체 로그 톤 재렌더가 1Hz 리페인트 비용 그대로
* src/cli/index.ts + store.ts: --tone 파싱(화이트리스트)·config 저장·비정상 값 official 강등·t 토글 결과 종료 시 1회 저장 -> --lang과 동일 UX 패턴
* src/replay/player.ts: 구 녹화(v0.2/0.3) 로드 시 저장 text에서 사실만 추출 보강(교체·어시스트·추가시간·주심 접두 정리), 원문 화면 직행 폴백 없음 -> 구 녹화도 3톤 재생, 실파일(400021529-POR-ESP)로 검증
* src/core/digest.ts·i18n.ts·text.ts: ADDED_TIME에 injury 구조 기록, en 전용 enEventSentence(교체·추가시간 사실 반영), 사용처 소멸한 normalizeEventText 삭제 -> ko 문장은 tone.ts 단일 소유
* scripts/make-demo.mjs + demo-match.json 재생성: 추출 사실을 구조 필드로 기록, text 미기록 -> 번들 demo가 3톤 렌더 소재로 완비
* test: tone·hangul·factextract·lexicon(3층: 템플릿 정적 스캔/3톤×전타입×컨텍스트 ~7천 문장/민감 타입 중립 구조 강제)·replay 보강 신규 5파일 + 어댑터 테스트 계약 뒤집기(text 부재 검증) -> 콘텐츠 정책(비하·조롱·욕설 금지)이 자동 게이트로 강제

호환성: 스키마 전부 additive(리플레이 v1·config 무버전). 단 v0.3 이하 바이너리로 v0.4 녹화 재생 시 문장이 비어 보임(신규 녹화 text 미기록, 로컬 한정) — 릴리즈 노트 명기 대상.

테스트: npx vitest run 21파일 146개 전부 통과 · npx tsc --noEmit 통과 · npm run build 163KB · dist에 소스 프로즈·금지어 렉시콘 grep 0건 · demo(community/brief)와 v0.3 실녹화 재생 육안 확인 · config 저장 실기기 확인 후 원복

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@juunghyun
juunghyun merged commit 93bc97d into main Jul 8, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant