feat: Hearo 1차 구현 — 프로그램 소리 실시간 번역 자막

프로그램별 오디오를 캡처해 로컬 GPU에서 음성인식→번역하고 화면 위
자막으로 보여주는 데스크톱 앱. 한/영/일/중 4개 언어.

구성
- audio: WASAPI 프로그램별 캡처(C++ 보조 프로그램) + 장치 루프백 폴백,
  적응형 VAD 발화 분할
- models: 속도~품질 5단계 티어, faster-whisper + CTranslate2/LLM 2백엔드,
  용어집(플레이스홀더 보호 + 프롬프트 주입)
- core: Qt 비의존 파이프라인 엔진 (캡처/분할/추론 3스레드, 큐 연결)
- ui: 사이드바 5화면 + 무테두리 항상위 자막 오버레이, 자체 다크 테마

모델 선정 근거는 docs/MODELS.md, 추가학습 가능 여부와 방법은
docs/FINETUNING.md 참고.

검증: pytest 39개 통과 (GPU·오디오 장치 없이 실행), ruff clean

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
EJClaw
2026-09-21 10:47:11 +09:00
parent c24e5f938d
commit 1a87ec6677
49 changed files with 4975 additions and 1 deletions

View File

@@ -0,0 +1,21 @@
# 프로그램별 오디오 캡처 보조 프로그램 빌드 (Windows 전용)
#
# 필요: Visual Studio 2022 Build Tools (C++ 데스크톱 워크로드) + CMake
# winget install Microsoft.VisualStudio.2022.BuildTools
# winget install Kitware.CMake
#
# 사용: powershell -ExecutionPolicy Bypass -File native\process_loopback\build.ps1
$ErrorActionPreference = "Stop"
$here = Split-Path -Parent $MyInvocation.MyCommand.Path
$build = Join-Path $here "build"
cmake -S $here -B $build -A x64
cmake --build $build --config Release
$out = Join-Path $here "..\..\src\hearo\resources\bin\hearo_capture.exe"
if (Test-Path $out) {
Write-Host "빌드 완료: $out" -ForegroundColor Green
} else {
Write-Error "빌드는 끝났지만 결과물을 찾지 못했습니다."
}