feat: improve Korean neural voice quality for v0.1.1

README.md

@@ -1,4 +1,4 @@
-# 단어를 맞춰라 · Find-Word v0.1
+# 단어를 맞춰라 · Find-Word v0.1.1
 
 소음 속에 숨은 한국어 단어를 듣고 찾는 반응형 웹 게임입니다.
 
@@ -79,17 +79,35 @@ Chromium sandbox는 기본으로 켭니다. sandbox를 지원하지 않는 격
 
 브라우저 테스트는 기존 `dist/`를 사용하므로 소스 변경 후 먼저 빌드하세요.
 실제 음성 재생이 끝나기를 기다려 약 2–3분이 걸립니다. 로컬 4173 포트를
-테스트 중에만 열고 종료합니다. 스크린샷은 `.agent/evidence/`에 남습니다.
+테스트 중에만 열고 종료합니다. v0.1.1 스크린샷은 `.agent/evidence-v0.1.1/`에 남습니다.
 
 ## 음성과 문서
 
-한국어 WAV는 직접 쓴 문장을 로컬 eSpeak NG로 합성했습니다. 환경음은
-브라우저에서 고정 seed로 합성합니다. 외부 음원이나 신경망 음성 모델을 사용하지 않습니다.
+한국어 WAV 101개는 직접 쓴 문장을 Microsoft Edge online TTS의
+`ko-KR-HyunsuMultilingualNeural`로 새로 생성했습니다. edge-tts **7.3.1**,
+rate `-6%`, pitch `-4Hz`이며 FFmpeg로 **24kHz mono PCM16**으로 변환합니다.
+생성 시 네트워크가 필요하며 앱은 저장된 WAV만 재생합니다. 환경음은 브라우저에서
+고정 seed로 합성합니다. 생성 음성의 독점 권리를 주장하지 않습니다.
+
+Linux에서 Python 3.11 이상과 FFmpeg를 준비한 뒤 다음 명령을 사용합니다.
+클라이언트 버전을 고정해도 원격 모델 변경으로 동일 바이트 재생성은 보장하지 않습니다.
+
+```bash
+python3 -m venv .venv-audio
+.venv-audio/bin/python -m pip install -r requirements-audio.txt
+.venv-audio/bin/python -m pip check
+npm run audio:generate
+```
+
+고정 venv의 Python이 101개 모두 임시 생성·검증하고 디렉터리를 원자 교체합니다.
+요청별 60초 제한과 최대 3회 시도를 적용하며, 실패 시 기존 자산을 보존합니다.
+청취 샘플: [안내](public/audio/intro.wav), [행운의 사과](public/audio/luck-apple.wav).
 생성 방법, 도구 라이선스, 합성 음질의 한계는 [AUDIO_PROVENANCE.md](docs/AUDIO_PROVENANCE.md)를
 참고하세요. 실제 음량은 출력 장치에 따라 달라지며 표기 dB는 디지털 상대값입니다.
 
 - [설계와 상태 전이](docs/ARCHITECTURE.md)
 - [Neo를 위한 정적 배포 안내](docs/DEPLOYMENT.md)
-- [RED/GREEN 및 실제 검증 결과](.agent/RESULT.md)
+- [v0.1.1 RED/GREEN 및 실제 검증 결과](.agent/RESULT-v0.1.1.md)
+- [v0.1 역사 기록](.agent/RESULT.md)
 
 이번 작업에서는 서버 배포와 Git commit/push를 실행하지 않습니다.