Canonical repository: OZ-Group/Find-Word. 프로젝트 자체는 private / all-rights-reserved이며 package.json의 license는 UNLICENSED입니다. LICENSE를 참고하세요. 런타임 의존성 React, ReactDOM, scheduler의 MIT 전문은 THIRD_PARTY_NOTICES.md에 보존하며, public/THIRD_PARTY_NOTICES.md가 빌드 시 dist/THIRD_PARTY_NOTICES.md로 복사됩니다. 빌드 검증기는 설치된 의존성의 라이선스 전문·버전과 세 사본을 대조합니다.

React + TypeScript strict + Vite로 만든 정적 SPA입니다. 로그인, 개인정보 저장, 분석 도구, 외부 CDN, 런타임 TTS/API 요청이 없습니다. 청각적 주의·식별 게임이며 의료적 진단·치료나 효과를 주장하지 않습니다.

실행

Node.js 최소 버전은 22.22.2 (>=22.22.2)입니다. 잠긴 jsdom 계열 의존성이 요구하는 지원 범위는 22.x의 22.22.2 이상, 24.x의 24.15.0 이상 또는 26.0.0 이상입니다. 이 중 지원되는 LTS 버전을 사용하세요. package-lock.json을 포함하므로 새 환경에서는 npm ci를 사용합니다. 이번 검증 환경은 Node 26.7.0입니다.

npm ci
npm run dev

표시되는 http://127.0.0.1:5173에서 사용합니다. 소리는 사용자가 게임 시작 · 소리 듣기를 누른 뒤에만 재생합니다. 낮은 음량부터 조절하고 헤드폰이나 스피커를 사용할 수 있습니다.

플레이

골고루 풀기, 보기에서 선택, 직접 입력 중 선택합니다.
8개 환경을 순환하거나 하나를 지정합니다.
에스의 안내가 배경에 묻힌 뒤 목표 문장이 나옵니다. 재생 후 질문에 답합니다.
10문제 동안 2문제마다 난이도가 올라갑니다: SNR +6, +3, 0, −3, −6 dB. 양수는 음성이 배경보다 크고, 0은 같고, 음수는 더 작다는 뜻입니다.
다시 듣기는 감점하지 않습니다. 정답은 단계 × 100점, 연속 정답은 최대 40점의 보너스를 받습니다.
결과에서 점수·정답률·최고 연속 정답·단계별 결과를 확인하고 다시 시작할 수 있습니다.
새로고침하면 기록이 사라집니다. 결과를 브라우저나 서버에 저장하지 않습니다.

10개 유형 × 10개 단어의 100개 목표 문장을 저장했습니다. 각 세션은 유형과 단어를 섞어 출제하며 정답 위치도 섞습니다. 사전 표제어와 변형 규칙은 WORDS.md에 설명했습니다. 청취 과제는 직접 목표 식별, 연습 암호와 진짜 암호 구별, 앞 단어를 잊고 다음 단어 기억, 첫째·마지막·가운데 선택, 반복 찾기, 정정 반영, 신호 조건 적용, 오른쪽 표지 선택의 10가지입니다. 문장에 실제 보기의 오답도 포함됩니다.

검증과 정적 빌드

npm run lint
npm test
npm run build
npm run preview

lint는 ESLint와 TypeScript 검사, test는 unit/component/자산/빌드 검증기 테스트를 실행합니다. build는 dist/를 만들고 음성 101개가 원본 해시 그대로 포함되었는지 확인합니다. 빌드에는 음성 합성 도구가 필요하지 않습니다. 런타임 MIT notice가 dist/에 전문 그대로 포함되는지도 검증합니다.

실제 오디오·360px/1280px 화면·키보드·접근성·오류 재시도 검증:

# Chromium이 없는 개발 환경에서 한 번만 실행합니다.
npx playwright install chromium
npm run test:browser
# 이미 설치된 Chrome을 사용할 때의 대안입니다.
CHROME_PATH=/usr/bin/google-chrome npm run test:browser

Chromium sandbox는 기본으로 켭니다. sandbox를 지원하지 않는 격리된 개발 환경에서만 PLAYWRIGHT_NO_SANDBOX=1을 명시해 끌 수 있습니다. 0, false, 빈 값이나 미설정은 sandbox를 유지합니다. CHROME_PATH 지정은 sandbox를 끄지 않습니다.

브라우저 테스트는 기존 dist/를 사용하므로 소스 변경 후 먼저 빌드하세요. 실제 음성 재생이 끝나기를 기다려 약 2–3분이 걸립니다. 로컬 4173 포트를 테스트 중에만 열고 종료합니다. 스크린샷은 .agent/evidence/에 남습니다.

음성과 문서

한국어 WAV는 직접 쓴 문장을 로컬 eSpeak NG로 합성했습니다. 환경음은 브라우저에서 고정 seed로 합성합니다. 외부 음원이나 신경망 음성 모델을 사용하지 않습니다. 생성 방법, 도구 라이선스, 합성 음질의 한계는 AUDIO_PROVENANCE.md를 참고하세요. 실제 음량은 출력 장치에 따라 달라지며 표기 dB는 디지털 상대값입니다.

이번 작업에서는 서버 배포와 Git commit/push를 실행하지 않습니다.

README.md Unescape Escape

단어를 맞춰라 · Find-Word v0.1

실행

플레이

검증과 정적 빌드

음성과 문서

README.md