FluidVoice 딥다이브
— 말하면 바로 텍스트, 100% 오프라인 macOS 받아쓰기

┌──────────────────────────────────────────────────────────────┐ │ FluidVoice (macOS 앱) │ │ │ │ ┌──────────────┐ ┌───────────────────────────────────┐ │ │ │ MenuBarMgr │ │ GlobalHotkeyManager │ │ │ │ (NSStatusItem) │ Carbon.HIToolbox 전역 감지 │ │ │ └──────┬───────┘ └────────────┬──────────────────────┘ │ │ │ │ 단축키 이벤트 │ │ └──────────────────────────▼ │ │ ┌─────────────────┐ │ │ │ ASRService │ ◀── @MainActor │ │ │ (녹음·추론 총괄) │ │ │ └────────┬────────┘ │ │ ┌─────────────────────┼──────────────────────┐ │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌──────────────────┐ ┌─────────────────────┐ ┌──────────┐│ │ │ AVAudioEngine │ │ TranscriptionProvider│ │WhisperPro││ │ │ (마이크 탭·PCM) │ │ (프로토콜 인터페이스)│ │ vider ││ │ └────────┬─────────┘ └──────────┬──────────┘ └────┬─────┘│ │ │ Float32 샘플 │ │ │ │ │ ┌──────────▼────────────┐ │ │ │ └────────────▶│ FluidAudioProvider │ │ │ │ │ (Parakeet/Nemotron) │ │ │ │ │ CoreML + ANE 추론 │ │ │ │ └──────────┬─────────────┘ │ │ │ │ transcribed text │ │ │ ▼ ▼ │ │ ┌───────────────────────────────┐ │ │ │ DictationPostProc │ │ │ │ (LLMClient AI 후처리 / 옵션) │ │ │ └──────────────┬────────────────┘ │ │ │ │ │ ▼ │ │ ┌──────────────────────────────────┐ │ │ │ TypingService │ │ │ │ AXUIElement 삽입 (1순위) │ │ │ │ 클립보드 붙여넣기 폴백 (2순위) │ │ │ │ CGEvent 키 이벤트 폴백 (3순위) │ │ │ └──────────────────────────────────┘ │ │ │ │ │ ┌──────────────▼──────────────────┐ │ │ │ 활성 앱 텍스트 필드 │ │ │ │ (Slack, Notion, Terminal…) │ │ │ └─────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────┘

// ASRService.swift — 핵심 흐름 (단순화)
func start() async {
    engine.prepare()            // AVAudioEngine 준비
    engine.inputNode.installTap(...) { buffer, _ in
        self.audioBuffer.append(buffer)   // PCM 샘플 누적
    }
    try engine.start()
}

func stop() async -> String {
    engine.stop()
    let samples = audioBuffer.allSamples()
    let result = try await provider.transcribeFinal(samples)
    return result.text
}

FluidVoice/ ├── Package.swift SPM 의존성 선언 (FluidAudio·SwiftWhisper 등) ├── Fluid.xcodeproj/ Xcode 프로젝트 파일 ├── Fluid.entitlements 앱 권한 선언 (Apple Events·앱 자동화) ├── Info.plist 앱 메타데이터 └── Sources/Fluid/ ├── fluidApp.swift @main 진입점, AppDelegate 연결 ├── AppDelegate.swift 앱 생명주기, 메뉴바 설정, 로컬 API 서버 시작 ├── ContentView.swift 최상위 SwiftUI 뷰 │ ├── Services/ ★ 핵심 비즈니스 로직 │ ├── ASRService.swift 받아쓰기 총괄 (녹음·모델·상태) │ ├── FluidAudioProvider.swift Parakeet/Nemotron CoreML 추론 │ ├── WhisperProvider.swift whisper.cpp(SwiftWhisper) 추론 │ ├── NemotronProvider.swift Nemotron 3.5 CoreML 스트리밍 │ ├── AppleSpeechProvider.swift 내장 Apple Speech │ ├── TranscriptionProvider.swift 공통 프로토콜 정의 │ ├── GlobalHotkeyManager.swift 전역 단축키 (Carbon API) │ ├── TypingService.swift 텍스트 삽입 (AX API + 폴백) │ ├── CommandModeService.swift 음성 Mac 제어 에이전트 루프 │ ├── RewriteModeService.swift 선택 텍스트 AI 재작성 │ ├── MenuBarManager.swift 메뉴바 아이콘·메뉴 관리 │ ├── AudioDeviceService.swift CoreAudio 장치 열거·모니터링 │ ├── ModelRepository.swift 모델 다운로드·캐시 관리 │ ├── DictationPostProcessingService.swift AI 후처리 파이프라인 │ └── LocalAPI/ localhost HTTP API 서버 │ ├── LocalAPIServer.swift │ └── LocalAPIRouter.swift │ ├── Persistence/ 설정·히스토리 영속화 │ ├── SettingsStore.swift 앱 전역 설정 (UserDefaults + Keychain) │ ├── TranscriptionHistoryStore.swift 받아쓰기 기록 │ └── DictationAudioHistoryStore.swift 오디오 로컬 저장 │ ├── UI/ 화면별 SwiftUI 뷰 + 뷰모델 │ ├── AISettingsView.swift 음성 엔진·AI 설정 화면 │ ├── RecordingView.swift 녹음 중 오버레이 │ └── TranscriptionHistoryView.swift 기록 조회 화면 │ ├── Views/ 오버레이 팝업 뷰 (Notch·Command·Rewrite) ├── Theme/ AppTheme, 커스텀 버튼 스타일 └── Analytics/ PostHog 익명 이벤트 (opt-in)

// AVAudioEngine 탭 패턴 (개념 코드)
engine.inputNode.installTap(
    onBus: 0,
    bufferSize: 1024,
    format: inputFormat
) { buffer, time in
    self.audioBuffer.append(buffer)  // 실시간 PCM 누적
}