---
name: debug-electron
description: Electron 앱 디버깅. IPC 문제, 메모리 누수, 렌더러 크래시 등 진단.
allowed-tools: Read Grep Glob Bash
---

# Electron Debug

## 일반 디버깅
1. 로그 확인 (`electron-log` 출력)
2. IPC 채널 매칭 검증 (`shared/ipc-channels.ts` vs 실제 핸들러)
3. 프리로드 스크립트 노출 API 확인

## IPC 문제
- `shared/ipc-channels.ts`에 채널 정의 확인
- `src/main/ipc/`에 핸들러 등록 확인
- `src/preload/index.ts`에 브릿지 노출 확인
- 렌더러에서 `window.electronAPI.*` 호출 확인

## 오디오 문제
- Web Audio API 초기화 상태
- 마이크 권한 확인
- AudioContext sampleRate (24000Hz)
- noiseSuppression: false 확인

## 메모리 누수
- useEffect cleanup 함수 확인
- IPC 이벤트 리스너 제거 확인
- BrowserWindow destroy 확인