Repository navigation
feat(tone): v0.4 말투 프리셋 — 공식·커뮤니티·간결 3톤 + 렌더 시점 문장 생성 전환 - #8
Merged
Merged
Conversation
중계 문장이 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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
요약
한국어 중계 문장의 톤을 3종(공식/커뮤니티 순한맛/간결)에서 고르고 시청 중
t키로 즉시 전환할 수 있게 하며, 이를 위해 문장 생성을 어댑터 시점에서 렌더 시점으로 옮긴다 — 부수 효과로 소스 원문 프로즈가 화면·녹화·번들 어디에도 남지 않게 된다.변경사항
--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은 로마자 유지playerIn/Out, ASSIST·CORNER 주체, ADDED_TIMEinjury. YELLOW의 "주심이 X" 오추출도 해소이유
중계 문장이 FIFA 원문 그대로라 톤 선택지가 없었고, ESPN 폴백 시 문체가 소스에 따라 달라졌다. 또한 원문이 이벤트에 실려 녹화 JSONL에 축적되고 있었다 — 렌더 시점 생성으로 전환하면 톤 기능과 "원문 프로즈 0건" 원칙의 로컬 파일 확장이 한 번에 해결된다. 사용자 확정: 커뮤니티 톤은 순한맛 고정, 선수 비하·법적 리스크 표현은 어떤 톤에서도 금지(렉시콘 게이트로 강제).
기술 메모
hangul-names.json에 항목 추가만 하면 됨rm -rf dist && npm run build(163KB) +tsc --noEmit+vitest run21파일 146개 green (2026-07-08)Review Focus
src/core/tone.ts의 COMMUNITY 템플릿 — 순한맛 기준에 맞는지, 어색한 문장이 없는지 (템플릿만 고치면 되는 구조라 출시 후 패치도 저비용)hangul-names.json시드(~70명)가 준결승·결승에서 충분한지 — 부족 시 추가 대상 선수🤖 Generated with Claude Code